WebStorm 2025.2 Help

Docker Compose 运行配置

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

Docker Compose 运行配置对话框

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

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

项目

描述

名称(N)

为运行配置指定一个名称,以便在编辑或运行时快速识别。

允许多个实例(U)

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

默认情况下,此选项处于禁用状态。当您在已有实例正在运行时启动此配置,WebStorm 会建议停止当前实例并启动另一个实例。 这在运行配置消耗大量资源且没有合理理由同时运行多个实例时非常有用。

存储为项目文件(S)

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

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

服务器

选择要用于运行配置的 Docker daemon connection

Compose 文件

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

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

服务

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

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

指定要运行的服务

执行前(B)

指定在启动运行配置之前需要执行的任务列表。 例如,运行另一个配置、构建所需 artifact、运行某个外部工具或 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 只构建当前不可用的镜像,并在可能的情况下使用之前构建的镜像。

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

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

停止容器

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

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

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