指定项目名称
在 Compose 中,默认项目名称源自项目目录的基本名称。但是,您可以灵活地设置自定义项目名称。
本页提供了自定义项目名称可能有用的场景示例,概述了设置项目名称的各种方法,并提供了每种方法的优先顺序。
笔记
默认项目目录是 Compose 文件的基目录。还可以使用
--project-directory
命令行选项为其设置自定义值 。
示例用例
Compose 使用项目名称来相互隔离环境。项目名称在多种情况下都很有用:
- 在开发主机上:创建单个环境的多个副本,这对于为项目的每个功能分支运行稳定副本很有用。
- 在 CI 服务器上:通过将项目名称设置为唯一的内部版本号来防止内部版本之间的干扰。
- 在共享或开发主机上:避免可能共享相同服务名称的不同项目之间的干扰。
设置项目名称
项目名称只能包含小写字母、十进制数字、破折号和下划线,并且必须以小写字母或十进制数字开头。如果项目目录或当前目录的基本名称违反了此约束,则可以使用替代机制。
每种方法的优先顺序从最高到最低如下:
- 命令
-p
行标志。 - COMPOSE_PROJECT_NAME 环境变量。
- Compose 文件中的顶级属性
name:
。name:
如果您 在命令行中使用该标志指定多个 Compose 文件,则为最后一个-f
。 - 包含 Compose 文件的项目目录的基本名称。或者,如果您在命令行中使用该标志指定多个 Compose 文件,则为第一个 Compose 文件的基本名称
-f
。 - 如果未指定 Compose 文件,则为当前目录的基本名称。
下一步是什么?
- 阅读有关 使用多个 Compose 文件的信息。
- 探索一些 示例应用程序。