指定项目名称

在 Compose 中，默认的项目名称源自项目目录的基本名称。不过，您可以灵活地设置自定义项目名称。

本页面提供了自定义项目名称适用的场景示例，概述了设置项目名称的各种方法，并说明了每种方法的优先级顺序。

注意

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

示例用例

Compose 使用项目名称来隔离不同的环境。在多种上下文中，项目名称都非常有用：

• 在开发主机上：创建单个环境的多个副本，适用于为项目的每个功能分支运行稳定的副本。
• 在 CI 服务器上：通过将项目名称设置为唯一的构建号，防止构建之间相互干扰。
• 在共享或开发主机上：避免不同项目之间因使用相同的服务名称而产生干扰。

设置项目名称

项目名称只能包含小写字母、十进制数字、连字符和下划线，并且必须以小写字母或十进制数字开头。如果项目目录或当前目录的基本名称违反此约束，则可以使用其他机制。

每种方法的优先级顺序，从高到低如下：

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

接下来是什么？

• 阅读有关 使用多个 Compose 文件的信息。
• 探索一些 示例应用。