Gitlab CI容器systemd作为PID1与Gitlab Runner的冲突解决求助

核心矛盾是Gitlab Runner会覆盖Docker CMD，而systemd（/usr/sbin/init）无法直接执行传递的CI命令。下面是可行的解决方案：

方案：自定义Entrypoint脚本，让systemd自动执行CI任务 #

1. 编写Entrypoint脚本 #

创建ci-systemd-entrypoint.sh，作用是将Gitlab传递的CI命令转为systemd临时服务，让systemd启动后自动执行：

#!/bin/bash
set -e

# 若有传入命令参数，创建临时systemd服务
if [ $# -gt 0 ]; then
    # 转义命令参数，避免特殊字符问题
    ESCAPED_CMD=$(printf "%q " "$@")
    cat > /etc/systemd/system/ci-task.service <<EOF
[Unit]
Description=GitLab CI Task
After=multi-user.target

[Service]
Type=oneshot
ExecStart=/bin/bash -c "$ESCAPED_CMD"
# 任务完成后关闭容器
ExecStopPost=/sbin/poweroff
RemainAfterExit=yes
EOF

    # 重载systemd配置并启用服务
    systemctl daemon-reload
    systemctl enable ci-task.service
fi

# 启动systemd作为PID1
exec /usr/sbin/init

2. 更新Dockerfile #

将脚本加入镜像，设置为ENTRYPOINT：

# 基于已配置systemd的基础镜像（如centos:stream9、ubuntu:22.04等）
FROM ubuntu:22.04

# 安装systemd及依赖（若基础镜像未预装）
RUN apt-get update && apt-get install -y systemd && apt-get clean
# 优化systemd启动，关闭不必要服务
RUN systemctl set-default multi-user.target
RUN systemctl mask systemd-logind.service systemd-resolved.service

# 复制并设置entrypoint脚本
COPY ci-systemd-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/ci-systemd-entrypoint.sh

ENTRYPOINT ["/usr/local/bin/ci-systemd-entrypoint.sh"]

3. 配置Gitlab Runner #

确保Runner以特权模式运行，并挂载cgroup文件系统（systemd必需）：
在Runner的config.toml中修改对应runner配置：

[[runners]]
  name = "systemd-ci-runner"
  url = "https://your-gitlab-instance.com/"
  token = "your-runner-token"
  executor = "docker"
  [runners.docker]
    tls_verify = false
    image = "your-systemd-ci-image:latest"
    privileged = true
    volumes = ["/sys/fs/cgroup:/sys/fs/cgroup:rw", "/cache"]
    shm_size = 0

工作原理 #

1. Gitlab Runner启动容器时，将CI脚本作为参数传递给Entrypoint脚本
2. 脚本创建一个systemd临时服务，服务配置中包含要执行的CI命令
3. 脚本启动systemd作为PID1，systemd初始化完成后自动启动临时服务
4. CI命令执行完成后，服务触发poweroff让容器正常退出

内容的提问来源于stack exchange，提问作者Nicola Mori