Saltar a contenido

El comando docker compose

Una vez hemos creado el archivo docker-compose.yaml tenemos que empezar a trabajar con él, es decir a crear los contenedores que describe su contenido.

Esto lo haremos mediante el subcomando docker compose. Es importante destacar que debemos invocarla desde el directorio en el que se encuentra el fichero docker-compose.yaml.

Los subcomandos más usados son:

  • docker compose up: Crear los contenedores (servicios) que están descritos en el docker-compose.yaml.
  • docker compose up -d: Crear en modo detach los contenedores (servicios) que están descritos en el docker-compose.yaml. Eso significa que no muestran mensajes de log en el terminal y que se nos vuelve a mostrar un prompt.
  • docker compose stop: Detiene los contenedores que previamente se han lanzado con docker compose up.
  • docker compose run: Inicia los contenedores descritos en el docker-compose.yaml que estén parados.
  • docker compose rm: Borra los contenedores parados del escenario. Con las opción -f elimina también los contenedores en ejecución.
  • docker compose pause: Pausa los contenedores que previamente se han lanzado con docker compose up.
  • docker compose unpause: Reanuda los contenedores que previamente se han pausado.
  • docker compose restart: Reinicia los contenedores. Orden ideal para reiniciar servicios con nuevas configuraciones.
  • docker compose down: Para los contenedores, los borra y también borra las redes que se han creado con docker compose up (en caso de haberse creado).
  • docker compose down -v: Para los contenedores y borra contenedores, redes y volúmenes.
  • docker compose logs: Muestra los logs de todos los servicios del escenario. Con el parámetro -fpodremos ir viendo los logs en "vivo".
  • docker compose logs servicio1: Muestra los logs del servicio llamado servicio1 que estaba descrito en el docker-compose.yaml.
  • docker compose exec servicio1 /bin/bash: Ejecuta una orden, en este caso /bin/bash en un contenedor llamado servicio1 que estaba descrito en el docker-compose.yaml
  • docker compose build: Ejecuta, si está indicado, el proceso de construcción de una imagen que va a ser usado en el docker-compose.yaml a partir de los ficheros Dockerfile que se indican.
  • docker compose top: Muestra los procesos que están ejecutándose en cada uno de los contenedores de los servicios.

Despliegue de Let's Chat

Para desplegar la aplicación Let's Chat que vimos en el punto anterior, ejecutamos la siguiente instrucción en el directorio donde tengamos el fichero docker-compose.yaml:

docker compose up -d
[+] Running 4/4
 ✔ Network letschat_default          Created                                      0.1s 
 ✔ Volume "letschat_mongo_letschat"  Create...                                    0.0s 
 ✔ Container mongo                   Started                                      0.3s 
 ✔ Container letschat                Started                                      0.2s

Tenemos que tener en cuenta que si no tenemos las imágenes en nuestro registro local, se descargarán. Además podemos ver cómo se ha creado una red definida por el usuario llamada letschat_default.

Podemos ver los contenedores que se están ejecutando:

$ docker compose ps
NAME       IMAGE                  COMMAND                         SERVICE   CREATED              STATUS              PORTS
letschat   sdelements/lets-chat   "npm start"                     app       About a minute ago   Up About a minute   5222/tcp, 0.0.0.0:80->8080/tcp, :::80->8080/tcp
mongo      mongo:4                "docker-entrypoint.sh mongod"   db        About a minute ago   Up About a minute   27017/tcp

Podemos acceder desde el navegador a la aplicación:

letschat

Finalmente podemos destruir el escenario:

$ docker compose down
[+] Running 3/3
 ✔ Container letschat        Removed                                             10.4s 
 ✔ Container mongo           Removed                                              0.4s 
 ✔ Network letschat_default  Removed                                              0.1s

Recuerda que si queremos además eliminar los volúmenes usados, ejecutaríamos:

$ docker compose down -v