Esta guía para principiantes te guiará a través del proceso de instalación de Docker y Docker Compose, y te enseñará cómo usar Compose para definir, desplegar y gestionar tus aplicaciones. Aprenderás sobre las características clave y las opciones de configuración disponibles en Docker Compose, así como las mejores prácticas para escalar y equilibrar la carga de tus aplicaciones Compose.
Docker Compose es una herramienta que te permite definir y ejecutar aplicaciones Docker multicontenedor. Simplifica el proceso de gestión y orquestación de múltiples contenedores Docker al proporcionar una forma declarativa de definir los servicios, redes y volúmenes de la aplicación.
Con Docker Compose, puedes:
Puedes definir los diferentes servicios que componen tu aplicación, como un servidor web, una base de datos y una cola de mensajes, en un único archivo YAML. Este archivo, llamado "archivo Compose", describe la configuración de cada servicio, incluyendo la imagen Docker a usar, los puertos de red a exponer y cualquier variable de entorno o volumen a montar.
Docker Compose proporciona comandos para iniciar, detener y gestionar el ciclo de vida de toda tu aplicación. Puedes usar docker-compose up para crear e iniciar todos los servicios definidos en tu archivo Compose, y docker-compose down para detenerlos y eliminarlos.
Docker Compose es particularmente útil durante las fases de desarrollo y pruebas de tu aplicación. Te permite iniciar fácilmente un entorno de desarrollo completo con todos los servicios necesarios, facilitando la prueba de tu aplicación de forma consistente y reproducible.
Al usar Docker Compose, puedes asegurar que tu aplicación se ejecute de la misma manera en diferentes entornos, desde el desarrollo hasta la producción, reduciendo el riesgo de problemas específicos del entorno.
| Servicio | Imagen | Puertos | Entorno |
|---|---|---|---|
| Servidor Web | nginx:latest | 80:80 | - |
| Base de Datos | mysql:5.7 | 3306:3306 | MYSQL_ROOT_PASSWORD=password |
| Cola de Mensajes | rabbitmq:3-management | 5672:5672, 15672:15672 | - |
En resumen, Docker Compose es una herramienta poderosa que simplifica la gestión y el despliegue de aplicaciones Docker multicontenedor, facilitando el desarrollo, las pruebas y la ejecución de aplicaciones complejas de forma consistente y reproducible.
Antes de empezar a usar Docker Compose, necesitas tener Docker y Docker Compose instalados en tu sistema. En esta sección, te guiaremos a través del proceso de instalación en un sistema Ubuntu 22.04.
sudo apt-get updatesudo apt-get install -y \
ca-certificates \
curl \
gnupg \
lsb-releasesudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgecho \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullsudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-pluginsudo docker run hello-worldDocker Compose se instala como parte del proceso de instalación de Docker Engine en Ubuntu 22.04. Sin embargo, si necesitas instalar una versión específica de Docker Compose, puedes seguir estos pasos:
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-composedocker-compose --versionAhora que tienes Docker y Docker Compose instalados, estás listo para empezar a definir y desplegar tus aplicaciones multicontenedor usando Docker Compose.
El corazón de una aplicación Docker Compose es el archivo Compose, escrito en formato YAML. En este archivo, defines los diferentes servicios que componen tu aplicación, junto con sus configuraciones.
Cada servicio en tu archivo Compose se define como una clave de nivel superior, como web, db o redis. Bajo cada servicio, puedes especificar diversas opciones de configuración, como la imagen Docker a usar, los puertos de red a exponer, variables de entorno y más.
Aquí tienes un ejemplo de un archivo Compose simple con tres servicios:
version: "3"
services:
web:
image: nginx:latest
ports:
- 80:80
volumes:
- ./app:/usr/share/nginx/html
db:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: password
volumes:
- db-data:/var/lib/mysql
redis:
image: redis:latest
ports:
- 6379:6379
volumes:
db-data:En este ejemplo, tenemos tres servicios:
web: Ejecuta la última versión del servidor web Nginx, mapea el puerto 80 del host al puerto 80 del contenedor y monta el directorio ./app del host al directorio /usr/share/nginx/html del contenedor.
db: Ejecuta la base de datos MySQL 5.7, establece la variable de entorno MYSQL_ROOT_PASSWORD con el valor "password" y monta un volumen nombrado db-data para almacenar los datos de la base de datos.
redis: Ejecuta la última versión del almacén de datos en memoria Redis, mapea el puerto 6379 del host al puerto 6379 del contenedor.
Además de definir los servicios, el archivo Compose también te permite definir volúmenes compartidos y redes que pueden ser usados por los servicios.
En el ejemplo anterior, definimos un volumen nombrado db-data para almacenar los datos de la base de datos MySQL. Este volumen puede ser compartido entre múltiples servicios, asegurando que los datos persistan incluso si los contenedores se detienen o recrean.
También puedes definir redes personalizadas para controlar la conectividad entre tus servicios. Esto es útil cuando quieres aislar ciertos servicios o crear una topología de red más compleja.
Al usar un archivo Compose, puedes definir y gestionar fácilmente los diferentes componentes de tu aplicación, facilitando el despliegue, escalado y mantenimiento de tus aplicaciones Docker multicontenedor.
Una vez que hayas definido tus servicios en un archivo Compose, puedes usar los comandos de Docker Compose para desplegar y gestionar tu aplicación.
Para desplegar tu aplicación, navega al directorio que contiene tu archivo Compose y ejecuta el siguiente comando:
docker-compose up -dLa bandera -d ejecuta los contenedores en modo desacoplado, lo que significa que se ejecutarán en segundo plano.
Docker Compose leerá el archivo Compose, creará la red y los volúmenes Docker necesarios, e iniciará todos los servicios definidos.
Después de desplegar tu aplicación, puedes usar los siguientes comandos de Docker Compose para gestionar su ciclo de vida:
docker-compose stop: Detenida todos los servicios en ejecución.docker-compose start: Inicia los servicios detenidos.docker-compose restart: Reinicia todos los servicios en ejecución.docker-compose down: Detenida y elimina todos los servicios, redes y volúmenes.Por ejemplo, para detener la aplicación, puedes ejecutar:
docker-compose stopY para iniciarla de nuevo, puedes ejecutar:
docker-compose startDocker Compose facilita el escalado de tus servicios hacia arriba o hacia abajo. Para escalar un servicio específico, puedes usar el comando scale:
docker-compose scale web=3 db=2Esto escalará el servicio web a 3 instancias y el servicio db a 2 instancias.
También puedes usar el comando up con la bandera --scale para escalar servicios al desplegar la aplicación:
docker-compose up --scale web=3 --scale db=2 -dPara visualizar los registros de tu aplicación, puedes usar el comando logs:
docker-compose logsEsto mostrará los registros de todos los servicios. También puedes visualizar los registros de un servicio específico especificando su nombre:
docker-compose logs webAl usar estos comandos de Docker Compose, puedes desplegar, gestionar y escalar fácilmente tus aplicaciones multicontenedor, facilitando el desarrollo, las pruebas y la ejecución de aplicaciones complejas de forma consistente y reproducible.
Aunque la estructura básica de los archivos Compose y los comandos son potentes, Docker Compose también ofrece una serie de funciones y opciones de configuración avanzadas para ayudarte a construir aplicaciones más complejas y robustas.
Puedes usar variables de entorno para pasar configuraciones a tus servicios. Docker Compose admite variables de entorno de tiempo de compilación y tiempo de ejecución, que se pueden definir a nivel de servicio o global.
Además, puedes usar Docker Secrets para almacenar de forma segura información confidencial, como contraseñas de bases de datos o claves API, y ponerlas a disposición de tus servicios.
version: "3"
services:
web:
image: myapp/web
environment:
- DATABASE_URL=mysql://root:${DB_PASSWORD}@db/myapp
secrets:
- db-password
secrets:
db-password:
file: ./db-password.txtDocker Compose te permite definir dependencias de servicios, asegurando que los servicios se inicien en el orden correcto y que los servicios dependientes estén operativos antes de iniciar otros servicios.
También puedes configurar comprobaciones de estado para tus servicios, lo que permite a Compose monitorizar el estado de tus contenedores y tomar acciones apropiadas, como reiniciar contenedores no operativos.
version: "3"
services:
web:
image: myapp/web
depends_on:
db:
condition: service_healthy
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost"]
interval: 30s
timeout: 10s
retries: 5
db:
image: mysql:5.7
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
interval: 30s
timeout: 10s
retries: 5Docker Compose crea automáticamente una red predeterminada para tu aplicación, pero también puedes definir redes personalizadas y controlar la configuración de red de tus servicios.
Además, Compose proporciona un descubrimiento de servicios integrado, lo que permite a tus servicios encontrar y comunicarse entre sí utilizando los nombres de servicio definidos en el archivo Compose.
version: "3"
services:
web:
image: myapp/web
networks:
- frontend
environment:
- DB_HOST=db
db:
image: mysql:5.7
networks:
- backend
networks:
frontend:
backend:Al aprovechar estas funciones avanzadas, puedes construir aplicaciones Docker Compose más complejas, resilientes y escalables que satisfagan las necesidades de tu organización.
Uno de los beneficios clave de usar Docker Compose es la capacidad de escalar fácilmente tus servicios e implementar el equilibrio de carga. En esta sección, exploraremos cómo lograr estas capacidades.
Como se mencionó anteriormente, puedes escalar tus servicios hacia arriba o hacia abajo usando el comando scale. Esto es particularmente útil cuando necesitas manejar un aumento de tráfico o demandas de recursos.
Por ejemplo, digamos que tienes un servicio web definido en tu archivo Compose:
version: "3"
services:
web:
image: myapp/web
ports:
- 80:80Para escalar el servicio web a 3 instancias, puedes ejecutar el siguiente comando:
docker-compose scale web=3Esto creará dos instancias adicionales del servicio web, permitiéndote distribuir la carga entre varios contenedores.
Docker Compose también proporciona capacidades de equilibrio de carga integradas. Cuando defines varias instancias de un servicio, Compose equilibrará automáticamente las solicitudes entrantes entre los contenedores disponibles.
version: "3"
services:
web:
image: myapp/web
ports:
- 80:80
deploy:
replicas: 3
restart_policy:
condition: on-failureEn este ejemplo, hemos definido el servicio web con 3 réplicas. Cuando ejecutas docker-compose up, Compose creará tres instancias del servicio web y equilibrará la carga de las solicitudes entrantes entre ellas.
También puedes configurar opciones adicionales de equilibrio de carga, como la política de reinicio, para asegurar que tu aplicación permanezca altamente disponible.
Al aprovechar las funciones de escalado y equilibrio de carga de Docker Compose, puedes construir aplicaciones altamente escalables y resilientes que puedan manejar un aumento de tráfico y demandas de recursos.
Como con cualquier tecnología, es posible que encuentres problemas o desafíos al trabajar con Docker Compose. En esta sección, cubriremos algunos pasos comunes de solución de problemas y mejores prácticas para ayudarte a gestionar eficazmente tus aplicaciones basadas en Compose.
Comprobación de Registros: Si encuentras problemas con tu aplicación Compose, el primer paso es revisar los registros usando el comando docker-compose logs. Esto te ayudará a identificar cualquier error o problema con tus servicios.
Inspección de Contenedores: Puedes usar el comando docker-compose ps para listar los contenedores en ejecución y su estado. Esto puede ayudarte a identificar cualquier contenedor que no esté funcionando como se espera.
Depuración de Servicios: Si un servicio específico no se comporta como se espera, puedes usar el comando docker-compose exec para acceder al contenedor y depurar el problema. Por ejemplo, docker-compose exec web bash te dará un shell dentro del contenedor del servicio web.
Verificación de la Configuración: Revisa cuidadosamente tu archivo Compose para asegurarte de que las definiciones de servicio, las configuraciones de red y la configuración de volúmenes sean correctas. Puedes usar el comando docker-compose config para validar la sintaxis y la estructura de tu archivo Compose.
Uso de Variables de Entorno: Aprovecha las variables de entorno para almacenar configuraciones, como credenciales de bases de datos o claves API. Esto facilita la gestión de información confidencial y la adaptación de tu aplicación a diferentes entornos.
Separación de Preocupaciones: Considera separar tu aplicación en servicios más pequeños y manejables. Esto facilitará el escalado, el mantenimiento y las pruebas de los componentes individuales de tu aplicación.
Implementación de Comprobaciones de Estado: Configura comprobaciones de estado para tus servicios para asegurar que los contenedores estén funcionando correctamente. Esto ayudará a Compose a monitorear el estado de tu aplicación y tomar acciones apropiadas, como reiniciar contenedores no operativos.
Control de Versiones del Archivo Compose: Almacena tu archivo Compose en un sistema de control de versiones, como Git. Esto te ayudará a realizar un seguimiento de los cambios, colaborar con miembros del equipo y asegurar despliegues consistentes en diferentes entornos.
Uso Inteligente de Redes: Aprovecha las redes personalizadas para aislar y controlar la conectividad entre tus servicios. Esto puede mejorar la seguridad y el rendimiento de tu aplicación.
Aprovecha LabEx: Considera usar LabEx, una plataforma potente que proporciona características y herramientas adicionales para mejorar tu experiencia con Docker Compose. LabEx puede ayudarte a optimizar el despliegue, el monitoreo y la gestión de tus aplicaciones basadas en Compose.
Siguiendo estos pasos de solución de problemas y mejores prácticas, puedes gestionar y mantener eficazmente tus aplicaciones Docker Compose, asegurando que funcionen sin problemas y de forma fiable en diversos entornos.
Al finalizar este tutorial, tendrás una comprensión sólida de cómo instalar y usar Docker Compose para optimizar el despliegue y la gestión de tus aplicaciones. Podrás definir tus servicios, desplegar y gestionar tus aplicaciones Compose, y solucionar cualquier problema que pueda surgir. Ya seas nuevo en Docker o busques mejorar tus habilidades con Compose, esta guía te proporcionará el conocimiento y las herramientas necesarias para comenzar con Docker Compose.
