多租户移动应用CI/CD流水线：动态加载租户变量组问题

问题概述 #

我搭建了多实例移动应用的CI/CD流水线，支持选择多个租户并生成对应APK和AAB文件。流水线参数配置如下：

- name: Tenants
  displayName: "Select Tenants to build for"
  type: object
  default:
  - ExampleClient
  - ExampleClient2

最初尝试在BuildAndroid阶段用矩阵循环实现多租户构建，但阶段级变量组加载失败：

- stage: BuildAndroid
  variables:
  - group: ${{ TenantName }} # 此处报错，TenantName是矩阵运行时变量，编译时无法识别
  jobs:
  - job: 'BuildAndroid'
    strategy:
      matrix:
        ${{ each tenant in parameters.Tenants }}:
          ${{ format('{0}_APK', tenant) }}:
            TenantName: ${{ tenant }}
            BuildFormat: 'apk'
            SignAndroid: $(SignAndroidApk)
            BuildApp: $(PackageAndroidApk)
          ${{ format('{0}_AAB', tenant) }}:
            TenantName: ${{ tenant }}
            BuildFormat: 'aab'
            SignAndroid: $(SignAndroidAab)
            BuildApp: $(PackageAndroidAab)
    displayName: 'Build Android'

报错信息：

(Line: 53, Col: 12): Unrecognized value: 'TenantName'. Located at position 1 within 
expression: TenantName.

核心需求：运行前选择多个租户，为每个租户构建APK/AAB，并自动加载对应租户的专属变量组。

可行解决方案 #

方案1：矩阵项内直接加载变量组（推荐） #

将变量组的加载逻辑嵌入矩阵的每个配置项，利用编译时循环提前生成每个租户+构建格式的变量组引用：

- stage: BuildAndroid
  jobs:
  - job: 'BuildAndroid'
    strategy:
      matrix:
        ${{ each tenant in parameters.Tenants }}:
          ${{ format('{0}_APK', tenant) }}:
            TenantName: ${{ tenant }}
            BuildFormat: 'apk'
            variables:
              - group: ${{ tenant }} # 编译时直接绑定租户变量组
            SignAndroid: $(SignAndroidApk)
            BuildApp: $(PackageAndroidApk)
          ${{ format('{0}_AAB', tenant) }}:
            TenantName: ${{ tenant }}
            BuildFormat: 'aab'
            variables:
              - group: ${{ tenant }}
            SignAndroid: $(SignAndroidAab)
            BuildApp: $(PackageAndroidAab)
    displayName: 'Build Android'

此方案保持单阶段结构，编译时流水线会为每个矩阵任务单独加载对应租户的变量组，完美适配多租户批量构建需求。

方案2：按租户拆分独立阶段 #

如果需要更清晰的租户级构建隔离，可以通过编译时循环为每个租户创建独立阶段，再在阶段内处理APK/AAB构建：

${{ each tenant in parameters.Tenants }}:
- stage: BuildAndroid_${{ tenant }}
  variables:
    - group: ${{ tenant }} # 阶段级直接加载租户变量组
  jobs:
  - job: 'BuildAndroid'
    strategy:
      matrix:
        APK:
          BuildFormat: 'apk'
          SignAndroid: $(SignAndroidApk)
          BuildApp: $(PackageAndroidApk)
        AAB:
          BuildFormat: 'aab'
          SignAndroid: $(SignAndroidAab)
          BuildApp: $(PackageAndroidAab)
    displayName: 'Build Android for ${{ tenant }}'

这种方式每个租户对应独立的流水线阶段，便于单独监控某个租户的构建状态，变量组加载逻辑更直观。

核心注意点 #

• 变量组只能在编译阶段确定，必须使用编译时表达式${{ ... }}引用，无法通过运行时的$(...)动态加载。
• 两种方案均利用流水线的编译时循环能力，提前为每个租户生成配置，确保变量组能正确绑定到对应构建任务。

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