docker compose up
| 描述 | 创建并启动容器 |
|---|---|
| 用法 | docker compose up [OPTIONS] [SERVICE...] |
描述
为服务构建、(重新)创建、启动并附加到容器。
除非它们已经在运行,否则此命令也会启动任何链接的服务。
docker compose up 命令聚合每个容器的输出(类似于 docker compose logs --follow)。
可以选择使用 --attach 标志选择要附加的服务子集,或者使用 --no-attach 排除某些服务,
以防止输出被某些冗长的服务淹没。
当命令退出时,所有容器都会停止。运行 docker compose up --detach 会在后台启动容器并使其保持运行状态。
如果服务存在现有容器,并且在容器创建后服务的配置或镜像发生了更改,docker compose up 会通过停止并重新创建容器来应用这些更改(保留挂载的卷)。若要防止 Compose 应用更改,请使用 --no-recreate 标志。
如果你想强制 Compose 停止并重新创建所有容器,请使用 --force-recreate 标志。
如果进程遇到错误,此命令的退出代码为 1。
如果进程被 SIGINT (ctrl + C) 或 SIGTERM 中断,容器将停止,退出代码为 0。
选项
| 选项 | 默认 | 描述 |
|---|---|---|
--abort-on-container-exit | 如果任何容器被停止,则停止所有容器。与 -d 不兼容 | |
--abort-on-container-failure | 如果任何容器因故障退出,则停止所有容器。与 -d 不兼容 | |
--always-recreate-deps | 重新创建依赖容器。与 --no-recreate 不兼容。 | |
--attach | 限制附加到指定的服务。与 --attach-dependencies 不兼容。 | |
--attach-dependencies | 自动附加到依赖服务的日志输出 | |
--build | 在启动容器之前构建镜像 | |
-d, --detach | 分离模式:在后台运行容器 | |
--exit-code-from | 返回所选服务容器的退出代码。隐含 --abort-on-container-exit | |
--force-recreate | 即使容器的配置和镜像未发生更改,也重新创建容器 | |
--menu | 在以附加模式运行时启用交互式快捷键。与 --detach 不兼容。也可以通过设置 COMPOSE_MENU 环境变量来启用/禁用。 | |
--no-attach | 不要附加(流式日志)到指定服务 | |
--no-build | 不要构建镜像,即使这是策略 | |
--no-color | 生成单色输出 | |
--no-deps | 不要启动链接服务 | |
--no-log-prefix | 不在日志中打印前缀 | |
--no-recreate | 如果容器已经存在,不要重新创建它们。与 --force-recreate 不兼容。 | |
--no-start | 创建服务后不要启动它们 | |
--pull | policy | 运行前拉取镜像 ("always"|"missing"|"never") |
--quiet-pull | 拉取而不显示进度信息 | |
--remove-orphans | 移除 Compose 文件中未定义的服务容器 | |
-V, --renew-anon-volumes | 重新创建匿名卷,而不是从之前的容器中检索数据 | |
--scale | 将 SERVICE 扩展至 NUM 个实例。覆盖scale如果存在,则在 Compose 文件中进行设置。 | |
-t, --timeout | 在连接时或容器已在运行时,使用此超时时间(秒)进行容器关闭 | |
--timestamps | 显示时间戳 | |
--wait | 等待服务运行或处于健康状态。隐含了分离模式。 | |
--wait-timeout | 等待项目处于运行|健康状态的最长持续时间(秒) | |
-w, --watch | 监视源代码并在文件更新时重新构建/刷新容器。 |