logongas

Herramientas de usuario

Herramientas del sitio

Ocultar Menú
Traza:
clase:daw:daw:tema05

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión		Revisión previa
clase:daw:daw:tema05 [2026/10/28 09:57] – borrado - editor externo (Fecha desconocida) 127.0.0.1clase:daw:daw:tema05 [2026/10/28 10:22] (actual) – Figura compose.yaml → docker compose up → imagen → contenedor al principio del tema claude
Línea 1: Línea 1:
 +====== 5. Docker: Compose ======
 +Docker Compose es una herramienta que permite definir y administrar aplicaciones Docker de múltiples contenedores. Utiliza un archivo [[https://es.wikipedia.org/wiki/YAML|YAML]] para configurar los servicios, las redes y los volúmenes, facilitando la definición y el despliegue de aplicaciones complejas.
 +
 +Con Compose las órdenes de [[clase:daw:daw:tema04#creacion_de_imagenes|crear imágenes y contenedores]] no se escriben a mano: ''docker compose up'' lee el fichero ''compose.yaml'' y, de cada servicio, descarga su imagen (''image:'') o la construye con su Dockerfile (''build:''). Después crea un contenedor por servicio.
 +
 +{{:clase:daw:daw-proyecto:docker-compose-esquema.png?800|docker compose up lee compose.yaml}}
 +
 +===== Estructura Básica de un archivo docker-compose.yml =====
 +
 +Un archivo ''docker-compose.yml'' define la configuración de una aplicación multi-contenedor. Aquí se presentan las secciones principales:
 +
 +<sxh>
 +services: 
 +  nombre_contenedor_1:
 +    image: imagen_servicio1
 +    restart: opciones si se reinicia el servidor
 +    hostname: nombre del host 
 +    volumes:
 +      - /ruta/host:/ruta/contenedor
 +    ports:
 +      - "puerto_host:puerto_contenedor"
 +    environment:
 +      - VARIABLE=valor
 +    tty: true
 +    stdin_open: true
 +    pull_policy: never
 +
 +  nombre_contenedor_2:
 +    # Configuración del segundo servicio
 +</sxh>
 +
 +
 +===== Comandos Básicos de Docker Compose =====
 +
 +  - Iniciar la aplicación basada en la configuración de ''docker-compose.yml''.
 +
 +<sxh bash>
 +docker compose up -d
 +</sxh>
 +
 +  - Detener y eliminar los contenedores definidos en el archivo ''docker-compose.yml''.
 +
 +<sxh bash>
 +docker compose down
 +</sxh>
 +
 +- Muestra el estado de los contenedores definidos en el archivo ''docker-compose.yml''.
 +
 +<sxh bash>
 +docker compose ps
 +</sxh>
 +
 +==== Ejemplo de Uso ====
 +
 +Supongamos un archivo ''docker-compose.yml'' para una aplicación web con un servicio de frontend y otro de base de datos:
 +
 +<sxh yaml>
 +
 +services:
 +  peliculas_java:
 +    image: temurin_peliculas
 +    restart: always
 +    hostname: peliculas_java
 +    volumes:
 +      - /opt/peliculas/target:/opt/app
 +    ports:
 +      - "80:8080"
 +  peliculas_mysql:
 +    image: mysql:8.3.0
 +    restart: always
 +    hostname: peliculas_java
 +    environment:
 +      - MYSQL_ROOT_PASSWORD=peliculas
 +      - MYSQL_DATABASE=peliculas
 +      - MYSQL_USER=peliculas
 +      - MYSQL_PASSWORD=peliculas
 +</sxh>
 +
 +Para iniciar esta aplicación, ejecutamos:
 +
 +<sxh>
 +docker compose up -d
 +</sxh>
 +
 +Esto levantará los contenedores de frontend y base de datos con la configuración especificada.
 +
 +Docker Compose simplifica la gestión de aplicaciones Docker complejas, permitiendo definir y coordinar múltiples servicios con facilidad.
 +
 +
 +
 +<note tip>Para pasar un script de docker al formato de docker compose se puede usar la herramienta: [[https://it-tools.tech/docker-run-to-docker-compose-converter]]</note>
 +
 +===== Construir las imágenes con Compose =====
 +Hemos visto que con ''docker compose up'' es como hacer un ''docker container run''. Pues resulta que también puede crear las imágenes con su ''Dockerfile'' antes de levantar los contenedores. Para ello, en el servicio se pone ''build:'' con el ''Dockerfile'' a usar y la carpeta de donde copia los ficheros:
 +
 +<sxh yaml>
 +services:
 +  peliculas_java:
 +    build:
 +      context: .
 +      dockerfile: Dockerfile.tienda-back
 +    restart: always
 +    hostname: peliculas_java
 +    volumes:
 +      - /opt/peliculas/target:/opt/app
 +    ports:
 +      - "80:8080"
 +</sxh>
 +
 +''docker compose up'' construye la imagen la primera vez. Para reconstruirla cuando cambia el código, [[#reconstruir_las_imagenes|Reconstruir las imágenes]].
 +
 +===== Reconstruir las imágenes =====
 +Cada vez que cambia el código hay que volver a crear las imágenes, y hacerlo sin más tiene tres problemas:
 +
 +  * **Las imágenes viejas llenan el disco**: al reconstruir una imagen con un nombre que ya existe, el nombre pasa a la nueva y la vieja se queda sin nombre, como ''<none>:<none>'' (es una imagen //dangling//). Queda una por cada despliegue.
 +  * **La caché de build llena el disco**: Docker guarda en una caché el resultado de cada orden del ''Dockerfile'' para no repetirla en el siguiente build. Guarda una copia en cada build, también con ''%%docker compose build --no-cache%%'': esa opción hace que no se reutilice la caché, no que no se guarde. Y no la recorta hasta que queda menos del 20% del disco libre. Cuánto ocupa se ve con ''docker buildx du''.
 +  * **La imagen no tiene el código nuevo**: ''docker compose up'' solo construye la imagen si no existe; si existe, la usa tal cual. Y aunque se reconstruya con ''docker compose build'' o ''%%docker compose up --build%%'', o se borre la imagen antes del ''up'', Docker reutiliza de la caché el resultado de un ''RUN'' si el texto de la orden no ha cambiado, sin ejecutarlo. ''%%RUN git clone ...%%'' es el mismo texto aunque haya commits nuevos en GitHub, así que la imagen se queda con el código del primer ''git clone''.
 +
 +Los tres se resuelven bajando todo, borrando las imágenes y la caché y volviendo a levantar:
 +
 +<sxh bash>
 +docker compose down --rmi local
 +docker buildx prune -f
 +docker compose up -d
 +</sxh>
 +
 +  * ''%%docker compose down --rmi local%%'': para y borra los contenedores y borra las imágenes que ha construido Compose, las de los servicios con ''build:''. Las que se descargan de DockerHub, como la de MySQL, se quedan. No lleva ''-v'', así que la base de datos se conserva.
 +  * ''docker buildx prune -f'': vacía la caché de build.
 +  * ''docker compose up -d'': como no encuentra las imágenes, las construye desde cero con el código actual y levanta los contenedores. No queda ninguna imagen sin nombre.
 +
 +<note>
 +''docker buildx prune -f'' vacía la caché de build de toda la máquina, no solo la de tu proyecto. En un servidor con varios ''compose.yaml'', los de los demás proyectos pueden tardar más en crear sus imágenes la próxima vez, porque ya no tienen la caché. No se rompe nada.
 +</note>