如何在Ansible中配置docker run的log-opt限制容器日志大小

我之前也碰到过一模一样的问题！明明在docker run里加--log-opt max-size=xxxm没问题，但放到Ansible里就不生效，后来才发现是配置姿势不对，还有几个容易踩的坑，咱们一步步来解决：

核心问题：容器日志配置是创建时生效的 #

首先要明确：Docker容器的日志驱动配置只能在容器创建时设置，已经运行的容器修改配置不会有任何效果。如果你之前已经部署过容器，必须先删除旧容器，再重新创建带日志限制的新容器。

正确的Ansible配置方式 #

不要在command或者args里直接加--log-opt，Ansible的docker_container模块专门提供了log_options参数来配置日志选项，同时要确保指定正确的日志驱动（默认是json-file，但最好显式指定避免环境差异）。

下面是完整的Playbook示例：

- name: 部署带日志大小限制的应用容器
  hosts: your_target_hosts
  tasks:
    # 第一步：先清理旧容器（如果存在）
    - name: 停止并删除已存在的应用容器
      docker_container:
        name: your_app_container_name
        state: absent

    # 第二步：创建带日志限制的新容器
    - name: 启动应用容器并配置日志限制
      docker_container:
        name: your_app_container_name
        image: your_app_image:latest
        state: started
        # 显式指定日志驱动为json-file（max-size是该驱动的参数）
        log_driver: json-file
        # 配置日志大小和保留数量
        log_options:
          max-size: "100m"  # 单个日志文件最大100MB
          max-file: "3"     # 最多保留3个滚动日志文件（可选，防止磁盘被占满）
        # 以下是你的其他容器配置，根据实际情况调整
        ports:
          - "8080:8080"
        volumes:
          - "/host/path:/container/path"
        restart_policy: always

验证配置是否生效 #

容器创建完成后，你可以通过以下方式确认日志配置是否生效：

1. 查看容器的日志配置详情：

docker inspect your_app_container_name | grep -A 10 LogConfig

输出里应该能看到max-size和max-file的配置值。

2. 去你指定的容器日志目录（/var/lib/docker/containers/2fdcae9fb35f4954639a3ff254873f0ae8518f2ede011807/...）观察日志文件，当达到max-size时，会自动生成新的日志文件，旧的会被滚动压缩。

常见坑点提醒 #

• 不要用旧容器直接更新：如果跳过删除旧容器的步骤，哪怕你修改了日志配置，新配置也不会应用到已运行的容器上。
• 日志驱动不匹配：如果你的容器用了journald或者其他非json-file的日志驱动，max-size参数是不生效的，必须确保log_driver设置为json-file。
• 参数格式错误：log_options是字典格式，不要写成字符串列表，比如不要写成log_options: ["max-size=100m"]，这种写法是错误的。

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