Actividad clase: Deployment app

Prepara una maquina virtual servidor con docker (puedes usar una ya hecha) en un entorno virtual de una máquina host.

Docker architecture

Para esta práctica te recomiendo un Ubuntu Server conectado a otro ordenador host de tipo cliente.

A continuación te he preparado los pasos para realizar la práctica:

[2p] Web app 🖱️

Para estos dos puntos revisaré que funcione la web correctamente con sus funcionalidades.

La apliación web es la vuestra propia del primer proyecto, en caso de no tener proyectos, usa la que te proporciono.

-> La aplicación web escogida es una de asistencia escolar con un diseño algo feo, habrá que darle algo de color:

• Revisa los archivos descargados, deberías entender el código perfectamente.

• Descarga los archivos del campus y personaliza la app modificando el html y el css: añade algún subtitulo, modifica los colores, añade alguna imagen...

[2p] Repositorios con git 🎋

Primeramente nos toca aprender sobre git bash y su funcionamiento. Vamos ( de forma un poco redundante) a crear un repositorio y subir archivos por comandos:

• Instala git en el servidor, tienes más info sobre comandos y funcionamiento aquí.
• Crea un repositorio público en Github.
• Clona el repositorio en un directorio de la máquina cliente:

git clone "https://tu-repositorio-de-github"

• Añade los archivos de la aplicación web dentro de la carpeta del repositorio manualmente o con un cp o mv.

• Sube los archivos al repositorio añadiendo un comentario.

• Crea un archivo README.md si no existe donde aparezcan las instrucciones de como descargar y montar vuestra web.

• Enseña el enlace de Github con los archivos.

[3p] Crear la imagen y subirla al Hub 🐳

Vamos a crear una imagen de docker y subirla al repositorio oficial de docker para tener un historial de versiones y poder usarla en cualquier momento:

• Crea un repositorio público en Docker hub, llámalo como tu quieras y quédate con el nombre.
• Crea un archivo dockerfile en la misma carpeta del repositorio usando la imagen oficial de nginx con un touch o nano mismo y escribe lo siguiente modificando los parámetros necesarios:

# Usamos la imagen oficial de Nginx como base
FROM nginx

# Copiamos el archivo principal de HTML al directorio de contenido estático de Nginx
COPY index.html /usr/share/nginx/html

# Puerto en el que Nginx escuchará
EXPOSE XX

# Comando para iniciar Nginx en primer plano
CMD ["nginx", "-g", "daemon off;"]

Tienes más información sobre la semántica del dockerfile en la documentación oficial, quizás tengas que añadir algúna linea más así que revisad!

• Elige un nombre significativo para tu imagen (en este caso, mi-web-dockerizada).Ejecuta el siguiente comando para construir la imagen:

docker build -t mi-web-dockerizada .

• Ejecuta el contenedor nginx redireccionando el puerto que elegiste anteriormente.

docker run -d -p 8080:XX mi-web-dockerizada

• Comprueba el navegador para ver si la app funciona.

• Haz login con tu usuario en terminal:

docker login

• Antes de subir la imagen debes añadirle un tag (en este caso v1 pero pon lo que quieras) y le añadimos el prefacio con el usuario del hub:

docker tag mi-web-dockerizada:v1 nombrerepositorio/mi-web-dockerizada:v1

• Súbela con un pull a docker hub dentro de tu repositorio creado anteriormente:

docker push nombrerepositorio/mi-web-dockerizada:v1

• Vuelve a hacer un commit + push al respositorio de Github con el dockerfile.

[3p] Docker compose 🐙

Docker compose nos permitirá ejecutar varios contenedores a la vez y conectados entre si:

• ¡Antes de nada! para con stop el contenedor activo de la imagen anterior para que no interfiera.

• Instala docker compose sobre el servidor, tan sencillo como:

sudo apt install docker-compose

• Accede a una carpeta superior a la del proyecto o repositorio. Crea un archivo llamado docker-compose.yaml

• Descarga en otra carpeta el backup de la base de datos.

• Con un editor de texto (nano por ejemplo) edita el archivo yaml, añade la siguiente información rellenando los parámetros correspondientes:

docker-compose.yaml

version: '3.8'

services:
#Primer servicio, usa la imagen de mariadb
  mariadb:
    image: XXXXXXXXX
    restart: always
    #Variables de entorno de la imagen de MariaDB, la base de datos por defecto de la app es la que hay puesta:
    environment:
      MYSQL_ROOT_PASSWORD: root_password_here
      MYSQL_DATABASE: simple_attendance_db
      MYSQL_USER: my_user
      MYSQL_PASSWORD: my_password
    #Volúmenes docker
    volumes:
      #Base de datos en un docker volume (para evitar reinicios)
      - mariadb_data:/var/lib/mysql
      # Ruta-bakcup-base-datos:ruta-del-contenedor, modifica esto!
      - ./backup.sql:/docker-entrypoint-initdb.d/backup.sql
    
    web:
      #Imagen que acabamos de subir
      image: nombrerepositorio/mi-web-dockerizada:v1
      restart: always
      #Redireccion de puertos
      ports:
      - "8080:XX"

#Volumenes
volumes:
    db_data: {}

Hemos usado dos imágenes, la de MariaDB (más info aquí) pero puedes usar la de mysql si te da muchos problemas y la propia creada.

• Ejecuta el archivo de compose:

docker-compose up -d

• Revisa que contenedores están activos actualmente. Accede a la web a través de navegador con la IP y el puerto que has puesto en el yaml.

Antes de desesperaros revisad bien que las imágenes funcionen, yo te proporciono unos mínimos pero dependiendo de tu aplicación (sobre todo) debereis adaptaros a las circunstancias.