切换语言

指定项目名称

目录

在 Compose 中，默认项目名称派生自项目目录的基本名称。但是，您可以灵活地设置自定义项目名称。

本页提供了自定义项目名称可能有用的方案示例，概述了设置项目名称的各种方法，并提供了每种方法的优先顺序。

注意

默认项目目录是 Compose 文件的基目录。还可以设置自定义值 使用 --project-directory 命令行选项。

示例用例

Compose 使用项目名称将环境彼此隔离开来。项目名称在多个上下文中非常有用：

  • 在开发主机上：创建单个环境的多个副本，这对于为项目的每个功能分支运行稳定副本非常有用。
  • 在 CI 服务器上：通过将项目名称设置为唯一的内部版本号来防止内部版本之间的干扰。
  • 在共享主机或开发主机上：避免可能共享相同服务名称的不同项目之间的干扰。

设置项目名称

项目名称必须仅包含小写字母、十进制数字、短划线和 下划线，并且必须以小写字母或十进制数字开头。如果 项目目录或当前目录的 base name 违反此 constraint 的 Constraint 中，可以使用替代机制。

每种方法的优先顺序（从最高到最低）如下：

  1. 命令行标志。-p
  2. COMPOSE_PROJECT_NAME 环境变量。
  3. Compose 文件中的顶级 name： 属性。或者，如果您在命令行中使用标志指定多个 Compose 文件，则为最后一个。name:-f
  4. 包含 Compose 文件的项目目录的基本名称。或者，如果您在命令行中使用标志指定多个 Compose 文件，则为第一个 Compose 文件的基名称。-f
  5. 如果未指定 Compose 文件，则为当前目录的基本名称。

下一步是什么？