PhpStorm 2025.2 Help

Docker compose 运行配置

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

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

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

项目

描述

名称(N)

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

允许多个实例(U)

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

默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置时,PhpStorm建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。

存储为项目文件(S)

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

默认情况下,它是禁用的,并且 PhpStorm 将运行配置设置存储在 .idea/workspace.xml

服务器

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

Compose 文件

指定定义必要服务的 compose 文件。 Docker Compose 按指定顺序构建配置,因此任何后续文件都会覆盖并添加到前一个文件中相同服务的字段。

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

服务

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

点击 “Browse 图标” 以选择 YML 文件中列出的服务。

docker-compose 浏览 图标

执行前(B)

指定在开始运行配置之前执行的任务列表。 例如,运行其他配置,构建必要的工件,运行一些外部工具或网络浏览器,等等。

点击 "添加"按钮 或按 Alt+Insert 以添加一个可用的任务。

在列表中使用 向上按钮向下按钮 移动任务,以更改执行任务的顺序。 选择任务并点击 编辑按钮 以编辑任务。 点击 "移除"按钮 以从列表中删除所选任务。

显示此页面

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

激活工具窗口

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

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

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

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

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

项目

描述

项目名称

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

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

环境变量

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

环境变量文件

指定路径到自定义 环境文件 ,以定义 Docker Compose 环境变量

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

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

`down` 时移除卷

停止和移除容器时,还会删除在 Docker Compose 文件中声明的命名卷以及附加到容器的匿名卷。

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

启用兼容性模式

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

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

`down` 时移除镜像

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

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

超时

设置超时时间(以秒为单位)以强制终止未正常关闭的容器。

Docker 通常会尝试优雅地终止任何包含 SIGTERM 的容器,但可能会无限期运行。 设置超时时间,之后 Docker 应发送 SIGKILL 来强制关闭。

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

退出代码

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

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

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

重写扩展

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

此选项将覆盖 Docker Compose 文件中的 scale 参数(如果存在)。

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

重新创建依赖项

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

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

重新创建匿名卷

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

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

移除孤立项

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

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

启动

配置要启动的服务:

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

  • :创建服务后不要启动它们。 这类似于使用 --no-start 选项与 docker compose up 命令。

  • 所选服务 :不要启动任何已链接的服务。 这类似于使用 --no-deps 选项与 docker compose up 命令。

附加到

配置要显示输出流的容器:

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

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

  • 所选部署和依赖项 :连接到指定服务和关联服务的容器。 这类似于使用 --attach-dependencies 选项与 docker compose up 命令。

重新创建容器

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

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

  • 所有 :重新创建服务中的所有容器,即使相应的配置或镜像没有更改。 这类似于使用 --force-recreate 选项与 docker compose up 命令。

  • :即使相应的配置已更改,也不要在服务中重新创建任何容器。 这类似于使用 --no-recreate 选项与 docker compose up 命令。

构建

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

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

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

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

停止容器

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

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

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