如何部署依赖私有GitHub仓库的Python Azure函数应用？

一、VS Code HTTPS部署认证失败的修复 #

直接使用GitHub个人访问令牌（PAT）替换HTTPS URL中的匿名认证部分，修改requirements.txt中的依赖地址为：

git+https://<你的GitHub PAT>@github.com/#user#/#library#.git@main

• PAT需勾选repo权限，确保能访问目标私有仓库。
• 执行git config --global credential.helper store配置Git凭据助手，首次输入PAT后会自动保存，后续部署无需重复验证。

二、GitHub Actions SSH部署后代码变更未生效的排查方案 #

1. 强制更新私有仓库依赖 #

pip默认会缓存已安装的依赖版本，即使私有仓库代码更新也不会主动拉取。在workflow的pip安装步骤中添加强制更新参数：

pip install --no-cache-dir --force-reinstall -r requirements.txt

这会跳过缓存，重新从私有仓库拉取最新代码。

2. 优化缓存策略避免旧依赖残留 #

GitHub Actions的pip缓存如果只基于requirements.txt的哈希，会忽略私有仓库的代码变更。修改缓存key，加入私有仓库的最新commit哈希：

- name: 获取私有仓库最新commit哈希
  id: repo_hash
  run: echo "hash=$(git ls-remote git@github.com/#user#/#library#.git main | cut -f1)" >> $GITHUB_OUTPUT

- name: 缓存pip依赖
  uses: actions/cache@v3
  with:
    path: ~/.cache/pip
    key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}-${{ steps.repo_hash.outputs.hash }}

这样只要私有仓库代码更新，缓存就会失效，触发重新安装。

3. 锁定私有仓库的具体版本 #

避免依赖main分支的不确定性，直接在requirements.txt中指定私有仓库的具体commit哈希：

git+ssh://git@github.com/#user#/#library#.git@<目标commit哈希值>

每次私有仓库更新后，同步更新这个哈希值，确保部署时拉取指定版本的代码。

4. 检查SSH配置的有效性 #

确保GitHub Actions中使用的SSH密钥具备私有仓库的拉取权限，且workflow正确加载密钥：

• 使用webfactory/ssh-agent动作加载存储在GitHub Secrets中的SSH私钥：

  - name: 配置SSH代理
    uses: webfactory/ssh-agent@v0.7.0
    with:
      ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
  

• 提前添加GitHub主机指纹到known_hosts，避免连接时的交互阻塞：

  ssh-keyscan github.com >> ~/.ssh/known_hosts
  

5. 验证部署包的依赖版本 #

在部署前添加验证步骤，确认私有仓库的最新代码已被正确安装：

pip show <私有库名称>

查看输出的Location和Version字段，确认是否对应最新的commit。

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