使用私有GitHub Homebrew Tap分发私有仓库工具遇阻求助

核心问题分析 #

你遇到的404/仓库不存在错误，本质是Formula使用SSH URL克隆私有仓库，但GitHub Actions环境未配置SSH密钥，而你配置的PAT仅适用于HTTPS认证，导致克隆失败。以下是修正后的可运行示例及关键配置说明：

修正后的Formula示例（/Formula/bar@0.7.0.rb） #

class BarAT070 < Formula
  include Language::Python::Virtualenv

  desc "公司内部Python工具"
  homepage "https://github.com/foo/bar"
  # 替换为HTTPS URL，适配PAT认证
  url "https://github.com/foo/bar.git", tag: "v0.7.0", revision: "5bbf5c5c2673d976c8206d5332add7c3xxxxx"
  license "MIT" # 替换为实际许可证类型，不能为空

  depends_on "python3"

  # 如果项目用Poetry管理依赖，需添加Poetry作为资源
  resource "poetry" do
    url "https://files.pythonhosted.org/packages/8b/08/44f3e2002b1d5d2615897f8f3729944578a0f94a80275c989797a439d545/poetry-1.8.3.tar.gz"
    sha256 "a8b4c6c2a2e0d2f65e4e25a306559a4b79a257036b1b2d9a6b8e09a0e0a5e3b5"
  end

  def install
    # 创建虚拟环境
    venv = virtualenv_create(libexec, "python3")
    
    # 安装Poetry到虚拟环境
    venv.pip_install resource("poetry")
    
    # 用Poetry安装项目依赖并构建
    cd buildpath do
      venv.poetry_install "--no-root"
      venv.poetry_build "--format wheel"
      venv.pip_install "dist/*.whl", "--no-deps"
    end
    
    # 创建命令符号链接到系统bin目录
    bin.install_symlink libexec/"bin/bar"
  end

  test do
    system "#{bin}/bar", "--version"
  end
end

修正后的GitHub Actions Workflow（/.github/workflows/tests.yml） #

name: brew test-bot

on:
  push:
    branches: [main]
  pull_request:

env:
  # 确保Homebrew使用私有PAT访问仓库
  HOMEBREW_GITHUB_API_TOKEN: ${{ secrets.HOMEBREW_GITHUB_PAT }}
  # 禁止自动更新避免权限问题
  HOMEBREW_NO_AUTO_UPDATE: 1

jobs:
  test-bot:
    strategy:
      matrix:
        os: [ubuntu-22.04, macos-13]
    runs-on: ${{ matrix.os }}
    
    steps:
      - name: Set up Homebrew
        id: set-up-homebrew
        uses: Homebrew/actions/setup-homebrew@master
        with:
          # 使用私有PAT而非默认github.token（默认token权限有限）
          token: ${{ secrets.HOMEBREW_GITHUB_PAT }}

      - name: Configure Git for Private Repos
        run: |
          git config --global credential.helper store
          echo "https://${HOMEBREW_GITHUB_API_TOKEN}@github.com" > ~/.git-credentials
          git config --global url."https://github.com/".insteadOf "git@github.com:"
          # 强制所有SSH请求转为HTTPS，避免Formula中残留SSH URL导致失败
          git config --global url."https://github.com/foo/".insteadOf "git@github.com:foo/"

      - name: Cache Homebrew Bundler RubyGems
        uses: actions/cache@v4
        with:
          path: ${{ steps.set-up-homebrew.outputs.gems-path }}
          key: ${{ runner.os }}-rubygems-${{ steps.set-up-homebrew.outputs.gems-hash }}
          restore-keys: ${{ runner.os }}-rubygems-

      - run: brew test-bot --only-cleanup-before
      - run: brew test-bot --only-setup
      - run: brew test-bot --only-tap-syntax
      
      - run: brew test-bot --only-formulae
        if: github.event_name == 'pull_request'

      - name: Upload bottles as artifact
        if: always() && github.event_name == 'pull_request'
        uses: actions/upload-artifact@v4
        with:
          name: bottles_${{ matrix.os }}
          path: '*.bottle.*'

关键配置要点 #

• URL协议选择：所有私有仓库URL必须使用HTTPS，而非SSH。PAT仅能通过HTTPS认证，Actions环境默认无SSH密钥。
• PAT权限：确保HOMEBREW_GITHUB_PAT拥有repo权限（包括私有仓库的读取权限），且已正确添加到仓库Secrets中。
• Git凭证强制转换：通过git config --global url.insteadOf将所有SSH请求转为HTTPS，避免Formula或依赖中残留SSH URL导致认证失败。
• Homebrew环境变量：设置HOMEBREW_NO_AUTO_UPDATE=1避免自动更新时触发权限问题，同时确保HOMEBREW_GITHUB_API_TOKEN全局生效。
• Poetry集成：如果项目使用Poetry，需将Poetry作为Formula的资源安装到虚拟环境中，确保依赖安装流程完整。

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