如何在微软托管Azure Pipeline中通过yarn install拉取Bitbucket私有仓库包

方案一：通过Yarn配置直接注入认证信息 #

无需修改package.json，在yarn install前添加脚本配置Bitbucket认证，步骤如下：

• 在Azure DevOps库中创建安全变量BITBUCKET_USERNAME（Bitbucket账号）和BITBUCKET_APP_PASSWORD（Bitbucket生成的应用密码，需授予仓库只读权限），并勾选「允许在脚本中访问」
• 流水线中先执行配置命令，再拉取依赖：

# 针对带作用域的私有包配置（替换为你的包作用域）
yarn config set @your-scope:registry https://bitbucket.org/api/1.0/repositories/
# 全局配置Bitbucket仓库的认证信息
yarn config set //bitbucket.org/api/1.0/repositories/:username $(BITBUCKET_USERNAME)
yarn config set //bitbucket.org/api/1.0/repositories/:_password $(BITBUCKET_APP_PASSWORD)
yarn config set //bitbucket.org/api/1.0/repositories/:always-auth true

# 执行依赖拉取
yarn install

方案二：利用Git凭据配置实现认证 #

通过临时配置Git的凭据存储，让Yarn拉取Git形式的私有包时自动完成认证：

# 配置Git凭据存储
git config --global credential.helper store
# 将认证信息写入Git凭据文件
echo "https://$(BITBUCKET_USERNAME):$(BITBUCKET_APP_PASSWORD)@bitbucket.org" > ~/.git-credentials

# 执行依赖拉取
yarn install

方案三：修正SSH密钥认证配置 #

如果之前用InstallSSHKey@0失败，按以下步骤重新配置：

1. 在Bitbucket Cloud的个人设置中，添加Azure DevOps流水线使用的SSH公钥（路径：个人设置 → SSH keys）
2. 在Azure DevOps库中上传SSH私钥作为安全文件
3. 流水线中添加密钥安装任务，再执行拉取：

- task: InstallSSHKey@0
  inputs:
    knownHostsEntry: 'bitbucket.org ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAubiN81eDcafrgMeLzaFPsw2kNvEcqTKl/VqLat/MaB33pZy0y3rJZtnqwR2qOOvbwKZYKiEO1O6VqNEBxKvJJelCq0dTXWT5pbO2gDXC6h6QDXCaHo6pOHGPUy+YBaGQRGuSusMEASYiWunYN0vCAI8QaXnWMXNMdFP3jHAJH0eDsoiGnLPBlBp4TNm6rYI74nMzgz3B9IikW4WVK+dc8KZJZWYjAuORU3jc1c/NPskD2ASinf8v3xnfXeukU0sJ5N6m5E8VLjObPEO+mN2t/FZTMZLiFqPWc/ALSqnMnnhwrNi2rbfg/rd/IpL8Le3pSBne8+seeFVBoGqzHM9yXw=='
    sshKeySecureFile: '你上传的私钥安全文件名'
- script: |
    yarn install
  displayName: 'Yarn Install with SSH Auth'

4. 将package.json中的私有包地址改为SSH格式：git+ssh://git@bitbucket.org/<用户名>/<仓库名>.git#<分支/版本>

关键注意事项 #

• Bitbucket Cloud已不推荐使用账号密码做自动化认证，必须用应用密码（App Password），并确保权限仅包含仓库只读
• 微软托管代理为临时环境，所有认证配置必须在流水线中动态执行，无法依赖持久化设置

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