Diferencias

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

--- clase:daw:daw:tema04 [2026/10/28 09:57] – borrado - editor externo (Fecha desconocida) 127.0.0.1
+++ clase:daw:daw:tema04 [2026/10/28 10:20] (actual) – Figura Docker Hub/Dockerfile → imagen → contenedor en «Creación de imágenes» claude
@@ Línea 1: / Línea 1: @@
+====== 4. Docker: Creación de imágenes. Dockerfile ======
+En el apartado anterior vimos lo básico para empezar a usar Docker. En este apartado vamos a ver como crear nuestras propias imágenes.
+Mas información:
+  * {{docker_performance.pdf|An Updated Performance Comparison of Virtual Machines and Linux Containers}}
+  * [[https://docs.docker.com/engine/tutorials/dockerimages/|Build your own images]]
+  * [[https://www.adictosaltrabajo.com/tutoriales/docker-for-dummies/|Docker for dummies]]
+  * [[https://www.atareao.es/tutorial/docker/logs-en-docker/|Logs en Docker]]
+  * [[http://networkstatic.net/10-examples-of-how-to-get-docker-container-ip-address/|10 Examples of how to get Docker Container IP Address]]
+===== Creación de imágenes =====
+Un contenedor se crea desde una imagen, y la imagen se descarga ya hecha de Docker Hub (''docker image pull'') o se construye con un Dockerfile (''docker buildx build''). En el tema anterior vimos el primer camino; en este, el segundo.
+{{:clase:daw:daw-proyecto:docker-imagen-contenedor.png?800|Docker Hub o Dockerfile → imagen → contenedor}}
+Podemos crear nuestras propias imágenes si ninguna de las que hay hace lo que nosotros necesitamos. Para ello usaremos el comando ''docker buildx build''.
+El comando ''docker buildx build'' se utiliza para construir imágenes de contenedor Docker a partir de un Dockerfile. A continuación se presentan las principales características y uso de este comando.
+<sxh>
+  docker buildx build --tag nombre_imagen:etiqueta --file ruta_del_dockerfile ruta_contexto_ficheros
+</sxh>
+Donde:
+  - ''--tag  nombre_imagen:etiqueta'': Nombre y tag de la imagen que se va a crear
+  - ''--file ruta_del_dockerfile'': Ruta al fichero que contiene el Dockerfile. Si no se indica se usará el fichero ''Dockerfile'' del directorio actual.
+  - ''ruta_contexto_ficheros'': Ruta donde se encuentran los ficheros a copiar dentro de la imagen. Esto es importante ya que las rutas absolutas del ''COPY'' empiezan en ''/ruta/al/contexto''
+  * Ejemplo de uso: Crea la imagen llamada ''mi_aplicacion_web:1.0'' sabiendo que el fichero ''Dockerfile'' está en la carpeta actual y los ficheros a copiar están en el directorio ''./src''.
+<sxh>
+docker buildx build -t mi_aplicacion_web:1.0 ./src
+</sxh>
+===== Estructura Básica del Dockerfile =====
+Un Dockerfile contiene instrucciones para la construcción de una imagen. Aquí se muestra una estructura básica:
+<sxh>
+# Especifica la imagen base
+FROM imagen_base:version
+# Instrucciones para configurar la imagen
+RUN comando1
+RUN comando2
+# Copia archivos locales al contenedor
+COPY origen destino
+# Documenta que puerto usa el contenedor
+EXPOSE puerto
+#El directorio de trabajo
+WORKDIR /directorio
+# Define variables de entorno
+ENV variable=valor
+# Comando para ejecutar la aplicación o servicio
+CMD ["comando", "argumento"]
+</sxh>
+- **FROM**: Indica la imagen base desde la cual se construirá la nueva imagen. La versión es opcional.
+<sxh>
+FROM eclipse-temurin:17.0.10_7-jdk
+</sxh>
+- **RUN**: Ejecuta comandos en una nueva capa del contenedor. Se utiliza para instalar paquetes, configurar el entorno y realizar otras acciones durante la construcción de la imagen.
+<sxh>
+RUN mkdir /opt/app
+</sxh>
+- **COPY**: Copia archivos desde la ruta de origen en la máquina host hacia el contenedor en la ruta de destino.
+<sxh>
+COPY ./app.jar /opt/app
+</sxh>
+<note warning>
+La ruta absoluta del origen del copia es a partir de la ruta ''ruta_al_contexto'' del comando de buildx
+</note>
+<note important>
+¿Qué es mejor copiar ficheros dentro con ''COPY'' o que la propia imagen  los descargue con una comando ''RUN''?
+^ Opción ^  Ventaja  ^  Desventaja  ^
+| Copiar ficheros desde fuera con ''COPY'' |  Siguen estando aunque desparezcan de internet  |  Para crear la imagen es necesario que lo hayamos descargado previamente  |
+| Descargar ficheros desde el ''RUN''  |  No necesitas descargar nada previamente y es más cómodo  |  No podrás crear la imagen si desaparecen esos ficheros de internet.  |
+</note>
+- **EXPOSE**: Informa a Docker que el contenedor escuchará en el puerto especificado en tiempo de ejecución. No publica el puerto en la máquina real ni hace realmente nada. Es simplemente para documentar en que puerto
+<sxh>
+EXPOSE 8080
+</sxh>
+- **WORKDIR**: Establece el directorio de trabajo para cualquier instrucción posterior en el Dockerfile. Se usando tanto para crear la imagen como en el contenedor.
+<sxh>
+WORKDIR /opt/app
+</sxh>
+- **ENV**: Define variables de entorno dentro del contenedor.
+<sxh>
+ENV ENTORNO=produccion
+</sxh>
+- **CMD**: Especifica el comando predeterminado que se ejecutará cuando el contenedor se inicie. **Solo puede haber una comando ''CMD''**
+<sxh>
+CMD ["java", "-jar","/opt/app/app.jar"]
+</sxh>
+<note tip>
+Las diferencias entre ''RUN'' y ''CMD'' es que ''RUN'' se ejecuta cuando se crea la imagen con el comando ''docker build'' ,es decir configurándola mientras que ''CMD'' se ejecuta cuando se crea el contenedor con el comando ''docker container run''
+</note>
+===== Ejemplo: Ejecutar app java =====
+Una imagen basada en el JDK 17 que ya incluye maven.
+Al crear la imagen se hace lo siguiente
+  * Instalar Git
+  * Descargar el código fuente
+  * Compilar
+Al arrancar el contenedor se ejecuta
+  * ''java -jar target/tienda-back-0.0.1-SNAPSHOT.jar''
+<sxh>
+FROM maven:3.9.11-eclipse-temurin-21-noble
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update
+RUN apt-get install -y git
+RUN mkdir /opt/app
+WORKDIR /opt/app
+RUN git clone https://github.com/lgonzalezmislata/tienda-back.git
+WORKDIR /opt/app/tienda-back
+RUN mvn clean install
+EXPOSE 8080
+CMD ["java","-jar", "target/tienda-back-0.0.1-SNAPSHOT.jar"]
+</sxh>
+Para crear la imagen ejecutamos
+<sxh bash>
+docker buildx build --no-cache --tag tienda-back:1.0 .
+</sxh>
+<note important>
+Sin ''%%--no-cache%%'' la imagen se quedaría con el código del primer ''git clone'', aunque haya commits nuevos. Por qué, y cómo se reconstruye bien con Docker Compose: [[.:tema05#reconstruir_las_imagenes|Reconstruir las imágenes]].
+</note>
+Finalmente la ejecutamos con
+<sxh bash>
+docker container run -p 8081:8080 --name tienda-back tienda-back:1.0
+</sxh>
+====== Multiples imagenes ======
+Acabamos de ver que hemos tenido la suerte de tener una imagen con el JDK y con maven pero no siempre tenemos esa suerte.
+Para Angular necesitamos hacer el build con una imagen que tenga NodeJS pero tambien que tenga NGINX.
+Podemos construir una imagen con todo ello pero lo más sencillo es una 2 imágenes distintas y copiar el resultado de uno en el otro.
+Vamos a ver ahora como un ''Dockerfile'' puede ser con 2 imágenes de forma que el resultado de una se copie a la otra.
+  * Imagen con NodeJS para compilar el código de Angular
+  * Imagen con NGINX que hace de servidor HTTP para desplegar la aplicación
+<sxh yml;highlight:[1,15,16]>
+FROM node:22.19.0 AS build
+RUN apt-get update
+RUN apt-get install -y git
+RUN mkdir /opt/app
+WORKDIR /opt/app
+RUN git clone https://github.com/lgonzalezmislata/tienda-front.git
+WORKDIR /opt/app/tienda-front
+RUN npm ci
+RUN npm run build --prod
+FROM nginx:1.28.0-alpine3.21
+COPY --from=build /opt/app/tienda-front/dist/tienda-front/browser/ /usr/share/nginx/html
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]
+</sxh>
+  * En la línea 1 vemos como se usa la imagen ''node:22.19.0'' y la llamamos ''build''
+  * En las siguientes lineas compilamos el código de Angular
+  * En la línea 15 se crea una nueva imagen ''nginx:1.28.0-alpine3.21''
+  * En la línea 16 es cuando se copia el código compìlado de Angular desde la imagen ''build'' a la imagen de NGINX. Notar que se usa ''--from=build'' para indicar que es desde la primera imagen. ¿Y como sabemos que hay que copiar las cosas en ''/usr/share/nginx/html''? Pues mirando en [[https://hub.docker.com/_/nginx/]]
+<note tip>Al concatenar las 2 imágenes únicamente que crea la segunda.</note>
+Para crear la imagen ejecutamos
+<sxh bash>
+docker buildx build --no-cache --tag tienda-front:1.0 .
+docker image prune -f
+</sxh>
+''docker image prune -f'' borra la imagen anterior, que al crear otra con el mismo nombre se queda sin nombre (''<none>:<none>''). Está explicado en [[.:tema05#reconstruir_las_imagenes|Reconstruir las imágenes]].
+Finalmente la ejecutamos con ''docker compose'' o con
+<sxh bash>
+docker container run -p 80:80 --name tienda-front tienda-front:1.0
+</sxh>
+===== Ejercicios =====
+==== Ejercicio 1:Crear la imagen ====
+Crea una imagen de docker basada en ''eclipse-temurin:17.0.10_7-jdk'' que haga lo siguiente:
+  * Con ''RUN'':Crear el directorio ''/opt/app''.
+  * Con ''CMD'':Que ejecute un jar llamado ''japp.jar''
+La imagen se llamará ''tu-nombre-java-app''.
+Crea un contenedor con esa imagen de forma que con ''-v'' esté el ''japp.jar'' en ''/opt/app''
+==== Ejercicio 2:Sin crear imagen ====
+En la imagen ''eclipse-temurin:17.0.10_7-jdk'' ya existe la carpeta ''/tmp'' y en ''docker container run'' se puede poner al final de la línea la orden a ejecutar.
+Así que ejecuta un ''jar'' de la siguiente manera:
+<sxh base>
+sudo docker container run \
+	-v /mi-proyecto/target:/tmp \
+	eclipse-temurin:17.0.10_7-jdk \
+	java -jar /tmp/mi.jar
+</sxh>
+<note important>
+En la orden ''docker container run'' faltan más parámetros que hay que añadir.
+</note>
+==== Ejercicio 3:Maven ====
+Ahora vamos a generar el ''jar'' en base al código fuente, para ello vamos a usar una imagen que ya tiene ''maven'' instalado: [[https://hub.docker.com/_/maven|Docker image maven]] y concretamente  ''maven:3.9.6-eclipse-temurin-17''.
+Para hacerlo hay que poner el código fuente en ''/usr/src/mymaven'' y especificar que el directorio de trabajo será ese, para ello usaremos el argumento ''-w''. Al final del todo indicaremos la orden de maven a ejecutar.
+<sxh base>
+sudo docker container run \
+	-v /mi-proyecto:/usr/src/mymaven \
+	-w /usr/src/mymaven \
+	maven:3.9.6-eclipse-temurin-17 \
+	mvn clean package
+</sxh>
+<note important>
+En la orden ''docker container run'' faltan más parámetros que hay que añadir.
+</note>
+<note tip>
+¿Que opciones usarás?
+  * ''-d''
+  * ''-i''
+  * ''-t''
+  * ????
+</note>
+==== Ejercicio 4:Deploy ====
+Has un script en la máquina real llamado ''deploy.sh'' que haga lo siguiente:
+  * Se baje el código fuente de git
+  * Genere el ''jar'' pero se ejecutará maven dentro del contenedor de docker cuya imagen es: ''maven:3.9.6-eclipse-temurin-17''
+  * Ejecute el ''jar''  dentro del contenedor de docker cuya imagen es: ''eclipse-temurin:17.0.10_7-jdk''
+==== Ejercicio 5:MySQL ====
+Crea ahora una base de datos MySQL en un contenedor docker de forma que sea la que estás usando en el módulo de servidor.
+Rellena la base de datos con los datos.
+==== Ejercicio 6:Deploy proyecto ====
+Compila y desplega el proyecto que usas en el módulo de servidor de forma que se genere el ''jar'' en un contenedor de  docker y se ejecute en un contenedor de  docker. Este último contenedor deberá conectarse al contenedor de MySQL que has creado.
+==== Ejercicio 7:Deploy proyecto ====
+Modifica el proyecto de Maven de forma que tambien se haga lo necesario para "compilar" la parte de Angular. Esa parte la vimos en el tema 3 de Proyecto, en el apartado [[clase:daw:proyecto:1eval:tema03#automatizar_maven|Automatizar Maven]]
+<note tip>
+Hasta aquí han sido los ejercicios para el despliegue automático, ahora vamos a mejorar cuestiones relacionadas con Docker.
+</note>
+==== Ejercicio 8: MySQL compañero ====
+Prueba ahora a modificaar el código de forma que te conectes al MySQL de tu compañero. Deberá dejarte.
+==== Ejercicio 9:Red ====
+Crea ahora una red llamada ''mi-nombre-mi-proyecto''.
+Modifica la creación de los contenedores para que estén asociados a la red que acabas de crear.
+Prueba que todo sigue funcionando.
+==== Ejercicio 10: MySQL compañero ====
+Prueba ahora a modificaar el código de forma que te conectes al MySQL de tu compañero. No debería dejarte ya que estáis en redes distintas.
+==== Ejercicio 11: Docker compose ====
+Modifica el script ''deploy.sh'' de forma que en vez de crear directamente los 2 contenedores de MySQL y Java se use  ''docker compose up''.
+Para ello deberás crear un fichero llamado ''docker-compose.yml''