前后台混合环境下Docker Compose YML配置及客户端容器运行问题解决

问题根源 #

你的客户端容器（pyonol8）里的Python脚本是一次性任务：执行完INSERT操作就会退出，而docker compose up -d是后台启动模式，脚本执行完毕进程终止，容器自然就停了。另外，客户端容器还得等PostgreSQL服务完全就绪再跑脚本，不然容易连接失败。

适配需求的配置文件 #

下面是能解决问题的docker-compose.yml，你记得把占位符（比如数据库账号、脚本路径）换成自己的实际信息：

version: '3.8'

services:
  pg13:
    image: pg13ondeb
    container_name: pg13-service
    environment:
      # 按你的PostgreSQL镜像要求填环境变量，示例如下：
      POSTGRES_USER: your_db_user
      POSTGRES_PASSWORD: your_db_password
      POSTGRES_DB: your_target_db
    volumes:
      # 可选：持久化数据库数据，避免容器删了数据丢了
      - pg_data:/var/lib/postgresql/data
    networks:
      - pg-network
    restart: always  # 让数据库服务一直保持运行

  client1:
    image: pyonol8
    container_name: pg-client-1
    depends_on:
      - pg13
    # 先等数据库就绪再执行脚本，防止连接失败
    command: >
      sh -c "
        until pg_isready -h pg13 -U your_db_user; do
          sleep 2
        done
        python /path/to/your/script.py
      "
    environment:
      # 给Python脚本传数据库连接参数，示例如下：
      DB_HOST: pg13
      DB_USER: your_db_user
      DB_PASSWORD: your_db_password
      DB_NAME: your_target_db
    networks:
      - pg-network
    restart: "no"  # 脚本是一次性任务，跑完退出不用自动重启

  client2:
    image: pyonol8
    container_name: pg-client-2
    depends_on:
      - pg13
    command: >
      sh -c "
        until pg_isready -h pg13 -U your_db_user; do
          sleep 2
        done
        python /path/to/your/script.py
      "
    environment:
      DB_HOST: pg13
      DB_USER: your_db_user
      DB_PASSWORD: your_db_password
      DB_NAME: your_target_db
    networks:
      - pg-network
    restart: "no"

volumes:
  pg_data:

networks:
  pg-network:
    driver: bridge

关键配置说明 #

• 数据库就绪等待：depends_on只能保证pg13容器先启动，但不保证数据库服务能连。用pg_isready轮询检测，直到数据库可以连接再执行脚本，避免脚本跑早了连不上库。
• 客户端命令逻辑：通过sh -c把等待命令和脚本执行命令拼在一起，确保脚本在合适的时机运行。
• 重启策略：客户端是一次性任务，跑完就退出，所以设restart: "no"。如果需要脚本定时重复执行，可以把命令改成循环（比如while true; do python script.py; sleep 3600; done），同时把重启策略改成restart: always。
• 网络配置：自定义桥接网络让容器之间能通过服务名（pg13）互相访问，不用把数据库端口暴露给宿主机，更安全。

执行与验证步骤 #

1. 把配置文件里的占位符替换成实际内容，保存为docker-compose.yml。
2. 启动服务：

   docker compose up -d
   

3. 查看客户端容器的执行日志，确认脚本运行成功：

   docker logs pg-client-1
   docker logs pg-client-2
   

4. 看容器状态：pg13会一直运行，客户端容器跑完脚本后会处于exited状态，这是一次性任务的正常表现。

如果你的客户端脚本是常驻服务（需要一直运行），得修改脚本让它保持进程活跃（比如加个无限循环），或者调整命令让进程不退出。

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