使用自托管Windows代理部署Azure静态Web应用时Pipeline失败

问题根源 #

错误日志显示bash无法找到脚本文件，核心原因有两点：

• Windows路径的反斜杠\在bash环境中被当作转义字符，导致路径分隔符丢失，变成C:agent_work_tasks...这种无效格式
• bash需要WSL风格的路径（如/mnt/c/agent/_work/_tasks/...），而非Windows原生的C:\agent\_work\_tasks\...格式

可行解决方案 #

方案1：用PowerShell手动转换路径并执行部署 #

替换原有的AzureStaticWebApp@0任务为PowerShell脚本步骤，手动处理路径转换并调用部署脚本：

- job: build_and_deploy_job
  displayName: Build and Deploy Job
  condition: or(eq(variables['Build.Reason'], 'Manual'),or(eq(variables['Build.Reason'], 'PullRequest'),eq(variables['Build.Reason'], 'IndividualCI')))
  pool:
    name: Local Agent Pool
  variables:
  - group: Azure-Static-Web-Apps-victorious-beach-0d42cb803-variable-group
  steps:
  - checkout: self
    submodules: true
  - powershell: |
      # 将Windows格式的任务脚本路径转换为WSL格式
      $wslScriptPath = wsl wslpath -u "$(Agent.WorkFolder)/_tasks/AzureStaticWebApp_18aad896-e191-4720-88d6-8ced4806941a/0.246.1/launch-docker.sh"
      
      # 设置部署所需的环境变量
      $env:AZURE_STATIC_WEB_APPS_API_TOKEN = "$(AZURE_STATIC_WEB_APPS_API_TOKEN_VICTORIOUS_BEACH_0D42CB803)"
      $env:APP_LOCATION = "/"
      $env:API_LOCATION = ""
      $env:OUTPUT_LOCATION = "build"
      $env:SKIP_API_BUILD = "true"
      
      # 调用WSL bash执行部署脚本
      & C:\WINDOWS\system32\bash.exe -c "$wslScriptPath"
    displayName: 'Deploy to Azure Static Web App via WSL'

方案2：升级AzureStaticWebApp任务版本 #

尝试使用最新版本的AzureStaticWebApp任务（如@1），新版本可能已修复Windows代理上的路径处理缺陷：

- task: AzureStaticWebApp@1
  inputs:
    azure_static_web_apps_api_token: $(AZURE_STATIC_WEB_APPS_API_TOKEN_VICTORIOUS_BEACH_0D42CB803)
    app_location: "/"
    api_location: ""
    output_location: "build"
    skip_api_build: true

方案3：确认代理的WSL映射配置 #

1. 在代理机器的WSL终端中，检查/mnt/c是否正确映射Windows的C盘（默认已配置）
2. 确保运行代理的用户拥有WSL访问权限
3. 重启自托管代理服务，确保环境变量加载正常

验证步骤 #

1. 运行修改后的Pipeline
2. 检查日志中bash命令的路径是否变为/mnt/c/agent/_work/_tasks/...格式
3. 确认部署任务是否成功完成

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