Docker-Compose跨Django项目复用容器问题及隔离方案咨询

问题描述 #

两个结构相似的Django项目，各自backend目录下包含docker-compose.yml和Dockerfile。切换项目执行docker-compose up时，容器会复用前一个项目的服务，即使指定了container_name也无法解决。需要保留现有项目结构，实现各项目容器独立运行。

核心原因 #

Docker Compose默认以当前工作目录的名称作为项目命名空间。两个项目的工作目录都是backend，导致容器、网络、卷等资源共享同一个命名空间，从而出现复用冲突。

解决方案 #

方案1：执行命令时指定唯一项目名 #

每次运行docker-compose命令时，通过-p（或--project-name）参数指定项目专属名称，强制隔离资源：

• 启动项目1：

  cd project1/backend
  docker-compose -p project1 up -d
  

• 启动项目2：

  cd project2/backend
  docker-compose -p project2 up -d
  

此方式无需修改配置文件，适合临时或按需切换场景。

方案2：在docker-compose.yml中配置全局项目名 #

在每个项目的docker-compose.yml最顶部添加project_name字段，固定项目命名空间，执行命令时无需额外参数：

修改后的项目1 docker-compose.yml

version: '3.9'
project_name: project1  # 指定唯一项目名

services:
  redis:
    image: redis:latest
    ports:
      - "6379:6379"

  postgres:
    image: postgres:12
    container_name: project1_postgres  # 唯一容器名
    environment:
      POSTGRES_PASSWORD: project_name
      POSTGRES_DB: project_name
    env_file:
      - .env
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data/

  celery:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: project1_celery  # 唯一容器名
    command: celery -A project_name worker -l info
    volumes:
      - .:/opt/webapp
    depends_on:
      - redis
      - postgres

  celery-beat:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: project1_celery_beat  # 唯一容器名
    command: celery -A project_name beat -l info
    volumes:
      - .:/opt/webapp
    depends_on:
      - redis
      - postgres

volumes:
  postgres_data:

修改后的项目2 docker-compose.yml

version: "3.9"
project_name: project2  # 指定唯一项目名

services:
  web:
    build:
      context: .
      args:
        SECRET_KEY: ${SECRET_KEY}
    container_name: project2_web  # 唯一容器名
    env_file: .env
    volumes:
      - ./:/opt/webapp
    ports:
      - "8001:8000"  # 修改主机端口避免冲突
    command: >
      sh -c "python3 manage.py runserver 0.0.0.0:8000"

  postgres:
    image: postgres:12
    container_name: project2_postgres  # 唯一容器名
    env_file: .env
    environment:
      POSTGRES_PASSWORD: project_name
    volumes:
      - postgres-data:/var/lib/postgresql/data
    ports:
      - "5433:5432"  # 修改主机端口避免冲突

  redis:
    image: redis:latest
    container_name: project2_redis  # 唯一容器名
    env_file: .env
    ports:
      - "6380:6379"  # 修改主机端口避免冲突

volumes: 
  postgres-data:

额外注意事项 #

1. 容器名全局唯一：Docker的container_name是全局唯一标识，必须确保两个项目的容器名不重复，否则会启动失败。
2. 主机端口冲突：若两个项目映射相同的主机端口（如5432、6379），会导致端口占用错误，需修改其中一个项目的主机端口，或使用动态端口（仅指定容器端口，如- "5432"，Docker会自动分配随机主机端口）。
3. 清理旧资源：若之前已有冲突的容器/卷，需先清理：

   docker-compose down -v  # 停止并删除当前项目的容器、网络、卷
   

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