如何为自托管GitLab Runner设置秘钥变量？本地执行变量为空怎么办？

你遇到的核心问题是：gitlab-runner exec docker不会自动从GitLab服务器拉取你配置的项目/全局变量，托管环境能正常获取是因为GitLab Runner在托管模式下会和服务器同步变量，但本地exec模式是离线运行的，得手动注入这些变量。

下面给你几种可靠的解决方法：

方法1：命令行临时注入变量 #

直接在执行命令前拼接环境变量，适合临时测试：

SSH_PRIVATE_KEY="$(cat /path/to/your/private/key)" gitlab-runner exec docker build

如果你的密钥包含换行符，用cat读取文件的方式能自动保留格式，比手动粘贴更稳妥。

方法2：使用环境变量文件（推荐） #

创建一个.env文件（注意不要提交到版本库，添加到.gitignore），内容如下：

SSH_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----
your-key-content-here
-----END RSA PRIVATE KEY-----"

然后执行命令时指定这个文件：

gitlab-runner exec docker --env-file .env build

这种方式适合需要传递多个变量的场景，管理起来更清晰。

方法3：通过--env参数单独传递 #

如果只需要传这一个变量，也可以用--env参数逐个指定：

gitlab-runner exec docker --env SSH_PRIVATE_KEY="$(cat /path/to/key)" build

注意事项 #

• 如果你直接在命令行粘贴密钥内容，要确保换行符被正确处理（大部分shell支持用双引号包裹多行内容）；
• 不要把包含私钥的.env文件提交到Git仓库，避免密钥泄露；
• 如果你的SSH_PRIVATE_KEY在GitLab上是受保护/掩码变量，本地exec模式完全无法自动获取，必须手动注入。

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