Docker Compose 精选示例：快速开始多容器应用程序

摘要

本文提供了一组精心策划的 Docker Compose 配置文件示例列表，旨在帮助用户快速掌握如何使用 Docker Compose 定义和运行多容器的应用程序。这些示例覆盖了多种应用场景，为初学者和有经验的开发者提供了宝贵的起点。

关键词

Docker Compose, 配置文件, 多容器, 应用程序, 示例列表

一、Docker Compose 简介

1.1 什么是 Docker Compose

Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具。它允许用户在一个 YAML 文件中定义整个应用程序的环境，包括服务、网络和卷等组件。通过这种方式，用户可以轻松地创建复杂的应用程序架构，而无需单独配置每个容器。Docker Compose 通过一个简单的命令即可启动或停止整个应用程序环境，极大地简化了开发流程并提高了效率。

1.2 Docker Compose 的优点

Docker Compose 提供了一系列显著的优点，使其成为开发者构建和部署多容器应用程序时的首选工具：

1. 简化配置 ：通过使用单一的 YAML 配置文件来描述整个应用程序环境，Docker Compose 大大简化了配置过程。这使得开发者能够更轻松地管理多个服务之间的依赖关系，同时保持代码库的整洁和可维护性。
2. 一键式操作 ：Docker Compose 支持使用简单的命令来启动、停止或重建整个应用程序环境。这意味着开发者可以快速地在本地环境中搭建起完整的应用程序栈，极大地提升了开发效率。
3. 易于扩展 ：随着项目规模的增长，Docker Compose 的灵活性使得添加新的服务或调整现有服务变得非常简单。无论是增加数据库实例还是引入缓存层，都可以通过修改配置文件来实现，无需手动调整每个容器。
4. 一致的开发环境 ：通过 Docker Compose 定义的应用程序环境可以在不同的开发环境中保持一致，无论是在本地机器上还是在生产服务器上。这种一致性有助于减少“在我的机器上可以运行”的问题，并确保所有团队成员都在相同的条件下工作。
5. 社区支持 ：由于 Docker Compose 是 Docker 生态系统的一部分，因此拥有庞大的社区支持。这意味着当遇到问题时，开发者可以轻松找到解决方案或求助于其他用户的实践经验。

综上所述，Docker Compose 不仅简化了多容器应用程序的开发和部署流程，还通过其强大的功能和广泛的社区支持，成为了现代软件开发不可或缺的工具之一。

二、配置文件基础知识

2.1 基本配置文件结构

Docker Compose 使用 YAML 格式的配置文件来定义应用程序的服务、网络和卷。下面是一个基本的 Docker Compose 配置文件结构示例，展示了如何定义一个包含 Web 服务和数据库服务的应用程序环境：

version: '3'
services:
    image: nginx:latest
    ports:
      - "80:80"
    networks:
      - app-network
    image: postgres:latest
    environment:
      POSTGRES_USER: example
      POSTGRES_PASSWORD: example
    volumes:
      - db-data:/var/lib/postgresql/data
    networks:
      - app-network
networks:
  app-network:
volumes:
  db-data:

• version : 指定 Docker Compose 文件的版本。这里使用的是 '3' ，这是当前广泛使用的版本。
• services : 定义应用程序中的服务。在这个例子中，我们定义了两个服务： web 和 db 。
  • image : 指定服务所基于的 Docker 镜像。例如，Web 服务使用的是最新的 Nginx 镜像，数据库服务使用的是最新的 PostgreSQL 镜像。
  • ports : 映射容器内的端口到宿主机上的端口。这里将 Web 服务的容器内端口 80 映射到宿主机的端口 80。
  • environment : 设置服务的环境变量。对于数据库服务，我们设置了用户名和密码。
  • volumes : 定义数据卷，用于持久化数据。这里为数据库服务定义了一个名为 db-data 的数据卷。
• networks : 定义网络。在这个例子中，我们定义了一个名为 app-network 的网络，用于连接 Web 服务和数据库服务。
• volumes : 定义数据卷。这里定义了一个名为 db-data 的数据卷，用于存储数据库的数据。

2.2 常见配置文件示例

接下来，我们将通过几个具体的示例来进一步说明 Docker Compose 配置文件的使用方法。

示例 1: 包含 Web 服务和 Redis 缓存服务的应用程序

version: '3'
services:
    build: .
    command: python app.py
    ports:
      - "5000:5000"
    depends_on:
      - redis
    networks:
      - app-network
  redis:
    image: redis:alpine
    networks:
      - app-network
networks:
  app-network:

• build : 指定构建服务的 Dockerfile 路径。这里假设 Web 服务有一个位于当前目录下的 Dockerfile。
• command : 指定容器启动后执行的命令。这里 Web 服务启动后会运行 python app.py 。
• depends_on : 指定服务的依赖关系。Web 服务依赖于 Redis 服务。

示例 2: 包含多个数据库实例的应用程序

version: '3'
services:
    image: nginx:latest
    ports:
      - "80:80"
    networks:
      - app-network
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db1-data:/var/lib/mysql
    networks:
      - app-network
    image: postgres:latest
    environment:
      POSTGRES_USER: example
      POSTGRES_PASSWORD: example
    volumes:
      - db2-data:/var/lib/postgresql/data
    networks:
      - app-network
networks:
  app-network:
volumes:
  db1-data:
  db2-data:

• db1 和 db2 : 这里定义了两个数据库服务，分别使用 MySQL 和 PostgreSQL 镜像。
• MYSQL_ROOT_PASSWORD 和 POSTGRES_USER / POSTGRES_PASSWORD : 设置数据库的登录凭据。
• volumes : 分别为两个数据库服务定义了数据卷，用于持久化数据。

这些示例展示了 Docker Compose 在不同场景下的应用方式，可以帮助用户更好地理解和使用 Docker Compose 来构建和运行多容器的应用程序。

三、多容器应用程序示例

3.1 Web 应用程序示例

在这一节中，我们将探讨几个具体的 Web 应用程序示例，这些示例展示了如何使用 Docker Compose 来定义和运行包含 Web 服务及其相关组件（如数据库和缓存服务）的应用程序环境。

示例 3: 包含 Web 服务、数据库和缓存服务的应用程序

version: '3'
services:
    build: .
    command: python app.py
    ports:
      - "5000:5000"
    depends_on:
      - cache
    networks:
      - app-network
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db-data:/var/lib/mysql
    networks:
      - app-network
  cache:
    image: redis:alpine
    networks:
      - app-network
networks:
  app-network:
volumes:
  db-data:

• web : 定义了一个 Web 服务，该服务基于当前目录下的 Dockerfile 构建，并在启动时运行 python app.py 。此外，它依赖于 db 和 cache 服务。
• db : 定义了一个 MySQL 数据库服务，设置 MYSQL_ROOT_PASSWORD 为 example 并使用一个名为 db-data 的数据卷来持久化数据。
• cache : 定义了一个 Redis 缓存服务。

这个示例展示了如何在一个配置文件中定义一个完整的 Web 应用程序环境，包括 Web 服务、数据库和缓存服务。通过这种方式，开发者可以轻松地在本地环境中搭建起一个完整的应用程序栈，从而加快开发速度并确保环境的一致性。

示例 4: 包含负载均衡器的 Web 应用程序

version: '3'
services:
  web1:
    build: .
    command: python app.py
    networks:
      - app-network
  web2:
    build: .
    command: python app.py
    networks:
      - app-network
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - web1
      - web2
    networks:
      - app-network
networks:
  app-network:

• web1 和 web2 : 定义了两个相同的 Web 服务实例，它们都基于当前目录下的 Dockerfile 构建，并在启动时运行 python app.py 。
• lb : 定义了一个 Nginx 负载均衡器服务，它将流量分发到 web1 和 web2 。通过自定义的 nginx.conf 文件配置负载均衡策略。

此示例展示了如何使用 Docker Compose 来定义一个包含负载均衡器的 Web 应用程序环境。通过这种方式，可以轻松地实现高可用性和横向扩展，这对于处理大量并发请求的应用程序来说至关重要。

3.2 数据库应用程序示例

接下来，我们将通过几个具体的示例来展示如何使用 Docker Compose 来定义和运行包含多个数据库实例的应用程序环境。

示例 5: 包含主从复制的 MySQL 数据库

version: '3'
services:
  master:
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db-master-data:/var/lib/mysql
    networks:
      - app-network
  slave:
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_MASTER_HOST: master
      MYSQL_MASTER_PORT: 3306
      MYSQL_MASTER_USER: root
      MYSQL_MASTER_PASSWORD: example
    volumes:
      - db-slave-data:/var/lib/mysql
    networks:
      - app-network
networks:
  app-network:
volumes:
  db-master-data:
  db-slave-data:

• master : 定义了一个 MySQL 主数据库服务，设置 MYSQL_ROOT_PASSWORD 为 example 并使用一个名为 db-master-data 的数据卷来持久化数据。
• slave : 定义了一个 MySQL 从数据库服务，它通过环境变量配置与主数据库建立复制关系。 MYSQL_MASTER_HOST 和 MYSQL_MASTER_PORT 指定了主数据库的地址和端口，而 MYSQL_MASTER_USER 和 MYSQL_MASTER_PASSWORD 则指定了登录凭据。

这个示例展示了如何使用 Docker Compose 来定义一个包含主从复制的 MySQL 数据库环境。通过这种方式，可以轻松地实现数据冗余和读写分离，从而提高数据的安全性和应用程序的性能。

示例 6: 包含多个数据库实例的应用程序

version: '3'
services:
    image: nginx:latest
    ports:
      - "80:80"
    networks:
      - app-network
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db1-data:/var/lib/mysql
    networks:
      - app-network
    image: postgres:latest
    environment:
      POSTGRES_USER: example
      POSTGRES_PASSWORD: example
    volumes:
      - db2-data:/var/lib/postgresql/data
    networks:
      - app-network
networks:
  app-network:
volumes:
  db1-data:
  db2-data:

• db1 : 定义了一个 MySQL 数据库服务，设置 MYSQL_ROOT_PASSWORD 为 example 并使用一个名为 db1-data 的数据卷来持久化数据。
• db2 : 定义了一个 PostgreSQL 数据库服务，设置 POSTGRES_USER 和 POSTGRES_PASSWORD 为 example 并使用一个名为 db2-data 的数据卷来持久化数据。

这个示例展示了如何在一个配置文件中定义包含多个数据库实例的应用程序环境。通过这种方式，可以轻松地在同一个应用程序环境中集成多种类型的数据库服务，从而满足不同的业务需求。

四、高级配置文件技巧

4.1 高级配置文件示例

在这一节中，我们将深入探讨一些高级的 Docker Compose 配置文件示例，这些示例涵盖了更复杂的场景，旨在帮助用户充分利用 Docker Compose 的强大功能。

示例 7: 包含外部服务的应用程序

version: '3'
services:
    build: .
    command: python app.py
    ports:
      - "5000:5000"
    depends_on:
      - external-db
    networks:
      - app-network
  external-db:
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db-data:/var/lib/mysql
    networks:
      - app-network
networks:
  app-network:
volumes:
  db-data:

• external-db : 定义了一个外部数据库服务，它不直接作为应用程序的一部分，而是作为一个独立的服务被引用。这在需要与现有基础设施集成的情况下非常有用。
• depends_on : web 服务依赖于 external-db 服务，确保数据库服务在 Web 服务启动之前已经准备好。

这个示例展示了如何在 Docker Compose 配置文件中定义外部服务，并将其与应用程序服务关联起来。通过这种方式，可以轻松地集成现有的服务或基础设施，而无需重新构建整个应用程序环境。

示例 8: 包含自定义构建步骤的应用程序

version: '3'
services:
    build:
      context: .
      dockerfile: Dockerfile.prod
      args:
        - ENV=production
      target: final
    command: python app.py
    ports:
      - "5000:5000"
    networks:
      - app-network
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db-data:/var/lib/mysql
    networks:
      - app-network
networks:
  app-network:
volumes:
  db-data:

• context : 指定构建上下文的路径。这里使用当前目录作为构建上下文。
• dockerfile : 指定用于构建服务的 Dockerfile 路径。这里使用的是 Dockerfile.prod ，这意味着可以根据不同的环境使用不同的 Dockerfile。
• args : 传递构建参数。这里设置了一个名为 ENV 的构建参数，值为 production 。
• target : 指定 Dockerfile 中的构建阶段。这里设置为 final ，意味着只构建 Dockerfile 中指定为 final 的阶段。

这个示例展示了如何在 Docker Compose 配置文件中定义自定义的构建步骤，这对于根据不同的环境需求构建不同的镜像非常有用。通过这种方式，可以确保应用程序在不同的环境中使用正确的配置和优化。

4.2 自定义网络和卷

Docker Compose 允许用户定义自定义网络和卷，以便更好地控制应用程序环境中的资源分配和数据持久化。

示例 9: 定义自定义网络

version: '3'
services:
    image: nginx:latest
    ports:
      - "80:80"
    networks:
      - frontend
      - backend
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db-data:/var/lib/mysql
    networks:
      - backend
networks:
  frontend:
    driver: bridge
  backend:
    driver: bridge
volumes:
  db-data:

• frontend 和 backend : 定义了两个自定义网络，分别为前端服务和后端服务提供通信通道。
• driver : 指定网络驱动类型。这里使用的是 bridge 类型，这是最常见的网络驱动类型。

这个示例展示了如何在 Docker Compose 配置文件中定义自定义网络，以实现更细粒度的网络隔离和通信控制。通过这种方式，可以更好地组织和管理应用程序中的服务通信。

示例 10: 定义自定义卷

version: '3'
services:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - static-data:/usr/share/nginx/html
    networks:
      - app-network
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db-data:/var/lib/mysql
    networks:
      - app-network
networks: