Azure DevOps发布流水线部署镜像至AKS时参数未填充问题求助

问题场景 #

通过Azure DevOps发布流水线将Python应用的Docker镜像部署到AKS集群，使用动态用户输入参数配置，但azure-aks.yaml中的image参数值始终无法从流水线参数中获取。

核心原因 #

1. 模板语法冲突：azure-aks.yaml中使用了Azure DevOps的模板表达式${{ parameters.containerRegistry }}，但该文件会被当作普通静态文件处理，DevOps不会解析其中的模板语法。
2. PowerShell替换逻辑错误：原脚本中的正则表达式无法正确匹配文件中的占位符，且硬编码文件路径可能导致路径错误。
3. 参数类型不匹配：containerRegistry参数被定义为object类型，若实际传入的是ACR名称字符串，类型不匹配会导致参数引用异常。

修正方案 #

1. 修改K8s配置文件的占位符 #

将azure-aks.yaml中的DevOps模板表达式替换为自定义占位符，避免语法冲突：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-python-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-python-app
  template:
    metadata:
      labels:
        app: my-python-app
    spec:
      containers:
      - name: dockerfile
        image: {{CONTAINER_REGISTRY}}/dockerfile:latest
        ports:
        - containerPort: 5000       
---
apiVersion: v1
kind: Service
metadata:
  name: my-python-app-svc
spec:
  selector:
    app: my-python-app
  ports:
    - protocol: TCP
      port: 5000
      targetPort: 5000
  type: LoadBalancer

2. 修正流水线参数类型 #

将containerRegistry等参数改为string类型（手动输入ACR名称场景），适配实际输入需求：

parameters:
- name: 'containerRegistry'
  displayName: 'Azure Container Registry'
  type: string
  default: 'your-acr-name'
 
- name: 'ResourceGroup'
  displayName: 'Azure ResourceGroup'
  type: string
  default: 'your-rg-name'

- name: 'Cluster'
  displayName: 'Azure Cluster'
  type: string
  default: 'your-aks-name'

3. 修正PowerShell替换任务 #

使用流水线内置变量获取文件路径，修正正则匹配逻辑：

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      $aksYamlPath = "$(Pipeline.Workspace)/drop/azure-aks.yaml"
      $fullRegistryName = "${{ parameters.containerRegistry }}.azurecr.io"
      $content = Get-Content -Path $aksYamlPath -Raw
      $content = $content -replace '{{CONTAINER_REGISTRY}}', $fullRegistryName
      Set-Content -Path $aksYamlPath -Value $content
  displayName: 'Replace Container Registry in YAML'

4. 可选：使用KubernetesManifest任务替代Kubernetes@1 #

更推荐使用现代的KubernetesManifest@1任务，支持直接通过变量替换YAML中的值，无需手动编写替换脚本：

- task: KubernetesManifest@1
  displayName: 'Deploy to AKS'
  inputs:
    action: deploy
    connectionType: 'Azure Resource Manager'
    azureSubscriptionEndpoint: 'TEST'
    azureResourceGroup: ${{ parameters.ResourceGroup }}
    kubernetesCluster: ${{ parameters.Cluster }}
    namespace: default
    manifests: '$(Pipeline.Workspace)/drop/azure-aks.yaml'
    containers: '${{ parameters.containerRegistry }}.azurecr.io/dockerfile:latest'

关键注意点 #

• 避免在静态配置文件中使用Azure DevOps模板表达式，这类表达式仅在流水线YAML解析阶段生效。
• 优先使用流水线内置变量（如$(Pipeline.Workspace)）而非硬编码路径，提升兼容性。
• 参数类型需与实际传入值匹配，object类型适用于复杂结构，简单字符串输入用string类型更合适。

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