执行docker-compose up -d启动ansible容器为何以退出码0退出？

问题描述 #

执行 docker-compose up -d 启动容器时，基于自定义CentOS镜像的ansible服务容器启动后立刻以退出码 0 终止，无法保持运行状态。
用户当前使用的配置如下：

1. docker-compose.yml 配置内容

   version: "3"
   services:
     ansible:
       container_name: controller
       image: centos_ansible
       build:
         context: centos_ansible
       networks:
         - net
   
   networks:
     net:
   

2. centos_ansible 构建目录下的Dockerfile内容

   FROM centos
   RUN yum install python3 -y && \
       yum install epel-release -y && \
       yum install ansible -y
   

根因说明 #

这个现象是Docker运行机制的典型表现，并非YAML配置语法错误。
Docker容器的生命周期由容器内PID为1的前台进程完全决定：只要该前台进程执行结束，容器就会立刻终止，此时返回的退出码就是0（进程正常退出的状态）。
当前镜像的构建流程里，安装python3、epel源、ansible的所有操作，都是构建阶段通过RUN指令完成的，容器启动时没有定义任何需要持续运行的前台任务。CentOS官方基础镜像本身没有内置托底的常驻服务，容器启动完成初始化后没有要执行的常驻命令，PID1进程执行完毕直接退出，自然就出现“启动即退出、退出码为0”的现象。

对应解决方案 #

根据你的使用场景选择对应调整方式即可：

• 不想重新构建镜像，临时调整compose配置
  直接在ansible服务的配置块下补充一行启动命令，让容器挂上不会主动退出的前台进程：

  services:
    ansible:
      # 原有配置全部保留
      command: tail -f /dev/null
  

  调整完成后重新执行 docker-compose up -d，容器就会保持运行状态。后续需要操作ansible时，直接通过 docker exec -it controller bash 进入容器，即可使用已经安装好的ansible能力。
• 希望从镜像层面固定启动逻辑，省去每次补compose配置的步骤
  直接修改Dockerfile，在文件末尾补充CMD启动指令：

  FROM centos
  RUN yum install python3 -y && \
      yum install epel-release -y && \
      yum install ansible -y
  # 新增常驻启动指令
  CMD ["tail", "-f", "/dev/null"]
  

  修改完成后执行 docker-compose build 重新构建镜像，再启动容器就不会立刻终止了。

补充提示：如果后续要把这个容器作为长期运行的固定节点，不建议长期用 tail -f /dev/null 这种无实际业务逻辑的空进程做常驻，可以根据实际需求把需要持续运行的同步服务、定时任务进程作为启动指令，避免容器成为无实际运行能力的空壳。

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