⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

Spécifier un nom de projet

Table des matières

Dans Compose, le nom de projet par défaut est dérivé du nom de base du répertoire du projet. Cependant, vous avez la flexibilité de définir un nom de projet personnalisé.

Cette page offre des exemples de scénarios où les noms de projet personnalisés peuvent être utiles, décrit les diverses méthodes pour définir un nom de projet, et fournit l'ordre de priorité pour chaque approche.

Note

Le répertoire de projet par défaut est le répertoire de base du fichier Compose. Une valeur personnalisée peut également être définie pour cela en utilisant l' option de ligne de commande --project-directory.

Cas d'usage exemples

Compose utilise un nom de projet pour isoler les environnements les uns des autres. Il y a plusieurs contextes où un nom de projet est utile :

  • Sur un hôte de développement : Créer plusieurs copies d'un seul environnement, utile pour exécuter des copies stables pour chaque branche de fonctionnalité d'un projet.
  • Sur un serveur CI : Empêcher les interférences entre les constructions en définissant le nom de projet sur un numéro de construction unique.
  • Sur un hôte partagé ou de développement : Éviter les interférences entre différents projets qui pourraient partager les mêmes noms de service.

Définir un nom de projet

Les noms de projet doivent contenir uniquement des lettres minuscules, des chiffres décimaux, des tirets et des underscores, et doivent commencer par une lettre minuscule ou un chiffre décimal. Si le nom de base du répertoire du projet ou du répertoire courant viole cette contrainte, des mécanismes alternatifs sont disponibles.

L'ordre de priorité pour chaque méthode, du plus élevé au plus bas, est le suivant :

  1. Le flag de ligne de commande -p.
  2. La variable d'environnement COMPOSE_PROJECT_NAME.
  3. L' attribut name: de niveau supérieur dans votre fichier Compose. Ou le dernier name: si vous spécifiez plusieurs fichiers Compose en ligne de commande avec le flag -f.
  4. Le nom de base du répertoire du projet contenant votre fichier Compose. Ou le nom de base du premier fichier Compose si vous spécifiez plusieurs fichiers Compose en ligne de commande avec le flag -f.
  5. Le nom de base du répertoire courant si aucun fichier Compose n'est spécifié.

Et ensuite ?