如何在macOS-tart虚拟机中配置GitLab CI权限上传私有CocoaPods库

核心思路 #

通过GitLab CI/CD变量注入认证凭据，让macOS-tart虚拟机获得私有Git仓库（私有CocoaPods仓库本质是Git仓库）的访问权限，无需手动配置虚拟机本地权限。

具体配置步骤 #

1. 准备认证凭据 #

• SSH密钥方式：
  生成无密码短语的SSH密钥对，将公钥添加到私有Git仓库的权限设置中（比如GitLab的Deploy Keys或用户SSH Keys）。
• 个人访问令牌（PAT）方式：
  在私有仓库平台（如GitLab）生成具备仓库读写权限的PAT，妥善保存令牌内容。

2. 在GitLab项目中配置CI/CD变量 #

进入项目「Settings」→「CI/CD」→「Variables」，添加对应变量：

• SSH密钥方式：添加变量SSH_PRIVATE_KEY，值为私钥内容，勾选「Protect variable」和「Mask variable」
• PAT方式：添加变量GITLAB_PAT，值为令牌内容，同样勾选保护和掩码

3. 在流水线脚本中配置认证 #

方式一：SSH密钥认证

在执行pod repo add前，添加以下脚本完成SSH配置：

# 创建SSH目录并设置权限
mkdir -p ~/.ssh
chmod 700 ~/.ssh
# 写入私钥
echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
chmod 600 ~/.ssh/id_rsa
# 添加仓库主机到已知主机（跳过首次连接确认）
ssh-keyscan gitlab.com >> ~/.ssh/known_hosts  # 替换为你的私有仓库主机地址
chmod 644 ~/.ssh/known_hosts

方式二：PAT认证

直接修改pod repo add的URL，嵌入PAT完成认证：

# 替换原pod repo add命令
pod repo add $MY_COCOAPODS_NAME https://oauth2:$GITLAB_PAT@<你的私有仓库主机地址>/<仓库路径>.git

4. 完整流水线任务示例 #

upload_podspec:
  stage: deploy
  tags:
    - macos-tart
  script:
    # SSH认证配置（若使用SSH方式）
    mkdir -p ~/.ssh
    chmod 700 ~/.ssh
    echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
    chmod 600 ~/.ssh/id_rsa
    ssh-keyscan gitlab.com >> ~/.ssh/known_hosts
    chmod 644 ~/.ssh/known_hosts
    # 执行pod仓库操作
    pod repo add $MY_COCOAPODS_NAME $MY_COCOAPODS_URL
    pod repo push $MY_COCOAPODS_NAME PODSPEC_PATH
  only:
    - tags

注意事项 #

• 确保macOS-tart虚拟机已预装Git和CocoaPods环境
• 掩码变量可避免敏感信息在流水线日志中泄露
• 若私有仓库使用自签名证书，可临时添加git config --global http.sslVerify false（不推荐长期使用）

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