====== 8. Despliegue avanzado en Servidor ======
En el tema anterior vimos lo básico para empezar a usar Docker. En este tema vamos a ver aspectos mas avanzados de Docker y trucos a tener en cuenta para usarlo.

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 =====
Podemos crear nuestras propias imágenes si ninguna de las que hay hace lo que nosotros necesitamos. PAra ello usaremos el comando ''docker build''. 

El comando ''docker 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 build -t nombre_imagen:etiqueta ruta_del_dockerfile
</sxh>

Donde:
  - **-t nombre_imagen:etiqueta**: Nombre y tag de la imagen que se va a crear
  - **ruta_del_dockerfile**: Ruta al directorio que contiene el Dockerfile. Lo normal es estar en el directorio donde está el fichero ''Dockerfile'' por lo que sea pondrá un punto indicando que es el directorio actual.

  * Ejemplo de uso: Crea la imagen llamada ''mi_aplicacion_web:1.0'' sabiendo que el fichero ''Dockerfile'' está en la carpeta actual.
<sxh>
docker build -t mi_aplicacion_web:1.0 .
</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 base>
# 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

# Expone un puerto en 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 /opt/peliculas/target/japp.jar /opt/app
</sxh>




- **EXPOSE**: Informa a Docker que el contenedor escuchará en el puerto especificado en tiempo de ejecución. No publica el puerto en el host.

<sxh>
EXPOSE 8080
</sxh>

- **WORKDIR**: Establece el directorio de trabajo para cualquier instrucción posterior en el Dockerfile.

<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. 

<sxh>
CMD ["java", "-jar","/opt/app/japp.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 
  * Copia el fichero de la máquina real que está en ''/opt/peliculas/target/japp.jar'' dentro de loa imagen en la carpeta ''/opt/app''
  * Ejecuta el japp.jar

<sxh base>
FROM eclipse-temurin:17.0.10_7-jdk
RUN mkdir /opt/app
COPY /opt/peliculas/target/japp.jar /opt/app
CMD ["sh", "-c" , "-jar","/opt/app/japp.jar"]
</sxh>


===== 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.

==== 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>
version: '3' 

services: 
  servicio1:
    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

  servicio2:
    # 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
</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>
version: '3'

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
</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>


===== Gestión de Redes =====
Docker permite crear redes aisladas entre los distintos contenedores. De esa forma , si un contenedor es atacado, no se tendrá acceso por red al resto de los contenedores sino únicamente a los de su propia red.

^  Orden  ^  Explicación  ^
| [[https://docs.docker.com/engine/reference/commandline/network_create/|docker network create]] | Crea una red |
| [[https://docs.docker.com/engine/reference/commandline/network_rm/|docker network rm]] | Borrar una red |
| [[https://docs.docker.com/engine/reference/commandline/network_ls/|docker network ls]] | Ver las redes que hay |
| [[https://docs.docker.com/engine/reference/commandline/network_connect/|docker network connect]] | Conecta un contenedor a una red |
| [[https://docs.docker.com/engine/reference/commandline/network_disconnect/|docker network disconnect]] | Desconecta un contenedor de una red |


Para trabajar con redes, lo que debemos hacer es

  * Primero crear la red:

  docker network create nombreDeLaRed

  * Conectar un contenedor a esa red

  docker network connect nombreDeLaRed nombreDelContenedor

  * También podemos conectar la red al contenedor al usar ''docker container run'' con la opción ''--network=nombreDeLaRed''

  docker container run \
   -dit \
   -v /opt/mariadb:/var/lib/mysql  \
   -e MYSQL_ROOT_PASSWORD=root  \
   -p 4000:3306  \
   --network nombreDeLaRed \
   --name  prueba_mariadb \
   mariadb:10.1

\\
\\
\\


===== Proxy con Nginx =====
¿Recuerdas la cabecera ''Host'' de HTTP? Servía para indicar a que //servidor web// iba dirigida la petición ya que en una misma máquina se ponían varios servidores web.

Pues vamos ahora a configurar Docker para que todos los servidores compartan el mismo puerto (el 80). Para ello vamos a usar un servidor proxy llamado Nginx. Obviamente, Nginx va estar dentro de otro contenedor de Docker. La imagen a usar es [[https://hub.docker.com/r/jwilder/nginx-proxy|jwilder/nginx-proxy con tag 0.7.0]].

Para arrancar el servidor usamos la siguiente orden:

  sudo docker container run \
    -dit \
    -p 80:80 \
    --restart always \
    -v /var/run/docker.sock:/tmp/docker.sock:ro \
    --name nginx-proxy \
    nginxproxy/nginx-proxy:1.1.0 
    

   
    

Como vemos no tiene nada de especial excepto la línea ''-v /var/run/docker.sock:/tmp/docker.sock:ro'' pero solo decir que es para que Nginx pueda acceder al Docker real de la máquina real.

Y ahora , ¿Como arrancamos nuestro servidores web? Pues simplemente hay que añadir dos parámetros y quitar uno.
  * Y hay que quitar el parámetro de ''-p puertoExterno:puertoInterno'' ya que ahora el contenedor no se va a exponer al exterior. 
  * Hay que añadir:
    * ''-e VIRTUAL_PORT=puertoInterno'': Siendo **puertoInterno** donde está escuchando nuestro servidor Web. Esa información la sabremos por la documentación 
    * ''-e VIRTUAL_HOST=nombreDominio'': Siendo **nombreDominio** el nombre del dominio que queremos que gestione el servidor que estamos arrancando.

Veamos el siguiente ejemplo:

  sudo docker container run \
    -dit \
    -v /home/alumno/lorenzo/httpd:/var/www/html \
    -e VIRTUAL_PORT=80
    -e VIRTUAL_HOST=lorenzo.daw2.pve3.fpmislata.com  \
    --name lorenzo_apache \
    php:8.1-apache-bullseye

Vemos que el servidor está escuchando en el puerto 80 y va a gestionar las peticiones del dominio //lorenzo.daw2.pve3.fpmislata.com// que lleguen a Nginx.


<note tip>Los servidores de Base de datos u otros contenedores que no son el servidor web no tienen que hacer nada especial por usar Nginx ya que no se accede a ellos a través del proxy sino directamente a ellos o únicamente de forma interna.</note>


Mas información:
    * [[https://cloud.google.com/community/tutorials/nginx-reverse-proxy-docker|Running an NGINX Reverse Proxy with Docker and Let's Encrypt on Google Compute Engine]]
    * [[http://jasonwilder.com/blog/2014/03/25/automated-nginx-reverse-proxy-for-docker/|Automated Nginx Reverse Proxy for Docker]]
    * [[https://tevinjeffrey.me/how-to-setup-nginx-proxy-and-lets-encrypt-with-docker/|How to setup NGINX with automatic HTTPS in Docker]]
    * [[https://medium.com/@francoisromain/host-multiple-websites-with-https-inside-docker-containers-on-a-single-server-18467484ab95|Host multiple websites with HTTPS on a single server]]



==== El fichero hosts ====
Ahora para que funcione el proxy con nginx ya no podemos acceder a la máquina real con la IP sino que habrá que usar el nombre de dominio. Si no tenemos acceso a un nombre de dominio real, podemos simular nosotros uno modificando el fichero ''hosts'' de la máquina donde vayamos a hacer la petición.

El fichero hosts simplemente contiene IPs y nombre e dominio que usará nuestro ordenador. De esa forma simularemos tener un dominio.

En los siguientes artículos se explica como modificar el fichero hosts
  * [[https://es.wikipedia.org/wiki/Archivo_hosts|Archivo hosts]]
  * [[https://www.siteground.es/kb/archivo-hosts/|¿Cómo se usa el archivo “hosts”?]]



\\
\\
\\









===== 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 jara 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 en el apartado de [[clase:daw:daw:1eval:tema03#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''