PyCharm 2025.3 Help

Docker Compose 运行配置

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

Docker Compose 运行配置对话框

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

默认情况下, Docker Compose 配置包含以下选项:

说明

名称(N)

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

允许多个实例(U)

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

默认情况下,该选项处于禁用状态;当您在另一个实例仍在运行时启动此配置,PyCharm 会建议停止正在运行的实例并启动另一个实例。 当某个运行配置占用大量资源且没有充足理由运行多个实例时,这很有帮助。

存储为项目文件(S)

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

默认情况下,该选项处于禁用状态,PyCharm 会将运行配置设置存储在 .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 up 命令中使用 --abort-on-container-exit 选项。

最后修改日期: 2025年 12月 2日