如何通过Azure DevOps发布管道YAML配置ACI环境变量

问题背景 #

我正在为.NET 8应用搭建Azure DevOps发布管道，目标是通过YAML和环境专属变量组，给Azure Container Instance（ACI）配置自定义环境变量，实现DEV/QA/PROD各环境用容器运行时环境变量覆盖appsettings.json中的嵌套配置（比如ConnectionString.DefaultConnection）。但遇到两个关键问题：

1. 点符号命名的变量（如ConnectionString.DefaultConnection）在YAML中引用时无法被识别——发布日志显示变量值正常，但YAML解析时读不到对应值。
2. 不确定是否需要在deployment.yaml中按环境单独添加变量组。

核心原因 #

1. 点符号变量的解析冲突：Azure DevOps管道会把带点的变量名（如ConnectionString.DefaultConnection）解析为嵌套对象的路径，而非完整变量名。直接用$(ConnectionString.DefaultConnection)会被当成访问ConnectionString对象下的DefaultConnection属性，而非引用名为ConnectionString.DefaultConnection的变量。
2. 变量组的作用范围：变量组是在Azure DevOps发布管道级别关联的，不需要在deployment.yaml中直接声明，而是通过管道YAML的阶段/参数逻辑动态关联对应环境的变量组。

解决方案 #

1. 解决点符号变量引用问题 #

有两种可靠的处理方式：

方式一：变量名替换（推荐）

在Azure DevOps变量组中，将点符号替换为下划线，比如把ConnectionString.DefaultConnection重命名为ConnectionString_DefaultConnection。然后在deployment.yaml中引用修改后的变量名，同时保持ACI的环境变量名符合.NET配置规则（双下划线对应嵌套结构）：

environmentVariables:
  - name: ConnectionStrings__DefaultDbConnection
    value: $(ConnectionString_DefaultConnection)

方式二：引号强制解析

如果要保留点符号的变量名，在YAML中引用时用双引号包裹，强制Azure DevOps将其作为完整变量名解析：

environmentVariables:
  - name: ConnectionStrings__DefaultDbConnection
    value: "$(ConnectionString.DefaultConnection)"

注意：这种方式在复杂模板场景下可能存在解析风险，优先推荐方式一。

2. 变量组的正确关联方式 #

不需要在deployment.yaml中添加变量组，而是在Azure DevOps发布管道的YAML中，根据环境参数动态加载对应变量组。正确的管道YAML配置如下：

parameters:
- name: environment
  type: string
  values:
  - dev
  - qa
  - prod

variables:
- ${{ if eq(parameters.environment, 'dev') }}:
  - group: dev-variables
- ${{ if eq(parameters.environment, 'qa') }}:
  - group: qa-variables
- ${{ if eq(parameters.environment, 'prod') }}:
  - group: prod-variables

steps:
# 这里添加你的发布步骤，比如部署ACI的任务
- task: AzureResourceManagerTemplateDeployment@3
  inputs:
    deploymentScope: 'Resource Group'
    azureResourceManagerConnection: '你的Azure连接'
    subscriptionId: '你的订阅ID'
    action: 'Create Or Update Resource Group'
    resourceGroupName: 'rg-${{ parameters.environment }}-aci'
    location: 'northcentralus'
    templateLocation: 'Linked artifact'
    csmFile: '$(System.DefaultWorkingDirectory)/deployment.yaml'
    overrideParameters: '-environment ${{ parameters.environment }}'

完整修正后的deployment.yaml示例 #

apiVersion: '2021-10-01'
location: northcentralus
name: aci-cc-${{ parameters.environment }}
type: Microsoft.ContainerInstance/containerGroups
properties:
  imageRegistryCredentials:
  - server: myacrname.azurecr.io
    username: myusername
    password: $(ACR_PASSWORD) # 从变量组中引用
  osType: Linux
  subnetIds:
   - id: "/subscriptions/1111111111111111111/resourceGroups/rg-prod-network-001/providers/Microsoft.Network/virtualNetworks/vnet/subnets/apps"
     name: apps
  ipAddress:
    type: Private
    ports:
    - protocol: tcp
      port: '8080'
  restartPolicy: Always
  containers:
    - name: myaci-api
      properties:
        image: myacrname.azurecr.io/mycontainerapp-api:$(BUILD_ID) # 从管道变量中引用
        environmentVariables:
          - name: PORT
            value: '8080'
          - name: ConnectionStrings__DefaultDbConnection
            value: $(ConnectionString_DefaultConnection) # 使用下划线命名的变量组变量
        ports:
          - port: 8080
        resources:
          requests:
            cpu: 1.0
            memoryInGB: 2.0

内容的提问来源于stack exchange，提问作者Manas P