# docker compose up

## 描述

* 构建 (build)、（重新）创建 (re-create)、启动 (start) 并 **附加** (attach) 服务对应的容器。
* 如果某些服务还没有运行，它也会启动与之关联 (linked) 的服务。
* `docker compose up` 会聚合 (aggregate) 各个容器的输出，就像使用 `docker compose logs --follow`。
* 命令退出时（如果不是后台模式，未使用 `--detach`），所有容器都会停止。
* 如果使用 `--detach`（或 `-d`），容器将在后台运行 (detached 模式)，命令结束后它们仍然保持运行。
* 如果某个服务已经有对应的容器，并且在创建之后服务的配置或镜像 (image) 改变了，`docker compose up` 会停止并重新创建这些容器。但它会保留挂载 (mount) 的卷 (volumes)。
* 如果你不想让 Compose 重新创建已经存在的容器，可以使用 `--no-recreate`。
* 如果你想 **强制** 停止并重新创建所有容器（即使配置或镜像没有变更），可以使用 `--force-recreate`。
* 如果执行过程中出现错误，命令会返回退出码 (exit code) `1`。
* 如果使用 `SIGINT` (例如 Ctrl + C) 或 `SIGTERM` 中断进程，所有容器将停止，并且退出码为 `0`。

## 选项

下面是 `docker compose up` 支持的主要命令行选项及其含义 (根据文档整理)：

| 选项                             | 默认 / 说明               | 描述                                                                           |
| ------------------------------ | --------------------- | ---------------------------------------------------------------------------- |
| `--abort-on-container-exit`    | —                     | 如果 **任何** 容器停止 (exit)，则停止所有容器。这个选项与 `-d` (detach) 不兼容。                       |
| `--abort-on-container-failure` | —                     | 如果有容器 **失败退出**（退出码非零），就停止所有容器。与 `-d` 冲突。                                     |
| `--always-recreate-deps`       | —                     | 总是重新创建依赖 (dependency) 容器。与 `--no-recreate` 不兼容。                              |
| `--attach [SERVICE …]`         | —                     | 限定只附加 (attach) 指定服务 (service) 的日志/输出。                                        |
| `--attach-dependencies`        | —                     | 自动附加 (attach) 指定服务所依赖 (linked) 的其他服务容器的日志输出。                                 |
| `--build`                      | —                     | 在启动容器之前构建镜像 (如果需要的话)。                                                        |
| `-d, --detach`                 | —                     | 后台运行 (detached 模式) — 容器启动后命令立即返回。                                            |
| `--exit-code-from SERVICE`     | —                     | 返回指定服务容器的退出码 (exit code)。使用此选项隐含 `--abort-on-container-exit`。                |
| `--force-recreate`             | —                     | 强制重新创建容器，即使它们的配置或镜像没有变化。                                                     |
| `--menu`                       | —                     | 启用交互式快捷菜单 (interactive menu)；与 `--detach` 不兼容。 (也可以通过环境变量 `COMPOSE_MENU` 控制) |
| `--no-attach`                  | —                     | 不附加 (attach) 到任何服务容器的日志/输出。                                                  |
| `--no-build`                   | —                     | 不构建镜像（即使本地没有镜像也不 build）。                                                     |
| `--no-color`                   | —                     | 输出为单色 (无 ANSI 颜色)，禁用彩色提示。                                                    |
| `--no-deps`                    | —                     | 不启动服务所依赖 (linked) 的其他服务。                                                     |
| `--no-log-prefix`              | —                     | 日志行中不打印前缀 (log prefix)。                                                      |
| `--no-recreate`                | —                     | 如果容器已存在，则不重新创建它们。与 `--force-recreate` 冲突。                                    |
| `--no-start`                   | —                     | 创建服务 (容器) 但不启动它们。                                                            |
| `--pull <policy>`              | —                     | 在启动前拉取镜像 (pull)，策略可以是 `"always"`、`"missing"`、`"never"`。                      |
| `--quiet-pull`                 | —                     | 拉取镜像时不打印拉取 (pull) 进度。                                                        |
| `--remove-orphans`             | —                     | 移除 (删除) Compose 文件中 **未定义** 但仍在运行 (orphan) 的容器。                              |
| `-V, --renew-anon-volumes`     | —                     | 对匿名卷 (anonymous volumes) 重新创建 (不使用旧容器里的匿名卷)。                                 |
| `--scale SERVICE=NUM`          | —                     | 将某个服务实例扩展 (scale) 到指定数量。如果指定了 scale，会覆盖 Compose 文件中对应服务的 scale 设置。           |
| `-t, --timeout TIMEOUT`        | 默认值约为 **10 秒** (取决版本) | 停止容器时，等待信号 (SIGTERM) 的超时时间 (以秒为单位)。                                          |
| `--timestamps`                 | —                     | 在日志输出中显示时间戳 (timestamp)。                                                     |
| `--wait`                       | —                     | 等待服务 **运行或者健康 (health)**。该选项会在后台 (隐含 detach) 模式下运行。                          |
| `--wait-timeout`               | —                     | 等待服务变为运行 / 健康的最大时间 (以秒为单位)。                                                  |
| `-w, --watch`                  | —                     | 监视 (watch) 源代码 (或文件)，如果文件发生更改，就重新构建 / 刷新容器。                                  |