Lab 05 - Creando un stack de servicios con docker-compose

Objetivos y resultados

El objetivo de este laboratorio es crear una stack de servicios orquestados por docker-compose. Para ello, aprovecharemos la imágenes Docker que hemos generado en los laboratiorios anteriores. Como resultado, obtendremos un fichero YAML con toda la configuración necesarioa para levantar nuestro stack con un solo comando.

¿Qué es docker-compose?

Se trata de una herramienta ideal para ejecutar stacks de aplicaciones contenerizadas. Mediante una definición YAML, se configuran todos los servicios implicados en el stack y, mediante un único comando, permite desplegar un stack completo de servicios.

¿Cuál es la ventaja de usar docker-compose?

Se trata de un tipo de orquestación de stacks de contenedores. Cuando queremos gestionar distintos servicios que tienen que interactuar entre sí, compose se encarga de mantener los procesos y configurar la red subyacente para que estos estén constantemente up and running. Si alguno de los servicios falla, compose se encarga de volver a arrancarlo manteniendo la integridad del stack.

¿Cómo funciona?

En un fichero docker-compose, es posible definir tres tipos de recursos básicos:
- Servicios: la sección de servicios hace referencia a la configuración de los contendores. Teniendo en cuenta nuestro objetivo final, nuestra sección se servicios estará compuesta por tres servicios contenerizados, un servicio de front, un back y una capa de persistencia.
- Volúmenes: hace referencia a un espacio de disco físico que será reservado en el host para persistir la información de uno o varios servicios contenerizados.
- Redes: hace referencia a la capa de comunicación que se va a definir para el stack. Aquí se definirán las reglas de comunicación entre los contenedores e incluso entre los contenedores y el host.

services:
  frontend:
    image: my-front
    ...
  backend:
    image: my-back
    ...
  db:
    image: persistence
    ...
volumes:
   my-volume:
networks:
   my-stack-network:

Crear un stack de servicios gestionados por doker-compose.

Paso 1. Instalar docker-compose.

Descarga el paquete
curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
Aplica permisos de ejecución al fichero binario
chmod +x /usr/local/bin/docker-compose
Añádelo al PATH mediante un enlace simbólico
ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Recomendamos usar la versión estable Tras la instalación, ejecuta el siguiente comando: docker-compose --version Si todo ha ido bien, se mostrará la versión instalada de docker-compose.

Paso 2. Definir la configuración del servicio de frontend.

Para definir la configuración del servicio de frontend, debemos tener en cuenta los siguientes puntos:

Nombre de la imagen
Puerto que expone

my-frontend:
    image: helloworld:latest
    ports:
      - "8080:80"

Paso 3. Definir la configuración del servicio de backend.

Para definir la configuración del servicio de backend, debemos tener en cuenta los siguientes puntos:

Nombre de la imagen
Puerto que expone

my-backend:
    image: ...
    ports:
      - "...."

Paso 4. Definir la configuración del servicio de persistencia.

Para definir la configuración del servicio de persistencia, debemos tener en cuenta los siguientes puntos:

Nombre de la imagen
Puerto que expone
Mapeo del volumen de persistencia de datos

db:
    image: ...
    ports:
      - "...."
    volumes:
      - my-volume:/.../...

Paso 5. Definir el fichero YAML completo.

Ahora que tenemos la configuración de los tres servicios, ya podemos definir el docker-compose completo. Guarda fichero como "docker-compose.yml".

version: '3'
services:
  my-frontend:
      image: helloworld:latest
      ports:
        - "8080:80"
  my-backend:
      image: ...
      ports:
        - "...."
  db:
      image: ...
      ports:
        - "...."
      volumes:
        - my-volume:/.../...
volumes:
  - my-volume:

Recuerda definir el recurso de volúmenes

Paso 6. Levantar el stack de recursos.

Para levantar el stack de recursos definido anteriormente, ejecuta el siguiente comando en la ruta donde tengas el fichero docker-compsoe:
docker-compose up
Puedes comprobar en el log si todo ha ido bien.

ElianaFerioli / openathon2019