プロジェクト名の指定

もくじ

Compose の場合、プロジェクト名はデフォルトで、プロジェクトディレクトリのベース名から定まります。 ただしこのプロジェクト名は任意に設定することができます。

This page offers examples of scenarios where custom project names can be helpful, outlines the various methods to set a project name, and provides the order of precedence for each approach.

メモ

デフォルトのプロジェクトディレクトリは、Compose ファイルがあるベースディレクトリです。 これについても コマンドラインオプション --project-directory を使って、独自のものに設定することができます。

ユースケース例

Compose ではプロジェクト名を定めることで、それぞれの環境を独立させています。 There are multiple contexts where a project name is useful:

  • On a development host: Create multiple copies of a single environment, useful for running stable copies for each feature branch of a project.
  • On a CI server: Prevent interference between builds by setting the project name to a unique build number.
  • On a shared or development host: Avoid interference between different projects that might share the same service names.

プロジェクト名の設定

Project names must contain only lowercase letters, decimal digits, dashes, and underscores, and must begin with a lowercase letter or decimal digit. If the base name of the project directory or current directory violates this constraint, alternative mechanisms are available.

The precedence order for each method, from highest to lowest, is as follows:

  1. The -p command line flag.
  2. The COMPOSE_PROJECT_NAME environment variable.
  3. The top-level name: attribute in your Compose file. Or the last name: if you specify multiple Compose files in the command line with the -f flag.
  4. The base name of the project directory containing your Compose file. Or the base name of the first Compose file if you specify multiple Compose files in the command line with the -f flag.
  5. The base name of the current directory if no Compose file is specified.

次は何？