如何在GitLab CI中将命令输出保存到Docker容器的syslog

问题背景 #

使用搭载Docker执行器的GitLab Runner时，希望在CI脚本中将部分日志保存至Job动态创建的Docker容器的syslog中。本地Bash环境下执行echo "hi" | logger可正常写入syslog，但在如下CI Job配置中，第二条命令无法生效：

image: python:latest

stages:
  - my_stage

my_job:
  stage: my_stage
  tags:
    - test
  script:
    - echo "Hi - only print"
    - echo "Hi - print and save to syslog" | logger -s

原因在于GitLab Runner动态创建的Job容器默认未运行syslog服务，部分镜像甚至未预装logger命令，导致直接调用失效。

可行解决方案 #

方案一：在容器内安装并启动syslog服务 #

针对Debian/Ubuntu系镜像（如python:latest），可在CI脚本中先安装rsyslog并启动服务，之后即可正常使用logger命令：

image: python:latest

stages:
  - my_stage

my_job:
  stage: my_stage
  tags:
    - test
  script:
    - echo "Hi - only print"
    # 安装rsyslog服务
    - apt-get update && apt-get install -y rsyslog
    # 启动syslog服务
    - service rsyslog start
    # 写入syslog并同时输出到终端（-s参数）
    - echo "Hi - print and save to syslog" | logger -s
    # 验证日志是否写入syslog
    - cat /var/log/syslog | grep "Hi - print and save to syslog"

优点：完全兼容logger命令的用法，可在容器内直接查看syslog内容；缺点：会增加Job执行时间，需安装额外依赖。

方案二：直接写入容器的syslog套接字 #

部分容器默认存在/dev/log Unix套接字，可手动构造符合syslog规范的日志内容直接写入该套接字，无需安装服务：

image: python:latest

stages:
  - my_stage

my_job:
  stage: my_stage
  tags:
    - test
  script:
    - echo "Hi - only print"
    # 构造syslog格式日志并写入/dev/log
    - echo "<134>$(date +'%b %d %H:%M:%S') $(hostname) my_job: Hi - print and save to syslog" > /dev/log

其中<134>是syslog优先级标识（对应user.notice级别），需遵循syslog的格式规范。
优点：轻量无额外依赖；缺点：需手动构造日志格式，兼容性取决于容器是否存在/dev/log套接字。

方案三：通过GitLab Runner配置转发日志到宿主机syslog #

无需修改CI脚本，直接在GitLab Runner的config.toml中配置日志转发，将所有Job日志统一发送到宿主机的syslog服务：

[[runners]]
  name = "docker-runner"
  url = "https://your-gitlab-instance/"
  token = "your-runner-token"
  executor = "docker"
  [runners.docker]
    image = "python:latest"
    privileged = false
    volumes = ["/cache"]
  [runners.logging]
    level = "info"
    format = "json"
    syslog_address = "udp://localhost:514"  # 宿主机syslog服务地址
    syslog_tag = "gitlab-runner-%n"  # 日志标签，用于区分不同Runner的Job

优点：无需修改CI逻辑，实现集中日志管理；缺点：无法在Job容器内查看syslog内容，所有Job日志都会被转发。

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