Docker Compose es una herramienta que le permite definir y orquestar aplicaciones Docker de varios contenedores. Utiliza un archivo YAML para configurar los contenedores, las redes y los volúmenes de la aplicación.
Componer se puede utilizar para diversos fines. Las implementaciones de aplicaciones de host único, las pruebas automatizadas y el desarrollo local son los casos de uso más populares para Docker Compose.
Este tutorial le guiará por el proceso de instalación de la última versión de Docker Compose en Debian 9. También exploraremos los conceptos y comandos básicos de Docker Compose.
Requisitos previos #
Asegúrese de cumplir con los siguientes requisitos previos antes de continuar con este tutorial:
- Iniciar sesión como usuario con privilegios sudo.
- Haga que Docker esté instalado en su máquina Debian 9.
Instalar Docker Compose en Debian #
El paquete de instalación de Docker Compose está disponible en los repositorios oficiales de Debian 9, pero es posible que no siempre sea la última versión. El enfoque recomendado es instalar Docker Compose desde el repositorio GitHub de Docker.
Al momento de escribir este artículo, la última versión estable de Docker Compose es la versión 1.23.1
. Antes de descargar el binario de Compose, visite la página de lanzamiento del repositorio de Compose en GitHuband y verifique si hay una nueva versión disponible para descargar.
Realice los siguientes pasos para instalar la última versión de Docker Compose en Debian 9:
-
Comience descargando el binario Docker Compose en
/usr/local/bin
directorio usando el siguientecurl
comando:sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
-
Cuando se complete la descarga, otorgue permisos de ejecución al binario Compose:
sudo chmod +x /usr/local/bin/docker-compose
-
Verifique la instalación escribiendo:
docker-compose --version
La salida se verá así:
docker-compose version 1.23.1, build b02f1306
Primeros pasos con Docker Compose #
En esta sección, mostraremos cómo usar Docker Compose para administrar una pila de WordPress en su máquina Debian 9.
Comience por crear un directorio para el proyecto y cámbielo:
mkdir wordpress_app
cd wordpress_app
Abra su editor de texto y cree un archivo llamado docker-compose.yml
dentro del directorio del proyecto:
nano docker-compose.yml
Pegue el siguiente contenido:
docker-compose.ymlversion: '3.3'
services:
db:
image: mysql:5.7
restart: always
volumes:
- db_data:/var/lib/mysql
environment:
MYSQL_ROOT_PASSWORD: password
MYSQL_DATABASE: wordpress
wordpress:
image: wordpress
restart: always
volumes:
- ./wp_data:/var/www/html
ports:
- "8080:80"
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_NAME: wordpress
WORDPRESS_DB_USER: root
WORDPRESS_DB_PASSWORD: password
depends_on:
- db
volumes:
db_data:
wp_data:
Entonces, ¿qué hace el código anterior?
En la primera línea, estamos especificando la versión del archivo Compose. Hay varias versiones diferentes del formato de archivo Compose con soporte para versiones específicas de Docker.
A continuación, estamos definiendo dos servicios, db
y wordpress
. Cada servicio ejecuta una imagen y creará un contenedor separado cuando se ejecute docker-compose.
El db
servicio:
- Utiliza
mysql:5.7
imagen. Si la imagen no está presente en su sistema, Compose la extraerá del repositorio público de Docker Hub. - Utiliza el reinicio
always
política que indicará al contenedor que siempre se reinicie. - Crea un volumen con nombre
db_data
para conservar la base de datos. - Define las variables de entorno para
mysql:5.7
imagen.
El wordpress
servicio:
- Utiliza
wordpress
imagen. Si la imagen no está presente en su sistema, Compose la extraerá del repositorio público de Docker Hub. - Utiliza el reinicio
always
política que indicará al contenedor que siempre se reinicie. - Monta el
wp_data
directorio en el host a/var/lib/mysql
dentro del contenedor. - Reenvía el puerto 80 expuesto en el contenedor al puerto 8080 en la máquina host.
- Define las variables de entorno para
wordpress
imagen. - El
depends_on
instrucción define la dependencia entre los dos servicios. En este ejemplo,db
se iniciará antes dewordpress
.
Desde el directorio del proyecto, inicie la aplicación de WordPress ejecutando el siguiente comando:
docker-compose up
La salida debería verse así:
...
wordpress_1_70f2f980e1fb | [Mon Nov 19 18:00:31.002748 2018] [mpm_prefork:notice] [pid 1] AH00163: Apache/2.4.25 (Debian) PHP/7.2.12 configured -- resuming normal operations
wordpress_1_70f2f980e1fb | [Mon Nov 19 18:00:31.002912 2018] [core:notice] [pid 1] AH00094: Command line: 'apache2 -D FOREGROUND'
Compose extraerá ambas imágenes, iniciará dos contenedores y creará wp_data
directorio en el directorio de su proyecto.
Introduce http://0.0.0.0:8080/
en su navegador y verá la pantalla de instalación de Wordpress.
En este punto, la aplicación de WordPress está funcionando y puede comenzar a trabajar en su tema o complemento.
Para detener Redactar, presione CTRL+C
.
También puede iniciar Compose en un modo separado pasando -d
bandera.
docker-compose up -d
Para verificar los servicios en ejecución, use ps
opción:
docker-compose ps
Name Command State Ports
----------------------------------------------------------------------------------
wordpress_app_db_1 docker-entrypoint.sh mysqld Up 3306/tcp, 33060/tcp
wordpress_app_wordpress_1 docker-entrypoint.sh apach ... Up 0.0.0.0:8080->80/tcp
Cuando Compose se ejecuta en modo separado para detener el uso de servicios:
docker-compose stop
Si desea eliminar los contenedores por completo, use down
opción:
docker-compose down
Pasando el --volumes
switch también eliminará los volúmenes de datos:
docker-compose down --volumes
Desinstalación de Docker Compose #
Si necesita desinstalar Docker Compose, simplemente puede eliminar el binario escribiendo:
sudo rm /usr/local/bin/docker-compose