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 | 策略 | 运行前拉取镜像(“always”|“missing”|“never”) |
--quiet-build | 抑制构建输出 | |
--quiet-pull | 不打印进度信息进行拉取 | |
--remove-orphans | 移除 Compose 文件中未定义的服务容器 | |
-V, --renew-anon-volumes | 重新创建匿名卷,而不是从以前的容器中检索数据 | |
--scale | 将服务缩放到 NUM 实例。如果 Compose 文件中存在,则覆盖 scale 设置。 | |
-t, --timeout | 当附加或容器已运行时,使用此超时秒数进行容器关闭 | |
--timestamps | 显示时间戳 | |
--wait | 等待服务运行|健康。隐含分离模式。 | |
--wait-timeout | 等待项目运行|健康的最大持续时间(秒) | |
-w, --watch | 监视源代码并在文件更新时重新构建/刷新容器。 | |
-y, --yes | 对所有提示假定“是”并以非交互模式运行 |