Debian12环境下GitLab Runner容器创建报错排查及正确方法

操作问题与错误原因 #

• 核心问题出在docker run命令的续行符号使用错误：Shell中反斜杠\作为续行符时，必须紧跟在行尾，后面不能有任何空格或字符。你当前命令里每个\后面都带了空格，导致Shell错误地将后续的-v等参数解析成镜像名称的一部分，触发invalid reference format（无效引用格式）错误。
• 额外冗余操作：你执行了docker volume create runner01，但后续docker run并未关联这个卷，属于无意义操作。

正确创建GitLab Runner容器的命令 #

修正续行符问题，同时移除冗余的卷创建命令：

curl -fsSL https://get.docker.com | sh
docker pull gitlab/gitlab-runner:latest
docker run -d --name runner01 --restart always \
-v /srv/gitlab-runner/config:/etc/gitlab-runner \
-v /var/run/docker.sock:/var/run/docker.sock \
gitlab/gitlab-runner:latest

可选：使用预创建卷存储配置 #

如果想用预先创建的Docker卷保存Runner配置，可使用以下命令：

curl -fsSL https://get.docker.com | sh
docker pull gitlab/gitlab-runner:latest
docker volume create runner01-config
docker run -d --name runner01 --restart always \
-v runner01-config:/etc/gitlab-runner \
-v /var/run/docker.sock:/var/run/docker.sock \
gitlab/gitlab-runner:latest

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