Archivo docker-compose en detalle

El archivo compose es un archivo YAMLdonde definimos los servicios, redes y volúmenes. Usualmente lo colocamos en la ruta del directorio donde tendremos todo lo necesario para armar el ambiente.

Estas deficiones contienen toda la configuración que serán aplicadas a cada contenedor iniciado por ese servico. Sería lo mismo que pasarle estos parámetros con el comando docker-run, de la misma manera las definiciones de las redes y volúmenes serían semejantes a los comandos docker network create y docker volume create.

Vamos a ver ahora las opciones que podemos utilizar para las deficiones de servicio.

build

Aqui definimos las opciones de configuración que serán aplicadas al momento del crear el contenedor. Build puede ser especificado como un valor conteniendo una ruta con un contexto de creación o un objeto con la ruta especificada debajo de context y opcionalmente un dockerfile o argumento (args).

Ejemplo:

build: ./directorio

build:
    context: ./directorio
    dockerfile: <ruta a dockerfile alterno>

build: .  (dockerfile en la misma ruta docker-compose.yml)

context

Aqui definimos una ruta conteniendo un Dockerfile o una URL con un repositorio de git. Cuando el valor especificado es una ruta relativa, es interpretada como una ubicación relativa al archivo docker-compose. Este directorio será también el contexto de creación enviado al daemon de docker. Compose creará y le colocará un tag a la imagen con un nombre generado.

Ejemplo:

build:
    context: ./directorio

dockerfile

Archivo Dockerfile alterno. Con esta definición compose utilizará un archivo alterno para crear la imágen. La ruta debe estar especificada.

Ejemplo:

build:
    context: .
    dockerfile: ruta/a/Dockerfile

args

Con esto definimos argumentos de creación. Podemos hacer uso de diversos valores. Si hacemos uso de valores booleanos como, true, false, yes, no, necesitamos encerrarlos en comillas para asegurarnos que no sean convertidos a TRUE o FALSE por el analizador YML.

Argumentos con un solo valor son resueltos como valores de ambiente en la máquina donde estamos corriendo compose.

Ejemplo:

build:
    args:
        version: 1
        user: jsitech

build: 
    args:
        - version=1
        - user=jsitech

image

Especificamos la imágen con el que crearemos el contenedor.

Ejemplo:

image: jsitech/shodan
image: ubuntu:14.04
image: alpine

command

Sustituye el comando por defecto del contenedor

Ejemplo:

command: php -S 0.0.0.0:8080 -t /jsitech
command: [php, -S, 0.0.0.0:8080, -t, /jsitech]

container_name

Especificamos un nombre personalizado para el contenedor. Ya que los nombres de los contenedores de Docker deben ser únicos, si especificamos un nombre no podremos escalar el servicio en mas de un contenedor.

Ejemplo:

container_name: web_jsitech

depends_on

Aquí definimos las dependencias entre los servicios.

Ejemplo:

services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres

dns / dns_search

Aquí definimos servidores dns o dominios de búsqueda DNS personalizados

Ejemplo:

dns: 8.8.8.8
dns:
    - 8.8.8.8
    - 8.8.4.4

dns_search: ejemplo.com
dns_search:
    - ejemplo1.com
    - ejemplo2.com

entrypoint

Reemplaza el punto de entrada por defecto.

Ejemplo:

entrypoint: ruby /ruta/app.rb

Puede ser también una lista

entrypoint:
    - ruby
    - /ruta/app.rb

environment

Aquí agregamos variables de ambientes. Podemos hacer uso de diversos valores y debemos recordar que valores como true, false, yes, no, necesitan ser encerrados en comillas para que el analizador no los convierta a TRUE o FALSE.

Ejemplo:

environment: 
    MYSQL_DATABASE=jsitech
    MYSQL_USER=jsitech
    MYSQL_PASSWORD=jsitech

environment: 
    MYSQL_DATABASE: jsitech
    MYSQL_USER: jsitech
    MYSQL_PASSWORD: jsitech

expose

Expone los puertos sin publicarlos al Host. Solo estarán disponibles para los servicios linkeados. Solo se pueden especificar los puertos internos.

Ejemplo:

expose:
    - “4500”
    - “6000”

Linkeamos contenedores con otros servicios. Especificamos el nombre del servicio y el alias, o solo el nombre del servicio. Los contenedores linkeados serán alcanzados con el hostname identificado por el alias o por el nombre del servicio en caso de no haber especificado uno.

Ejemplo:

web:
   links:
      - db
      - dbprueba:mysql

Linkeamos contenedores fuera de docker-compose.yml y del mismo compose.

Ejemplo:

external_links:
    - alpine2
    - dbpueba:mysql

logging

Configuración de logging para el servicio. Util cuando queremos centralizar los logs de los contenedores.

Ejemplo:

logging:
    driver: syslog
    options:
        syslog-address: “tcp://10.0.0.45:123”

network_mode

Este modo usa los mismo valores con el cliente de docker cuando le pasamos la opción –net.

network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"

networks

Son las redes a las que se unirán los contenedores, referenciando las entradas debajo de las redes de nivel superior.

Ejemplo:

networks:
    - Red Prueba
    - Red Producción

aliases

Los alias son hostnames alternativos que le podemos a los servicios en la red, es decir, que otros contenedores en la misma red pueden llamar al servicio por el nombre de este, o por un alias definidos.

Ejemplo:

networks:
    red-prueba:
        aliases:
            - alias 1
            - alias 2

    red-producción:
        aliases:
            -alias3

En este ejemplo un contenedor puede llamar el servicio u otro contenedor con el nombre del servico o por alias 1 y alias 2 en la red-prueba o por el alias 3 en la red-producción.

Ports

Aqui a diferencia de expose, publicamos los puertos al host y podemos especificar el mapeo (HOST:CONTENEDOR).

Ejemplo:

ports:
    - “8080”
    - “8080-8085”
    - “8080:80”

volumes

Montamos rutas o volúmenes, especificamos una ruta en el host (HOST:CONTENEDOR), Igual podemos especificar modo de acceso (HOST:CONTENEDOR:rw)

Ejemplo:

volumes:
    - /opt/data:/var/lib/mysql
    - ./jsitech:/var/www/html

volumes_from

Montamos los volúmenes de otro servicio o contenedor

Ejemplo:

volumes_from:
    - db
    - web_jsitech

Para mantenerlo en lo básico lo dejaré hasta aquí, hay otras versiones que en su momento verán. Para darles una idea opciones para especificar el uso de recursos, definición mas complejas de redes, etc. La idea es que vayan introduciendose con el tema y a partir de ahí van profundizando.