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-pull | 拉取镜像而不打印进度信息。 | |
--remove-orphans | 删除 Compose 文件中未定义的服务的容器。 | |
-V, --renew-anon-volumes | 重新创建匿名卷,而不是从之前的容器中检索数据。 | |
--scale | 将 SERVICE 扩展到 NUM 个实例。如果存在,则覆盖 Compose 文件中的 scale 设置。 | |
-t, --timeout | 在连接时或容器已运行时,使用此超时(以秒为单位)关闭容器。 | |
--timestamps | 显示时间戳。 | |
--wait | 等待服务运行|健康。暗示分离模式。 | |
--wait-timeout | 等待项目运行|健康的最大持续时间(以秒为单位)。 | |
-w, --watch | 监视源代码,并在文件更新时重新构建/刷新容器。 |