ConfigMap：动态更新应用程序配置

点击上方蓝字⭐️关注“DevOps云学堂”，接收最新技术实践

今天是「DevOps云学堂」与你共同进步的第 33 天

第⑦期DevOps实战训练营·招新中

---

ConfigMap是一个Kubernetes资源，允许您将配置数据与应用程序代码分开存储。它提供了一种将配置设置与应用程序本身分离的方法，从而可以更轻松地管理和更新配置，而无需修改应用程序的代码或容器镜像。

ConfigMap通常用于存储键值对或配置文件。它可以通过使用YAML文件的声明性方法或通过 Kubernetes API 创建。创建后，ConfigMap 可以作为卷挂载，也可以作为容器化应用程序中的环境变量公开。

何时使用ConfigMap？

当您在 Kubernetes 集群中运行同一应用程序的多个实例但具有不同的配置要求时，ConfigMap特别有用。通过使用ConfigMaps，您可以集中配置数据并动态更新它，而无需重新部署应用程序。

使用ConfigMaps，您可以轻松修改应用程序的配置设置，例如数据库连接字符串、API 端点、功能切换或任何其他配置参数，而无需重新生成或重新部署应用程序。这种灵活性简化了在动态且可扩展的环境中（如 Kubernetes）中应用程序配置的管理。

在Kubernetes中使用动态值配置Nginx应用程序

要在 Kubernetes 环境中使用 ConfigMap管理Nginx配置，您可以按照以下步骤操作：

Step1：创建ConfigMap

创建一个ConfigMap来存储你的Nginx配置。您可以通过创建一个YAML文件来做到这一点，我们称之为 nginx-config.yaml，其中包含以下内容：

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx-config
data:
  nginx.conf: |
    server {
      listen 80;
      server_name example.com;
      root /usr/share/nginx/html;
      index index.html;

      # Add your dynamic configuration here using the $variable_name syntax
      # Example: access_log /var/log/nginx/access.log $log_format;
    }

在这个例子中，我们正在创建一个名为nginx-config的ConfigMap，并在nginx.conf中定义Nginx配置。

Step2：部署Nginx挂载ConfigMap

创建一个YAML部署文件，我们称之为 nginx-deployment.yaml，以部署 Nginx 并将 ConfigMap 挂载为卷。文件内容：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:latest
          ports:
            - containerPort: 80
          volumeMounts:
            - name: nginx-config
              mountPath: /etc/nginx/conf.d/default.conf
              subPath: nginx.conf
      volumes:
        - name: nginx-config
          configMap:
            name: nginx-config

在此示例中，我们将创建一个名为 nginx-deployment 的部署，其中包含一个副本。Nginx 容器配置为将 ConfigMap 作为卷挂载在路径 /etc/nginx/conf.d/default.conf 处。

Step3：应用ConfigMap和Deployment

使用 kubectl apply 命令应用 ConfigMap 和 Deployment：

kubectl apply -f nginx-config.yaml
kubectl apply -f nginx-deployment.yaml

这将创建ConfigMap并使用指定的配置部署Nginx。

使用动态参数值

通过执行以下步骤，您可以在 ConfigMap 中使用 Nginx 配置动态值。这使您可以轻松管理和更新Nginx配置，而无需修改部署本身。
要使 Nginx 配置中的 server_name 参数动态化并将其设置为 Pod 的站点主机名，您可以使用 Pod 的 metadata.name 字段作为 Nginx 部署中的环境变量。以下是实现此目的的方法：

Step1：修改配置映射

更新现有的 ConfigMap YAML （nginx-config.yaml）以包含 server_name 参数。修改 nginx.conf 部分，如下所示：

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx-config
data:
  nginx.conf: |
    server {
      listen 80;
      server_name ${SERVER_NAME};
      root /usr/share/nginx/html;
      index index.html;

      # Add your dynamic configuration here using the $variable_name syntax
      # Example: access_log /var/log/nginx/access.log $log_format;
    }

在此示例中，我们添加了 ${SERVER_NAME} 作为动态值 server_name 的占位符。

Step2：更新部署

在Nginx部署YAML（nginx-deployment.yaml）中，修改容器spec以包含引用容器主机名的环境变量。按如下方式更新文件：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:latest
          ports:
            - containerPort: 80
          env:
            - name: SERVER_NAME
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name
          volumeMounts:
            - name: nginx-config
              mountPath: /etc/nginx/conf.d/default.conf
              subPath: nginx.conf
      volumes:
        - name: nginx-config
          configMap:
            name: nginx-config

在此示例中，我们添加了一个名为 SERVER_NAME 的环境变量，并使用 fieldRef 语法从 pod 的 metadata.name 字段中设置其值。

Step3：应用更改

使用 kubectl apply 命令应用更新ConfigMap和Deployment：

kubectl apply -f nginx-config.yaml
kubectl apply -f nginx-deployment.yaml

这将应用更改并使用server_name参数的动态值更新Nginx部署。
现在，每个pod的主机名将自动设置为Nginx配置中server_name的值，使其动态且特定于每个 pod。
请注意，metadata.name 字段是指容器的分配名称，默认情况下该名称是唯一的。

---

往期推荐

Helm指南：Kubernetes包管理器简介

如何实施有效的CI/CD流水线

静水流深 不浮不躁 | 第⑦期DevOps训练营·招新

GitOps –用于基础设施自动化的DevOps

如果这篇文章对您有帮助，欢迎转发点赞分享。您的关注是我持续分享的动力！