Esta página proporciona la información de uso para el docker-compose Mando.

Descripción general y ayuda de las opciones de comando

También puede ver esta información ejecutando docker-compose --help desde la línea de comando.

Define and run multi-container applications with Docker.

Usage:
  docker-compose [-f ...] [options] [COMMAND] [ARGS...]
  docker-compose -h|--help

Options:
  -f, --file FILE             Specify an alternate compose file
                              (default: docker-compose.yml)
  -p, --project-name NAME     Specify an alternate project name
                              (default: directory name)
  --verbose                   Show more output
  --log-level LEVEL           Set log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
  --no-ansi                   Do not print ANSI control characters
  -v, --version               Print version and exit
  -H, --host HOST             Daemon socket to connect to

  --tls                       Use TLS; implied by --tlsverify
  --tlscacert CA_PATH         Trust certs signed only by this CA
  --tlscert CLIENT_CERT_PATH  Path to TLS certificate file
  --tlskey TLS_KEY_PATH       Path to TLS key file
  --tlsverify                 Use TLS and verify the remote
  --skip-hostname-check       Don't check the daemon's hostname against the
                              name specified in the client certificate
  --project-directory PATH    Specify an alternate working directory
                              (default: the path of the Compose file)
  --compatibility             If set, Compose will attempt to convert deploy
                              keys in v3 files to their non-Swarm equivalent

Commands:
  build              Build or rebuild services
  bundle             Generate a Docker bundle from the Compose file
  config             Validate and view the Compose file
  create             Create services
  down               Stop and remove containers, networks, images, and volumes
  events             Receive real time events from containers
  exec               Execute a command in a running container
  help               Get help on a command
  images             List images
  kill               Kill containers
  logs               View output from containers
  pause              Pause services
  port               Print the public port for a port binding
  ps                 List containers
  pull               Pull service images
  push               Push service images
  restart            Restart services
  rm                 Remove stopped containers
  run                Run a one-off command
  scale              Set number of containers for a service
  start              Start services
  stop               Stop services
  top                Display the running processes
  unpause            Unpause services
  up                 Create and start containers
  version            Show the Docker-Compose version information

Puede utilizar Docker Compose binary, docker-compose [-f ...] [options] [COMMAND] [ARGS...], para construir y administrar múltiples servicios en contenedores Docker.

Usar -f para especificar el nombre y la ruta de uno o más archivos de composición

Utilizar el -f marca para especificar la ubicación de un archivo de configuración de Compose.

Especificar varios archivos de composición

Puede suministrar varios -f Archivos de configuración. Cuando proporciona varios archivos, Compose los combina en una única configuración. Compose crea la configuración en el orden en que proporcionas los archivos. Los archivos posteriores anulan y agregan a sus predecesores.

Por ejemplo, considere esta línea de comando:

$ docker-compose -f docker-compose.yml -f docker-compose.admin.yml run backup_db

los docker-compose.yml archivo puede especificar un webapp Servicio.

webapp:
  image: examples/web
  ports:
    - "8000:8000"
  volumes:
    - "/data"

Si el docker-compose.admin.yml también especifica este mismo servicio, cualquier campo coincidente anula el archivo anterior. Nuevos valores, agregue al webapp configuración del servicio.

webapp:
  build: .
  environment:
    - DEBUG=1

Utilizar una -f con - (guión) como nombre de archivo para leer la configuración stdin. Cuando stdin se utiliza, todas las rutas en la configuración son relativas al directorio de trabajo actual.

los -f la bandera es opcional. Si no proporciona este indicador en la línea de comando, Compose recorre el directorio de trabajo y sus directorios principales en busca de un docker-compose.yml y un docker-compose.override.yml expediente. Debe proporcionar al menos el docker-compose.yml expediente. Si ambos archivos están presentes en el mismo nivel de directorio, Compose combina los dos archivos en una única configuración.

La configuración en el docker-compose.override.yml El archivo se aplica sobre y además de los valores en el docker-compose.yml expediente.

Especificar una ruta a un solo archivo de composición

Puedes usar -f marca para especificar una ruta al archivo Compose que no se encuentra en el directorio actual, ya sea desde la línea de comando o configurando una variable de entorno COMPOSE_FILE en su shell o en un archivo de entorno.

Para ver un ejemplo del uso de -f en la línea de comandos, suponga que está ejecutando la muestra Compose Rails y tiene una docker-compose.yml archivo en un directorio llamado sandbox/rails. Puede usar un comando como docker-compose pull para obtener la imagen de postgres para el db servicio desde cualquier lugar utilizando el -f marcar de la siguiente manera: docker-compose -f ~/sandbox/rails/docker-compose.yml pull db

Aquí está el ejemplo completo:

$ docker-compose -f ~/sandbox/rails/docker-compose.yml pull db
Pulling db (postgres:latest)...
latest: Pulling from library/postgres
ef0380f84d05: Pull complete
50cf91dc1db8: Pull complete
d3add4cd115c: Pull complete
467830d8a616: Pull complete
089b9db7dc57: Pull complete
6fba0a36935c: Pull complete
81ef0e73c953: Pull complete
338a6c4894dc: Pull complete
15853f32f67c: Pull complete
044c83d92898: Pull complete
17301519f133: Pull complete
dcca70822752: Pull complete
cecf11b8ccf3: Pull complete
Digest: sha256:1364924c753d5ff7e2260cd34dc4ba05ebd40ee8193391220be0f9901d4e1651
Status: Downloaded newer image for postgres:latest

Usar -p para especificar un nombre de proyecto

Cada configuración tiene un nombre de proyecto. Si proporciona un -p bandera, puede especificar un nombre de proyecto. Si no especifica la marca, Compose usa el nombre del directorio actual. Consulte también la variable de entorno COMPOSE_PROJECT_NAME.

Configurar variables de entorno

Puede establecer variables de entorno para varios docker-compose opciones, incluida la -f y -p banderas.

Por ejemplo, la variable de entorno COMPOSE_FILE se relaciona con la -f bandera, y la variable de entorno COMPOSE_PROJECT_NAME se relaciona con el -p bandera.

Además, puede establecer algunas de estas variables en un archivo de entorno.

A donde ir después

  • Variables de entorno CLI
  • Declarar variables de entorno predeterminadas en el archivo

higo, composición, componer, estibador, orquestación, cli, docker-compose