Golang如何使用Kubernetes ConfigMap管理配置

在Kubernetes环境中部署Golang应用时，将配置信息从代码中剥离是提升应用可维护性的重要手段，ConfigMap作为Kubernetes原生的配置管理资源，能够很好地满足这一需求，支持多种配置注入方式，适配不同的应用场景。

ConfigMap的两种常用注入方式

ConfigMap的配置可以通过两种方式注入到Pod中的Golang应用，分别是环境变量注入和文件挂载，两种方式的使用场景和读取逻辑有所不同。

环境变量注入方式

这种方式适合存储简单的键值对配置，比如服务端口、数据库地址等短配置项，在Pod启动时直接注入为环境变量，Golang应用可以直接通过读取环境变量获取配置。

首先创建ConfigMap资源，定义需要的配置项，示例如下：

apiVersion: v1
kind: ConfigMap
metadata:
  name: golang-app-config
  namespace: default
data:
  server_port: "8080"
  db_host: "127.0.0.1"
  db_port: "3306"

然后在Deployment中引用这个ConfigMap，将配置注入为环境变量：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: golang-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: golang-app
  template:
    metadata:
      labels:
        app: golang-app
    spec:
      containers:
      - name: golang-app
        image: golang-app:latest
        env:
        - name: SERVER_PORT
          valueFrom:
            configMapKeyRef:
              name: golang-app-config
              key: server_port
        - name: DB_HOST
          valueFrom:
            configMapKeyRef:
              name: golang-app-config
              key: db_host
        - name: DB_PORT
          valueFrom:
            configMapKeyRef:
              name: golang-app-config
              key: db_port

Golang代码中通过os.Getenv读取环境变量即可获取配置：

package main

import (
	"fmt"
	"net/http"
	"os"
)

func main() {
	// 读取环境变量中的配置
	serverPort := os.Getenv("SERVER_PORT")
	dbHost := os.Getenv("DB_HOST")
	dbPort := os.Getenv("DB_PORT")

	// 打印配置信息
	fmt.Printf("服务端口: %s\n", serverPort)
	fmt.Printf("数据库地址: %s:%s\n", dbHost, dbPort)

	// 启动HTTP服务
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintf(w, "服务运行在端口 %s", serverPort)
	})
	http.ListenAndServe(":"+serverPort, nil)
}

文件挂载方式

这种方式适合存储复杂的配置内容，比如JSON、YAML格式的配置文件，ConfigMap会将配置内容挂载为Pod中的文件，Golang应用读取对应路径的文件即可获取配置。

首先创建存储复杂配置的ConfigMap，这里以YAML格式的应用配置为例：

apiVersion: v1
kind: ConfigMap
metadata:
  name: golang-app-file-config
  namespace: default
data:
  app.yaml: |
    server:
      port: 8080
      timeout: 30
    database:
      host: 127.0.0.1
      port: 3306
      username: root
      password: test123

在Deployment中将该ConfigMap挂载到容器的指定目录：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: golang-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: golang-app
  template:
    metadata:
      labels:
        app: golang-app
    spec:
      containers:
      - name: golang-app
        image: golang-app:latest
        volumeMounts:
        - name: config-volume
          mountPath: /etc/app/config
      volumes:
      - name: config-volume
        configMap:
          name: golang-app-file-config

Golang代码中读取挂载路径下的文件，解析配置内容即可，这里使用YAML解析库处理配置：

package main

import (
	"fmt"
	"os"

	"gopkg.in/yaml.v3"
)

// 定义配置结构体
type Config struct {
	Server struct {
		Port    int `yaml:"port"`
		Timeout int `yaml:"timeout"`
	} `yaml:"server"`
	Database struct {
		Host     string `yaml:"host"`
		Port     int    `yaml:"port"`
		Username string `yaml:"username"`
		Password string `yaml:"password"`
	} `yaml:"database"`
}

func main() {
	// 读取挂载的配置文件
	configPath := "/etc/app/config/app.yaml"
	data, err := os.ReadFile(configPath)
	if err != nil {
		fmt.Printf("读取配置文件失败: %v\n", err)
		return
	}

	// 解析YAML配置
	var config Config
	err = yaml.Unmarshal(data, &config)
	if err != nil {
		fmt.Printf("解析配置文件失败: %v\n", err)
		return
	}

	// 打印配置信息
	fmt.Printf("服务端口: %d\n", config.Server.Port)
	fmt.Printf("服务超时时间: %d秒\n", config.Server.Timeout)
	fmt.Printf("数据库连接地址: %s:%d\n", config.Database.Host, config.Database.Port)
}

两种方式的对比选择

可以根据配置的特点选择合适的注入方式，以下是两种方式的对比：

注意事项

• ConfigMap不适合存储敏感信息，敏感信息建议使用Secret资源。
• 环境变量注入的配置如果更新，必须重启Pod才能生效，设计应用时需要考虑这一点。
• 文件挂载方式下，如果应用需要热加载配置，可以在代码中监听文件变化，实现配置动态更新。
• 创建ConfigMap时注意命名规范，避免和其他资源冲突，同时确认namespace和Pod的namespace一致。

GolangKubernetesConfigMap配置管理修改时间：2026-06-04 03:18:09