如何在Gitlab CI容器中登录以安装私有Composer依赖包

方案1：使用GitLab内置CI作业令牌（推荐，零手动密钥维护） #

这是GitLab为每个CI作业自动生成的临时访问令牌，作业结束后自动失效，完全无需绑定个人账号，权限可控。

• 操作前置配置：进入私有Composer包所在的GitLab项目/群组，在「设置」→「CI/CD」→「令牌访问」配置页，将运行CI的主项目添加到允许访问列表，开启跨项目访问权限。
• 在.gitlab-ci.yml的install执行步骤中，提前写入以下配置即可：

composer config --global gitlab-token.gitlab.com $CI_JOB_TOKEN
composer install -n

方案2：使用项目/群组级访问令牌 #

如果跨GitLab实例、或者CI作业令牌不满足你的使用场景，可以使用不绑定个人账号的项目/群组访问令牌：

• 进入私有包所属的GitLab项目/群组，在「设置」→「访问令牌」页新建令牌：权限仅勾选read_repository，角色选择Reporter（仅读权限满足拉包需求），按安全规范设置过期时间。
• 进入运行CI的主项目，在「设置」→「CI/CD」→「变量」页新增变量，命名比如COMPOSER_GITLAB_TOKEN，勾选掩码、保护选项，避免密钥在CI日志中泄露。
• 在CI脚本中配置令牌：

composer config --global gitlab-token.gitlab.com $COMPOSER_GITLAB_TOKEN
composer install -n

SSH模式排查补充 #

如果你在composer.json中配置的私有仓库地址是SSH格式，无需配置GitLab令牌，仅需确认你注入到CI中的SSH公钥已经作为「部署密钥」添加到所有私有包的GitLab项目中，且开启了拉取权限即可。

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