在Agent中使用Replace Token任务及解决Git Bash路径错误问题

ERROR:
Unable to locate executable file: 'bash'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.

解决步骤 #

• 确认Git Bash的bash.exe实际路径：通常在C:\Program Files\Git\bin或C:\Program Files\Git\usr\bin目录下
• 将上述路径添加到系统环境变量的PATH中（不要只加用户变量，避免Agent服务权限问题）
• 重启Azure Pipeline Agent服务，让环境变量生效
• 验证：在Agent机器的命令提示符中执行bash --version，确认能正常返回版本信息

需求：替换Agent文件夹内（非源码库）生成文件的环境标识，例如将https://dev-domain.com中的dev替换为stage/prod等，该任务对源码库文件有效，但对Agent直接生成的文件无效

解决步骤 #

• 指定文件绝对路径：在Replace Token任务中，不要使用相对路径，直接填写目标文件的完整路径，比如$(Agent.WorkFolder)/_temp/generated-config.txt
• 调整任务执行顺序：确保Replace Token任务在生成目标文件的任务之后运行
• 匹配令牌格式：检查Replace Token任务的tokenPattern设置，确保和文件中的令牌格式一致。例如任务默认用__{token}__的话，文件内容要改为https://__env__-domain.com；如果自定义了#{token}#格式，文件也要对应调整
• 添加文件校验：在Replace Token任务前新增PowerShell/Bash任务，验证文件存在且内容正确，示例PowerShell命令：

  # 检查文件是否存在
  Test-Path "$(Agent.WorkFolder)/_temp/generated-config.txt"
  # 查看文件内容
  Get-Content "$(Agent.WorkFolder)/_temp/generated-config.txt"
  

• 确认权限：确保Azure Pipeline Agent的服务账户对目标文件所在文件夹有读写权限

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