如何组织多个 Dockerfile、docker-compose.yaml 和 .dockerignore

Question

在查看了如何命名 Dockerfiles 的答案后，我仍然有很多问题。

就我而言，我至少需要两个Dockerfiles， adocker-compose.yaml和 a .dockerignore。听起来像是使用诸如<purpose>.Dockerfile或 之类的扩展Dockerfile.<purpose>，其缺点是失去在 hub.docker.com 上使用 autobuilder 的功能。

因此其他人建议您将每个文件保存Dockerfile在一个目录中并从那里构建。

所以也许是这样的：

dockerfiles/
--python_consumer/
-----Dockerfile
--python_producer/
-----Dockerfile
--docker-compose.yaml
--.dockerignore

在这种情况下，.dockerignore 是否可以在全局范围内适用于所有 dockerfile？以这种方式构建有什么大的缺点吗？

我的示例 docker-compose.yaml 没有单独的目录和一个组合的消费者/生产图像作为上下文。

version: '3.8'
services:
  standalone:
    hostname: standalone
    container_name: standalone
    image: apachepulsar/pulsar:2.8.1
    ports:
      - 8080:8080 # exposed would be a better practice
      - 6650:6650 # exposed would be a better practice
    command: bin/pulsar standalone
    healthcheck:
      test: ["CMD", "nc", "-vz", "localhost", "6650"]
      interval: 20s
      timeout: 5s
      retries: 5
    networks:
      - conprod
  conprod:
    hostname: conprod
    container_name: conprod
    build:
      context: .
      dockerfile: ./Dockerfile
    restart: on-failure # best practice is probably "unless-stopped"
    depends_on:
      - standalone
    networks:
      - conprod
networks:
  conprod:

Answer 1

当你构建一个镜像时，你向 Docker 守护进程发送一个构建上下文；在您的 Compose 设置中，这是设置中指定的目录build: { context: }。该.dockerignore文件必须位于该目录中，而不是其他地方。它的实际效果是导致文件从构建上下文中排除，这可以导致更快的构建序列。

构建上下文的另一个重要作用是所有 DockerfileCOPY指令都被认为是相对于该目录的。您不能COPY从父目录或同级目录中。因此，如果文件在项目之间共享，则必须将上下文目录设置为将包含的所有文件的某个祖先目录，并且COPY指令将相对于该目录（即使 Dockerfile 位于每个项目目录中）。另请参阅如何包含 Docker 构建上下文之外的文件？

如果您的项目是完全独立的：也许有一个前端和一个后端项目，或者在您的情况下，生产者和消费者共享消息格式但不共享任何实际代码。那么在这种情况下：

• Dockerfile在每个项目子目录中放置一个准确命名的 Dockerfile
• 每个项目子目录下放一个.dockerignore文件（不能在父目录下）
• COPY指令是相对于项目子目录的

  COPY requirements.txt ./
  

• 在 Compose 文件中，您可以使用简写build: directory语法，因为您有标准（默认）dockerfile:名称

  version: '3.8'
  services:
     producer:
       build: ./python_producer
       environment:
         - RABBITMQ_HOST=rabbitmq
     consumer:
       build: ./python_consumer
       environment:
         - RABBITMQ_HOST=rabbitmq
     rabbitmq:
       image: rabbitmq:3
       hostname: rabbitmq # RabbitMQ is very unusual in needing to set this
  

如果您的项目共享代码或其他文件：在您的示例中，您可能为共享代码中的消息格式定义了 Python 数据结构。在这种情况下：

• Dockerfile在每个项目子目录中放置一个准确命名的 Dockerfile
• 将单个.dockerignore文件放入项目根目录中
• COPY指令是相对于项目根目录的

  COPY python_producer/requirements.txt ./
  

• 在 Compose 文件中，您需要指定context: .并dockerfile:指向每个组件的 Dockerfile

  version: '3.8'
  services:
     producer:
       build:
         context: .
         dockerfile: python_producer/Dockerfile
       environment:
         - RABBITMQ_HOST=rabbitmq
     consumer:
       build:
         context: .
         dockerfile: python_consumer/Dockerfile
       environment:
         - RABBITMQ_HOST=rabbitmq
     rabbitmq:
       image: rabbitmq:3
       hostname: rabbitmq # RabbitMQ is very unusual in needing to set this