Compartir comentarios
Las respuestas se generan en base a la documentación.

Especificar un nombre de proyecto

Tabla de contenidos

Por defecto, Compose asigna el nombre del proyecto en función del nombre del directorio que contiene el archivo de Compose. Puedes sobrescribir esto mediante varios métodos.

Esta página ofrece ejemplos de escenarios en los que los nombres de proyecto personalizados pueden resultar útiles, describe los diversos métodos para establecer un nombre de proyecto y proporciona el orden de precedencia para cada enfoque.

Note

El directorio de proyecto por defecto es el directorio base del archivo de Compose. También se puede establecer un valor personalizado para este utilizando la opción de línea de comandos --project-directory.

Casos de uso de ejemplo

Compose utiliza un nombre de proyecto para aislar los entornos entre sí. Existen múltiples contextos donde un nombre de proyecto resulta útil:

  • En un host de desarrollo: Crear múltiples copias de un mismo entorno, lo cual resulta útil para ejecutar copias estables para cada rama de características (feature branch) de un proyecto.
  • En un servidor de CI: Evitar interferencias entre las compilaciones estableciendo el nombre del proyecto con un número de compilación único.
  • En un host compartido o de desarrollo: Evitar interferencias entre diferentes proyectos que puedan compartir los mismos nombres de servicios.

Establecer un nombre de proyecto

Los nombres de proyecto deben contener únicamente letras minúsculas, dígitos decimales, guiones y guiones bajos, y deben comenzar con una letra minúscula o un dígito decimal. Si el nombre base del directorio del proyecto o del directorio actual no cumple con esta restricción, existen mecanismos alternativos disponibles.

El orden de precedencia para cada método, de mayor a menor, es el siguiente:

  1. La bandera de línea de comandos -p.
  2. La variable de entorno COMPOSE_PROJECT_NAME.
  3. El atributo name: a nivel superior en tu archivo de Compose. O el último name: si especificas múltiples archivos de Compose en la línea de comandos con la bandera -f.
  4. El nombre base del directorio del proyecto que contiene tu archivo de Compose. O el nombre base del primer archivo de Compose si especificas múltiples archivos de Compose en la línea de comandos con la bandera -f.
  5. El nombre base del directorio actual si no se especifica ningún archivo de Compose.

¿Qué sigue?