GitLab CI/CD中无法将SSH私钥传递至容器构建环节的问题

1. 检查GitLab CI变量配置 #

登录GitLab项目，进入Settings > CI/CD > Variables，确认SSH_PRIV_KEY变量配置正确：

• 变量类型选Variable，粘贴完整的SSH私钥（包含-----BEGIN RSA PRIVATE KEY-----、-----END RSA PRIVATE KEY-----及中间所有换行）
• 若构建分支为受保护分支，勾选变量的Protected选项
• 不要勾选Masked（多行私钥会导致masking失效，变量无法正常传递）

2. 修正.gitlab-ci.yml中的Docker构建命令 #

传递构建参数时必须用双引号包裹变量，避免shell解析丢失换行符：

build:php:
  stage: build
  script:
    # 可选：验证变量是否存在，打印长度确认
    - echo "SSH_PRIV_KEY 长度: ${#SSH_PRIV_KEY}"
    - docker build --build-arg SSH_PRIV_KEY="$SSH_PRIV_KEY" -t your-php-image:latest .

不用双引号的话，私钥中的换行符会被shell替换为空格，导致写入id_rsa的内容混乱或为空。

3. 优化Dockerfile写入私钥的逻辑 #

避免用echo（对换行符处理异常），改用printf保留完整私钥内容，同时设置正确的目录权限：

# 必须在RUN命令前定义ARG，否则无法读取变量
ARG SSH_PRIV_KEY

RUN mkdir -p /root/.ssh \
    # 用printf保留私钥所有字符（包括换行）
    && printf "%s" "$SSH_PRIV_KEY" > /root/.ssh/id_rsa \
    # SSH要求id_rsa权限必须为600
    && chmod 600 /root/.ssh/id_rsa \
    # 可选：添加Git服务器到known_hosts，避免首次连接的确认提示
    && ssh-keyscan github.com >> /root/.ssh/known_hosts

4. 排查变量注入问题 #

如果执行echo "SSH_PRIV_KEY 长度: ${#SSH_PRIV_KEY}"输出为0，说明变量未正确注入CI job：

• 确认变量名称拼写完全一致（大小写敏感）
• 若变量设置了Protected，需确保job运行在受保护分支上
• 检查是否有其他CI配置覆盖了该变量

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