Azure DevOps构建中PowerShell推送Git仓库的认证问题咨询

问题描述 #

我是Azure DevOps新手，正在尝试把构建制品目录里的文件推送到Git仓库，用了下面的内联PowerShell脚本：

Write-Host "Hello World"
write-host " Staging directory "$(build.artifactstagingdirectory)
git config --global user.email <useremail>
git config --global user.name <username>
git status
$CurrentPath = Get-Location
write-host "current path" $CurrentPath
$PackagePath =new-item -type directory $(get-date -f MM-dd-yyyy_HH_mm_ss)
$PackageZipPath = "$(build.artifactstagingdirectory)\<artifact to be copied>"
Copy-Item $PackageZipPath -Destination $PackagePath
git add .
git commit -m "Adding file"
git push origin master
git status
write-host "Package Uploaded to GitHub"

但运行时遇到了这个错误，没法推送文件：

fatal: could not read Password for 'https://@dev.azure.com': terminal prompts disabled

想问下是不是漏了关键步骤？该怎么用PAT或者密码做认证呢？

问题分析 #

这个错误的核心原因是：Azure DevOps管道的运行环境是无交互的，终端提示被禁用了，Git没法弹出窗口让你输入密码，而你当前的脚本里没有提供自动认证的凭证。

解决方案：用PAT完成自动认证 #

下面两种方法都能解决这个问题，推荐用第二种（内置令牌）更安全便捷：

方法1：手动在Git远程URL里嵌入PAT #

你可以生成一个Azure DevOps的个人访问令牌（PAT），权限至少勾选Code (Full)，然后把PAT嵌入到Git的远程仓库URL中，这样Git就能自动完成认证：

# 先替换下面的占位符为你的实际信息
$pat = "<你的PAT>"
$orgName = "<你的组织名>"
$projectName = "<你的项目名>"
$repoName = "<你的仓库名>"

# 更新远程仓库URL，嵌入PAT
git remote set-url origin https://$pat@dev.azure.com/$orgName/$projectName/_git/$repoName

# 然后再执行推送
git push origin master

方法2：使用Azure DevOps管道内置的系统令牌（推荐） #

如果你的脚本是在Azure DevOps管道里运行的，完全不用手动生成PAT，直接用管道内置的$(System.AccessToken)变量就行——这个令牌是管道运行时自动创建的，拥有当前管道的权限：

# 替换占位符为你的组织、项目和仓库名
git remote set-url origin https://$(System.AccessToken)@dev.azure.com/<你的组织名>/<你的项目名>/_git/<你的仓库名>

git push origin master

⚠️ 注意：使用这个令牌前，要确保你的管道服务账户（Project Collection Build Service (<组织名>)）拥有目标Git仓库的Contribute权限。你可以在仓库的「设置→权限」里找到这个账户，给它分配对应的权限。

额外的脚本优化建议 #

1. 别用git config --global：管道的运行环境是临时的，使用本地配置更合适，去掉--global参数就行：

   git config user.email <useremail>
   git config user.name <username>
   

2. 验证文件复制结果：在Copy-Item之后加一行Get-ChildItem $PackagePath，确认文件确实复制过去了，方便排查问题；
3. 确认分支名称：现在很多仓库的默认分支是main而不是master，要确保你推送的分支名称和目标仓库一致；
4. 检查远程URL：可以在脚本里加git remote -v，确认远程仓库的URL是否设置正确。

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