GitLab.com CI配置Rails项目遇Master Key缺失报错求助

别担心，这个问题很常见，GitLab本身就提供了安全的解决办法，完全不需要把主密钥提交到代码仓库里。核心思路是用GitLab的CI/CD环境变量来存储密钥，而非硬写到.gitlab-ci.yml中。

具体步骤如下：

• 第一步：在GitLab项目中配置安全变量

  1. 打开你的GitLab项目页面，点击左侧菜单栏的「Settings」→「CI/CD」
  2. 滚动到「Variables」区域，点击「Add variable」按钮
  3. 在弹出的表单里：
     • 「Key」输入RAILS_MASTER_KEY
     • 「Value」粘贴你本地config/master.key文件里的完整内容（注意不要带任何空格或换行）
     • 勾选「Mask variable」——这个选项会让密钥在CI运行日志里被隐藏，防止泄露
     • 如果你的部署分支是受保护的（比如main/master），再勾选「Protect variable」，确保只有受保护分支能访问这个变量
  4. 点击「Add variable」保存

• 第二步：调整你的.gitlab-ci.yml（几乎不用改）
  Rails会自动读取环境变量中的RAILS_MASTER_KEY，所以你原来的rails db:migrate命令完全可以保留，不需要在.gitlab-ci.yml里添加任何关于密钥的配置。比如你的CI脚本可以是这样：

  deploy:
    stage: deploy
    script:
      - bundle install
      - rails db:migrate
      - # 其他部署命令
  

• 额外注意事项：

  • 确认你的.gitignore文件里已经包含了config/master.key，避免不小心把密钥提交到仓库
  • 如果你的项目使用了Rails多环境凭证（比如config/credentials/production.yml.enc），对应的密钥文件是config/credentials/production.key，这时候你需要在GitLab变量里设置RAILS_CREDENTIALS_KEY，值就是这个文件的内容，原理和master key一致

这样配置后，CI运行时就能安全地获取到加密密钥，同时不会有任何密钥泄露的风险。

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