如何将GitLab环境变量传入远程SSH命令参数？

核心问题分析 #

在GitLab CI/CD的SSH脚本中，你遇到的本质矛盾是：

• 单引号包裹远程命令：命令会在远程服务器执行，但本地环境变量（如$CI_PROJECT_NAME）无法被解析；
• 双引号包裹远程命令：本地会先解析所有变量和命令，导致远程执行的不是预期的指令。

可行解决方案 #

方案1：混合引号拼接（适合短命令） #

将需要本地解析的变量用双引号包裹，其余远程执行的命令部分用单引号包裹，通过引号拼接实现变量传递。示例：

ssh $REMOTE_SERVER_ADDRESS 'docker stop $(docker ps -q -f ancestor='"$CI_PROJECT_NAME"') && echo CONTAINER '"$CI_PROJECT_NAME"' STOPPED || echo '"$CI_PROJECT_NAME"' NOT FOUND'

原理：

• "$CI_PROJECT_NAME" 部分由本地GitLab Runner解析为实际变量值；
• 单引号包裹的其余命令会原封不动传到远程服务器执行，确保docker ps等操作在远程完成。

方案2：Here-doc 语法（适合复杂命令） #

用Here-doc传递多行命令，清晰区分本地解析和远程执行的部分，可读性更强：

ssh $REMOTE_SERVER_ADDRESS "PROJECT_NAME=$CI_PROJECT_NAME" << 'EOF'
docker stop $(docker ps -q -f ancestor=$PROJECT_NAME) && echo "CONTAINER $PROJECT_NAME STOPPED" || echo "$PROJECT_NAME NOT FOUND"
EOF

或者直接在Here-doc中解析本地变量（注意转义远程需要解析的命令符号）：

ssh $REMOTE_SERVER_ADDRESS << EOF
docker stop \$(docker ps -q -f ancestor=$CI_PROJECT_NAME) && echo "CONTAINER $CI_PROJECT_NAME STOPPED" || echo "$CI_PROJECT_NAME NOT FOUND"
EOF

原理：

• 不带单引号的EOF会让本地解析所有未转义的变量（如$CI_PROJECT_NAME）；
• 转义\$让远程服务器解析docker ps中的命令替换逻辑。

方案3：直接在远程命令前传递变量（简单场景） #

将本地变量赋值给远程环境变量，再执行命令，确保变量在远程shell中生效：

ssh $REMOTE_SERVER_ADDRESS "PROJECT_NAME=$CI_PROJECT_NAME; docker stop \$(docker ps -q -f ancestor=\$PROJECT_NAME) && echo CONTAINER \$PROJECT_NAME STOPPED || echo \$PROJECT_NAME NOT FOUND"

原理：

• 用双引号包裹整个远程命令，本地解析$CI_PROJECT_NAME为实际值；
• 远程需要解析的变量（如\$PROJECT_NAME）通过转义\，让远程shell解析。

你之前尝试方案的问题说明 #

你执行的ssh docker-user@192.168.100.3 test=docker-ci-cd 'echo $test'返回空，原因是：
单引号包裹的echo $test会让远程shell将$test当成字面量，而非变量。正确写法应该将变量赋值和命令放在同一个远程shell上下文里，比如：

ssh docker-user@192.168.100.3 'test=docker-ci-cd; echo $test'

或者用双引号让远程解析变量：

ssh docker-user@192.168.100.3 "test=docker-ci-cd; echo \$test"

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