Docker Compose 是什么，为什么要使用它？

Question

Accepted Answer

**Docker Compose** 是一个工具，用于使用单个 YAML 文件定义和运行**多容器应用程序**。与其手动运行多个 `docker run` 命令，不如在 `docker-compose.yml` 中描述所有服务（app、database、cache），然后用一个命令将它们全部启动。

## Compose 解决的问题

```text
A real app often has MULTIPLE containers: a web app + a database + a cache + ...
  → manually running each with docker run (ports, networks, volumes, env, dependencies)
    is tedious, error-prone, and hard to reproduce/share
→ Compose defines the WHOLE stack in one file → start it all with one command.
```

## 一个 docker-compose.yml

```yaml
services:
  web:
    build: .                    # build from the local Dockerfile
    ports:
      - "3000:3000"             # map ports
    environment:
      - DATABASE_URL=postgres://db:5432/myapp
    depends_on:
      - db                       # start db before web
  db:
    image: postgres:16           # use a prebuilt image
    environment:
      - POSTGRES_PASSWORD=secret
    volumes:
      - dbdata:/var/lib/postgresql/data   # persist the database
volumes:
  dbdata:
```

一个文件定义了所有服务、它们的 images/builds、ports、environment、volumes 和依赖关系——它们共享一个网络（可以通过服务名称相互通信，例如 `db`）。

## 运行堆栈

```bash
docker compose up -d        # build and start ALL services (in the background)
docker compose ps           # list the running services
docker compose logs -f      # view logs from all services
docker compose down         # stop and remove everything
docker compose down -v      # also remove volumes
```

## 为什么这很重要

理解 Docker Compose 是有价值的，因为真实的应用程序几乎总是涉及**多个容器**，而 Compose 是管理它们的标准工具，因此这是重要的实践知识。

Compose 解决的问题是真实存在的：典型的应用程序有多个服务（一个 web 应用、一个数据库、一个缓存，也许还有一个消息队列），手动运行每个服务并使用单独的 `docker run` 命令——配置 ports、networks、volumes、environment 变量和启动顺序——既繁琐又容易出错，难以重现或共享。**Compose** 通过**在一个声明式 YAML 文件中定义整个多容器堆栈**并用单个命令启动所有服务（`docker compose up`）来解决这个问题，使多容器应用程序易于运行、重现和共享。

理解 `docker-compose.yml` 的结构（使用 images/builds、ports、environment、volumes 和依赖关系定义服务，服务会自动联网并可通过名称访问）以及关键命令（`up`、`down`、`ps`、`logs`）是开发中的实用、日常知识，也是运行多服务应用程序的必备知识。

Compose 对于**本地开发环境**特别有价值（一个命令启动应用及其数据库和依赖项），以及可重现地定义应用程序堆栈。

由于真实应用程序通常是多容器的，而 Docker Compose 是定义和简单运行它们的标准的、广泛使用的工具（用一个声明式文件和命令替代繁琐的手动编排），理解 Docker Compose——它解决的问题、compose 文件结构和命令——是在处理多容器应用程序时频繁应用的、有价值的知识，是任何非平凡的容器化应用程序的必要补充工具，在开发工作流中无处不在。