Azure Pipelines：如何抽象Kubernetes部署任务的重复参数？

针对你遇到的重复配置、模板变量传递、Replacetokens失效等问题，以下是具体的落地方案，兼顾通用性和灵活性：

一、优先方案：变量模板 + 作业模板组合 #

步骤模板本身不支持直接导入变量模板，但作业模板可以，这是解决你问题的核心思路。通过将通用配置抽离到变量模板，再用作业模板整合变量和部署步骤，主流水线只需按需覆盖变量即可。

1. 定义通用变量模板 #

创建variables/k8s-deploy.yml，存放所有默认配置：

variables:
  k8sConnectionType: 'AzureResourceManager'
  azureSubscriptionEndpoint: 'Default-Subscription'
  k8sResourceGroup: 'Default-RG'
  k8sClusterName: 'Default-Cluster'
  k8sNamespace: 'default'

2. 定义作业模板 #

创建jobs/k8s-deploy-job.yml，导入变量模板并包含完整部署步骤：

jobs:
- job: DeployToKubernetes
  variables:
  - template: ../variables/k8s-deploy.yml  # 导入通用变量
  steps:
  - task: AzureCLI@2
    inputs:
      azureSubscription: '$(azureSubscriptionEndpoint)'
      scriptType: 'bash'
      inlineScript: |
        az aks get-credentials --resource-group $(k8sResourceGroup) --name $(k8sClusterName) --namespace $(k8sNamespace)
  - task: Replacetokens@5
    inputs:
      targetFiles: '**/*.yaml'
      encoding: 'utf-8'
      tokenPattern: 'default'
      tokenPrefix: '#{'
      tokenSuffix: '}#'
      actionOnMissing: 'warn'
  - task: KubernetesManifest@1
    inputs:
      action: 'deploy'
      connectionType: '$(k8sConnectionType)'
      azureSubscriptionEndpoint: '$(azureSubscriptionEndpoint)'
      azureResourceGroup: '$(k8sResourceGroup)'
      kubernetesCluster: '$(k8sClusterName)'
      namespace: '$(k8sNamespace)'
      manifests: '**/*.yaml'

3. 主流水线调用作业模板 #

只需覆盖差异变量，无需重复填写所有配置：

trigger: none

variables:
  # 按需覆盖通用变量，比如生产环境配置
  azureSubscriptionEndpoint: 'Prod-Subscription'
  k8sResourceGroup: 'Prod-RG'
  k8sNamespace: 'prod'

jobs:
- template: jobs/k8s-deploy-job.yml

二、替代方案：带默认值的步骤模板 #

如果必须使用步骤模板，可以给参数设置默认值，避免每次重复传参：

创建steps/k8s-deploy-steps.yml：

parameters:
  - name: k8sConnectionType
    type: string
    default: 'AzureResourceManager'
  - name: azureSubscriptionEndpoint
    type: string
    default: 'Default-Subscription'
  - name: k8sResourceGroup
    type: string
    default: 'Default-RG'
  - name: k8sClusterName
    type: string
    default: 'Default-Cluster'
  - name: k8sNamespace
    type: string
    default: 'default'

steps:
- task: AzureCLI@2
  inputs:
    azureSubscription: '${{ parameters.azureSubscriptionEndpoint }}'
    scriptType: 'bash'
    inlineScript: |
      az aks get-credentials --resource-group ${{ parameters.k8sResourceGroup }} --name ${{ parameters.k8sClusterName }} --namespace ${{ parameters.k8sNamespace }}
- task: Replacetokens@5
  inputs:
    targetFiles: '**/*.yaml'
    tokenPrefix: '#{'
    tokenSuffix: '}#'
- task: KubernetesManifest@1
  inputs:
    action: 'deploy'
    connectionType: '${{ parameters.k8sConnectionType }}'
    azureSubscriptionEndpoint: '${{ parameters.azureSubscriptionEndpoint }}'
    azureResourceGroup: '${{ parameters.k8sResourceGroup }}'
    kubernetesCluster: '${{ parameters.k8sClusterName }}'
    namespace: '${{ parameters.k8sNamespace }}'
    manifests: '**/*.yaml'

主流水线调用时仅传差异参数：

trigger: none

steps:
- template: steps/k8s-deploy-steps.yml
  parameters:
    azureSubscriptionEndpoint: 'Prod-Subscription'
    k8sNamespace: 'prod'

三、Replacetokens失效问题解决 #

Replacetokens在模板中失效的核心原因是模板编译时序：模板表达式{{ variables.xxx }}在编译时解析，而Replacetokens是运行时执行。解决方式：

• 在作业模板中使用运行时变量语法$(variable)，确保变量在运行时被正确注入；
• 在步骤模板中使用参数语法${{ parameters.xxx }}，编译时直接替换为参数值。

四、关于"将步骤拆为独立作业"的最佳实践判断 #

将所有步骤拆为独立作业不属于最佳实践，原因如下：

• 每个独立作业需要重新初始化Agent环境、下载依赖、建立K8s连接，会大幅增加流水线执行时间；
• 作业间的上下文不共享，需要额外处理 artifact 传递，增加复杂度；
• 仅当需要隔离不同环境的部署（如用不同Agent池）、并行执行无关任务时，才适合拆分作业。

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