GCP COS VM中Docker daemon.json日志配置失效原因排查

一、daemon.json配置不生效的常见原因 #

针对COS（Container-Optimized OS）环境，以下是导致配置失效的核心原因：

• 未重启Docker服务：修改/etc/docker/daemon.json后，必须重启Docker daemon才能加载新配置。COS中可执行systemctl restart docker完成重启，若仅修改配置未执行此操作，旧配置会持续生效。
• JSON语法错误：daemon.json要求严格的JSON格式，缺失逗号、引号不匹配、键名错误等都会导致Docker忽略整个配置文件。例如正确的日志轮转配置应为：

  {
    "log-driver": "json-file",
    "log-opts": {
      "max-size": "100m",
      "max-file": "3"
    }
  }
  

  可通过docker daemon - reload命令验证配置是否合法，若报错则说明存在语法问题。
• 配置被启动参数覆盖：若COS的Docker systemd服务文件（/lib/systemd/system/docker.service）中包含--log-opt类启动参数，这些参数会优先于daemon.json中的配置。可通过systemctl cat docker.service查看是否存在此类覆盖项。
• 仅对新容器生效：daemon.json的日志配置只作用于修改后创建的容器，已运行的旧容器不会自动应用新规则。若你的容器是修改配置前启动的，自然不会触发日志轮转。

二、COS环境下限制Docker日志存储的合理方法 #

结合COS的只读系统特性与GCP生态，推荐以下几种可靠方案：

• 修复daemon.json配置并确保生效
  1. 检查配置文件语法，确保格式正确；
  2. 执行systemctl daemon-reload && systemctl restart docker重启服务；
  3. 通过docker info | grep -A 5 Logging验证配置是否加载成功，确认Logging Driver为json-file且对应Options包含设置的max-size和max-file；
  4. 重新创建所有容器，使新配置生效。
• 在容器启动命令中显式指定日志参数
  像你测试的那样，在docker run中添加--log-opt max-size=10m --log-opt max-file=5，这种方式优先级最高，可作为daemon配置失效时的兜底方案。若通过systemd脚本启动容器，可将这些参数固化到脚本中。
• 使用GCP Cloud Logging驱动
  利用COS与GCP的原生集成，将Docker日志直接发送到Cloud Logging，无需在本地存储大量日志。配置方法为在daemon.json中设置：

  {
    "log-driver": "gcplogs"
  }
  

  此方式会自动将容器日志上传到GCP云端，本地仅保留少量缓存，彻底避免磁盘被日志占满的问题。
• 定期清理日志（临时应急方案）
  若需快速清理现有日志，可执行：

  # 清理所有容器日志
  find /var/lib/docker/containers -name "*.log" -type f -exec truncate -s 0 {} \;
  

  或通过docker system prune -f --volumes清理未使用的容器、镜像及日志，但此方法仅为临时手段，无法替代持久化的日志轮转配置。

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