GoLand 2025.2 Help

Docker Compose 运行配置

使用此类型的配置可运行多容器 Docker 应用程序。

Docker Compose 运行配置对话框

Docker 使用 docker compose 命令定义、配置并运行多容器应用程序。 用于构建、创建、启动并附加到容器的主要命令是 docker compose up

默认情况下, Docker Compose 配置具有以下选项:

描述

名称(N)

指定一个运行配置名称,以便在编辑或运行时快速将其与其他配置区分开。

允许多个实例(U)

允许并行运行此运行配置的多个实例。

默认情况下,该选项处于禁用状态,当您启动此配置而另一实例仍在运行时,GoLand 会建议停止当前运行的实例并启动新的实例。 当运行配置占用大量资源且没有合理理由运行多个实例时,此选项非常有用。

存储为项目文件(S)

将包含运行配置设置的文件保存下来,以便与其他团队成员共享。 默认位置为 .idea/runConfigurations 。 但是,如果您不想共享 .idea 目录,也可以将配置保存到项目中的其他目录。

默认情况下,该选项处于禁用状态,GoLand 会将运行配置设置保存在 .idea/workspace.xml 中。

服务器

选择要用于运行配置的 Docker 守护进程连接

Compose 文件

指定定义所需服务的 compose 文件。 Docker Compose 按指定顺序构建配置,因此后续文件会覆盖并添加前面文件中相同服务的字段。

这类似于在 docker compose 命令中使用 -f 选项。

服务

指定要构建、创建和启动的服务。

单击 浏览图标 可选择 YML 文件中列出的服务。

docker-compose 浏览图标

执行前(B)

在启动运行配置之前,指定要执行的任务列表。 例如,运行另一个配置、构建所需的构件、运行某个外部工具或 Web 浏览器等。

单击 添加按钮 或按 Alt+Insert 添加一个可用任务。

使用 上移按钮下移按钮 移动列表中的任务,以更改任务执行顺序。 选择任务后,单击 编辑按钮 编辑任务。 单击 移除按钮 从列表中移除所选任务。

显示此页面

在实际启动前显示运行配置设置。

激活工具窗口

根据配置类型,启动该运行配置时将打开 运行调试服务 工具窗口。 如果该选项被禁用,您可以手动打开相应工具窗口:

  • 视图(V)| 工具窗口| 运行Alt+4

  • 视图(V)| 工具窗口| 调试Alt+5

  • 视图(V)| 工具窗口| 服务Alt+8

使用 修改选项(M) 菜单向运行配置添加高级选项:

描述

项目名称

为 Docker Compose 指定一个备用项目名称。 默认情况下,它是当前目录的名称。

这类似于在 docker compose 命令中使用 -p 选项。

环境变量

指定 Docker Compose 环境变量。 这些仅供 Docker Compose 进程使用。 它们不会传递到任何容器中。

环境变量文件

指定定义 Docker Compose 环境变量 的自定义 环境文件 的路径。

这类似于在使用 docker compose 命令时使用 --env-file 选项。

默认情况下, Docker Compose 运行配置会在包含 Docker Compose 文件的目录中查找名为 .env 的文件。

`down` 时移除卷

在停止并删除容器时,同时删除在 Docker Compose 文件中声明的具名卷和附加到容器的匿名卷。

这类似于在使用 docker compose down 命令时使用 -v--volumes 选项。

启用兼容性模式

将 v3 服务定义转换为与 v2 兼容的参数。

这类似于在使用 docker compose 命令时使用 --compatibility 选项。

`down` 时移除镜像

配置在停止并删除容器时应删除哪些镜像。 您可以选择删除用于任意服务的所有镜像,或仅删除未在 image 字段中设置自定义标签的镜像。

这类似于在使用 docker compose down 命令时使用 --rmi 选项。

超时

设置一个以秒为单位的超时,以强制终止无法正常关闭的容器。

Docker 通常会尝试通过 SIGTERM 正常终止任何容器,但可能会导致无限期运行。 设置一个超时时间,超过该时间后 Docker 应发送 SIGKILL 以强制关闭。

这类似于在使用 docker compose up 命令时使用 -t--timeout 选项。

退出代码

返回所选服务容器的退出代码。

每当所选服务中的某个容器停止运行时,返回其退出代码并停止该服务中的所有其他容器。

这类似于在使用 docker compose up 命令时使用 --exit-code-from 选项。

重写扩展

设置每个服务启动的容器数量。

此选项会覆盖 Docker Compose 文件中存在的 scale 参数。

这类似于在使用 docker compose up 命令时使用 --scale 选项。

重新创建依赖项

启动服务时重新创建其依赖的容器。

这类似于在使用 docker compose up 命令时使用 --always-recreate-deps 选项。

重新创建匿名卷

重新创建匿名卷,而不是从先前的容器中检索数据。

这类似于在使用 docker compose up 命令时使用 -V--renew-anon-volumes 选项。

移除孤立项

删除 Docker Compose 文件中未定义的服务对应的容器。

这类似于在使用 docker compose up 命令时使用 --remove-orphans 选项。

启动

配置应启动哪些服务:

  • 所选部署和依赖项 :默认情况下,Docker Compose 会启动所有指定服务及其关联服务。

  • :创建服务后不启动任何服务。 这类似于在使用 docker compose up 命令时使用 --no-start 选项。

  • 所选服务 :不启动任何关联服务。 这类似于在使用 docker compose up 命令时使用 --no-deps 选项。

附加到

配置为哪些容器显示输出流:

  • 所选服务 :默认情况下,Docker Compose 会附加到指定服务的所有已启动容器。

  • :不附加到任何容器。 这类似于在使用 docker compose up 命令时使用 -d--detach 选项。

  • 所选部署和依赖项 :附加到指定服务及其关联服务的容器。 这类似于在使用 docker compose up 命令时使用 --attach-dependencies 选项。

重新创建容器

配置要停止并以新容器替换的容器:

  • 更改的配置 :默认情况下,Docker Compose 仅在配置或镜像发生变化时重新创建容器。

  • 所有 :重新创建服务中的所有容器,即使配置或镜像没有发生变化。 这类似于在使用 docker compose up 命令时使用 --force-recreate 选项。

  • :不重新创建服务中的任何容器,即使配置发生了变化。 这类似于在使用 docker compose up 命令时使用 --no-recreate 选项。

构建

配置在启动容器之前要构建哪些镜像:

  • 仅缺失镜像 :默认情况下,Docker Compose 仅构建不可用的镜像,并在可能时使用已构建的镜像。

  • 从不 :不构建任何镜像。 始终使用之前构建的镜像,如果某些镜像不可用则抛出错误。 这类似于在使用 docker compose up 命令时使用 --no-build 选项。

  • 始终 :在启动容器之前始终构建镜像。 这类似于在使用 docker compose up 命令时使用 --build 选项。

停止容器

配置如何停止服务中的容器。默认情况下,Docker Compose 不会停止服务中的其他容器。您需要手动停止它们。 默认情况下,Docker Compose 不会停止服务中的其他容器。 您需要手动停止它们。

然而,您可以选择在服务中的任一容器停止时停止所有容器。 这类似于使用 --abort-on-container-exit 选项配合 docker compose up 命令。

最后修改日期: 2025年 9月 26日