如何在GitLab CI中正确使用File类型环境变量

问题根源 #

你当前配置的是普通环境变量，而非GitLab专门的File类型变量。File类型变量的设计逻辑是：GitLab自动将变量内容写入临时文件，环境变量的值对应这个临时文件的路径，而非直接返回变量内容。

正确配置流程 #

• 进入项目的 Settings > CI/CD > Variables 页面
• 点击「Add variable」按钮
• 填写变量名称（例如 DEPLOY_PRIVATE_KEY_PATH）
• 在「Value」输入框中粘贴完整的私钥内容（包含----BEGIN PRIVATE KEY----和----END PRIVATE KEY----标记行）
• 必须勾选File选项（该选项用于指定变量类型为文件，不同GitLab版本的UI位置可能略有差异）
• 按需勾选「Protected」和「Masked」（私钥类敏感变量建议全部勾选，提升安全性）
• 保存变量配置

验证操作 #

在CI任务中执行以下命令验证：

# 输出临时文件路径
echo $DEPLOY_PRIVATE_KEY_PATH
# 输出私钥内容，确认文件正确写入
cat $DEPLOY_PRIVATE_KEY_PATH

额外注意 #

• 无需手动创建文件并写入私钥，GitLab会自动完成临时文件的创建与任务结束后的清理
• 若之前已创建同名的普通环境变量，需先删除旧变量，再重新创建File类型变量，避免冲突
• 私钥内容要完整，不可省略首尾的标记行，否则会导致文件内容无效

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