如何将Azure DevOps库变量传入Aspire .NET容器环境变量？

1. 流水线中正确引用库组变量 #

先在Azure DevOps流水线YAML里引入对应环境的库组，确保email_address变量能被流水线读取：

variables:
- group: 'dev-variables' # 切换到uat环境时替换为uat-variables
- name: EMAIL_ADDRESS
  value: $(email_address) # 将库组变量映射为流水线可直接调用的变量

2. 通过Bicep模板传递变量到容器应用 #

如果是用Bicep部署Azure容器应用，直接在Bicep中定义参数并映射到容器环境变量：

2.1 定义Bicep参数 #

在主Bicep文件（如main.bicep）中添加参数：

param emailAddress string

2.2 配置容器应用的环境变量 #

找到容器应用的容器定义段，添加环境变量配置：

resource containerApp 'Microsoft.App/containerApps@2023-05-01' = {
  name: 'webfrontend'
  location: location
  properties: {
    template: {
      containers: [
        {
          name: 'webfrontend'
          image: 'your-image-repo-url'
          env: [
            {
              name: 'EMAIL_ADDRESS'
              value: emailAddress
            }
          ]
          // 其他容器配置（资源限制、端口等）
        }
      ]
      // 其他模板配置（如 ingress、Dapr 等）
    }
    // 其他资源配置（如托管环境引用）
  }
}

2.3 流水线任务中传递参数 #

在AzureCLI部署任务里，将流水线变量作为参数传入Bicep部署命令：

- task: AzureCLI@2
  displayName: '部署Bicep到Azure'
  inputs:
    azureSubscription: '你的订阅名称'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az deployment group create \
        --resource-group $(resourceGroupName) \
        --template-file ./main.bicep \
        --parameters emailAddress=$(EMAIL_ADDRESS)

3. 若使用Aspire原生部署（依赖tmpl.yaml） #

如果是通过Aspire的azd up或自带部署逻辑，按以下方式配置：

3.1 在Aspire AppHost中注入环境变量 #

在AppHost项目的Program.cs里，为webfrontend服务添加环境变量：

var builder = DistributedApplication.CreateBuilder(args);

// 从配置中读取流水线传递的变量
var emailAddress = builder.Configuration["EMAIL_ADDRESS"] ?? throw new InvalidOperationException("未配置EMAIL_ADDRESS变量");

var webfrontend = builder.AddProject<Projects.webfrontend>("webfrontend")
  .WithEnvironment("EMAIL_ADDRESS", emailAddress);

builder.Build().Run();

3.2 流水线中传递变量到Aspire部署 #

在AzureCLI任务里，将流水线变量作为环境变量传入部署命令：

- task: AzureCLI@2
  displayName: '部署Aspire应用'
  inputs:
    azureSubscription: '你的订阅名称'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      export EMAIL_ADDRESS=$(EMAIL_ADDRESS)
      azd up --environment $(environmentName) --no-prompt

3.3 修改tmpl.yaml模板（若需直接引用） #

如果必须在webfrontend.tmpl.yaml中显式定义，直接使用变量名即可，无需.Env前缀：

containers:
  - name: webfrontend
    image: ${IMAGE}
    env:
      - name: EMAIL_ADDRESS
        value: ${EMAIL_ADDRESS}

关键注意事项 #

• 不要混淆AzureCLI任务的本地环境变量和部署上下文变量：CLI任务内设置的环境变量仅在当前shell有效，不会自动传递到Aspire模板或Bicep，必须显式传递。
• 检查库组权限：确保流水线服务主体有权限读取库组中的email_address变量。
• Aspire部署优先用AppHost配置：这是Aspire官方推荐的方式，比直接修改tmpl.yaml更易维护。

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