如何为Azure App Configuration Provider创建的ConfigMap添加注解？

AI 小北

2026-6-25

为Azure App Configuration Provider生成的ConfigMap添加注解的实现方式

有两种可靠的方式给Azure App Configuration Provider创建的ConfigMap添加注解，具体如下：

1. 通过Helm部署时配置注解

如果是用Helm安装Azure App Configuration Provider，可以直接在部署参数或values.yaml中指定ConfigMap的注解：

命令行直接指定

使用--set参数传递注解，注意含特殊字符的key需要转义：

helm install appconfig-provider oci://mcr.microsoft.com/azure-app-configuration/helmchart/appconfigurationprovider \
  --namespace appconfig-system \
  --set configMap.annotations."example\.com/owner"="dev-team" \
  --set configMap.annotations."kubernetes.io/description"="Synced from Azure App Configuration"

通过values.yaml配置

创建或修改values.yaml文件，添加注解配置：

configMap:
  annotations:
    example.com/owner: "dev-team"
    kubernetes.io/description: "Synced from Azure App Configuration"
    env: "production"

然后执行部署命令：

helm install appconfig-provider oci://mcr.microsoft.com/azure-app-configuration/helmchart/appconfigurationprovider \
  -f values.yaml \
  --namespace appconfig-system

2. 通过Configuration自定义资源定义注解

当你使用Provider的Configuration CRD来同步配置到ConfigMap时，可以在spec的target字段里直接定义注解：

apiVersion: appconfiguration.azure.com/v1beta1
kind: Configuration
metadata:
  name: my-appconfig-sync
  namespace: default
spec:
  endpoint: "https://your-appconfig-resource.azconfig.io"
  target:
    configMap:
      name: appconfig-synced-cm
      annotations:
        example.com/sync-frequency: "5m"
        team: "devops"
  selector:
    keyFilter: "*"
    labelFilter: "prod"

应用这个YAML后，Provider生成的appconfig-synced-cm ConfigMap会自动带上指定的注解。