Compose 的工作原理

使用 Docker Compose，您可以使用一个 YAML 配置文件（称为Compose 文件）来配置应用程序的服务，然后使用Compose CLI从配置中创建并启动所有服务。

Compose 文件或 `compose.yaml` 文件遵循Compose 规范中定义多容器应用程序的规则。这是 Compose 规范的 Docker Compose 实现。

Compose 文件

Compose 文件的默认路径是工作目录中的 `compose.yaml`（首选）或 `compose.yml`。Compose 还支持 `docker-compose.yaml` 和 `docker-compose.yml` 以实现早期版本的向后兼容性。如果两个文件都存在，Compose 会优先使用规范的 `compose.yaml`。

您可以使用片段和扩展来使您的 Compose 文件高效且易于维护。

多个 Compose 文件可以合并在一起以定义应用程序模型。YAML 文件的组合是通过根据您设置的 Compose 文件顺序追加或覆盖 YAML 元素来实现的。简单属性和映射会被优先级最高的 Compose 文件覆盖，列表则通过追加合并。当合并的补充文件托管在其他文件夹中时，相对路径将根据第一个 Compose 文件的父文件夹解析。由于某些 Compose 文件元素可以表示为单个字符串或复杂对象，因此合并适用于扩展形式。有关更多信息，请参阅使用多个 Compose 文件。

如果您想重用其他 Compose 文件，或将应用程序模型的一部分分解到单独的 Compose 文件中，您还可以使用`include`。如果您的 Compose 应用程序依赖于由不同团队管理的其他应用程序，或者需要与他人共享，这将非常有用。

命令行界面

Docker CLI 允许您通过 `docker compose` 命令及其子命令与 Docker Compose 应用程序进行交互。如果您正在使用 Docker Desktop，Docker Compose CLI 默认包含在内。

使用 CLI，您可以管理 `compose.yaml` 文件中定义的多容器应用程序的生命周期。CLI 命令使您能够轻松启动、停止和配置应用程序。

主要命令

要启动 `compose.yaml` 文件中定义的所有服务

$ docker compose up

停止并移除正在运行的服务

$ docker compose down 

如果您想监控正在运行的容器的输出并调试问题，可以使用以下命令查看日志

$ docker compose logs

列出所有服务及其当前状态

$ docker compose ps

有关所有 Compose CLI 命令的完整列表，请参阅参考文档。

示例说明

以下示例说明了上述 Compose 概念。该示例不具有规范性。

考虑一个分为前端 Web 应用程序和后端服务的应用程序。

前端在运行时使用基础设施管理的 HTTP 配置文件进行配置，该配置文件提供外部域名，以及平台安全密钥存储注入的 HTTPS 服务器证书。

后端将数据存储在持久卷中。

两个服务通过隔离的后端网络相互通信，而前端也连接到前端网络并暴露端口 443 供外部使用。

示例应用程序由以下部分组成

• 两个服务，由 Docker 镜像支持：`webapp` 和 `database`
• 一个秘密（HTTPS 证书），注入到前端
• 一个配置（HTTP），注入到前端
• 一个持久卷，附加到后端
• 两个网络

services:
  frontend:
    image: example/webapp
    ports:
      - "443:8043"
    networks:
      - front-tier
      - back-tier
    configs:
      - httpd-config
    secrets:
      - server-certificate

  backend:
    image: example/database
    volumes:
      - db-data:/etc/data
    networks:
      - back-tier

volumes:
  db-data:
    driver: flocker
    driver_opts:
      size: "10GiB"

configs:
  httpd-config:
    external: true

secrets:
  server-certificate:
    external: true

networks:
  # The presence of these objects is sufficient to define them
  front-tier: {}
  back-tier: {}

`docker compose up` 命令启动 `frontend` 和 `backend` 服务，创建必要的网络和卷，并将配置和秘密注入到 `frontend` 服务中。

`docker compose ps` 提供了服务当前状态的快照，可以轻松查看哪些容器正在运行、它们的状态以及它们正在使用的端口

$ docker compose ps

NAME                IMAGE                COMMAND                  SERVICE             CREATED             STATUS              PORTS
example-frontend-1  example/webapp       "nginx -g 'daemon of…"   frontend            2 minutes ago       Up 2 minutes        0.0.0.0:443->8043/tcp
example-backend-1   example/database     "docker-entrypoint.s…"   backend             2 minutes ago       Up 2 minutes

接下来做什么

• 尝试快速入门指南
• 探索一些示例应用程序
• 熟悉 Compose 规范