Levantar una aplicación Java (Servlet) desplegada en Tomcat y conectada a MySQL, todo en contenedores Docker, sin frameworks y sin docker-compose.

Requisitos

• Docker instalado y funcionando.
• Tu aplicación empaquetada como WAR (ej: miapp.war).
• Una carpeta de proyecto en tu PC (host).

Estructura del proyecto (en el host)

Crea una carpeta de trabajo, por ejemplo:

mkdir -p ~/proyecto-jee-docker
cd ~/proyecto-jee-docker
mkdir -p deploy

Copia tu WAR dentro de deploy/:

cp /RUTA/AL/WAR/miapp.war ./deploy/

Crear una red Docker para que se vean por nombre

Esto permite que Tomcat encuentre MySQL usando el nombre del contenedor.

docker network create red-jee

Levantar MySQL con volumen (persistencia)

2.1 Crear volumen para MySQL

docker volume create mysql_data

2.2 Lanzar el contenedor MySQL

⚠️ Cambia passwords y nombre de BD si quieres, pero respeta la idea.

docker run -d \
  --name mysql-jee \
  --network red-jee \
  -e MYSQL_ROOT_PASSWORD=root1234 \
  -e MYSQL_DATABASE=appdb \
  -e MYSQL_USER=appuser \
  -e MYSQL_PASSWORD=app1234 \
  -v mysql_data:/var/lib/mysql \
  -p 3307:3306 \
  mysql:8.0

Qué hace esto:

• --network red-jee → MySQL estará accesible desde Tomcat por hostname mysql-jee
• -v mysql_data:/var/lib/mysql → los datos sobreviven aunque borres el contenedor
• -p 3307:3306 → MySQL será accesible desde tu PC en localhost:3307 (evita conflictos si tu 3306 está ocupado)

2.3 Comprobar que MySQL está arriba

docker psdocker logs mysql-jee --tail30

Crear tablas y datos de prueba (dentro del contenedor)

Entra a MySQL dentro del contenedor:

docker exec -it mysql-jee mysql -u root -p

Escribe la contraseña root1234.

Luego (ejemplo genérico), crea una tabla y mete algo.

Preparar el contenedor Tomcat y desplegar el WAR

Ejecutar Tomcat y montar tu WAR (sin construir imagen propia)

Opción simple: montas la carpeta deploy en webapps.

docker run -d \
  --name tomcat-jee \
  --network red-jee \
  -p 8080:8080 \
  -v "$PWD/deploy:/usr/local/tomcat/webapps" \
  tomcat:10.1-jdk17

Qué hace esto:

• -p 8080:8080 → accedes en http://localhost:8080
• -v .../webapps → Tomcat “ve” tu WAR y lo despliega al arrancar

4.2 Ver logs de Tomcat (muy importante)

docker logs -f tomcat-jee

Busca líneas tipo “Deploying web application archive … miapp.war”.

5) Configurar la conexión a MySQL en tu Java (punto clave)

Dentro de Docker, NO uses localhost para MySQL desde Tomcat.
Debes usar el nombre del contenedor:

• Host: mysql-jee
• Puerto interno: 3306
• BD: appdb
• User: appuser
• Pass: app1234

Ejemplo de URL JDBC:

jdbc:mysql://mysql-jee:3306/appdb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC

✅ Si tu app usa un fichero de configuración (properties), ajusta eso.

Ejemplo (si usas Properties):

db.url=jdbc:mysql://mysql-jee:3306/appdb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC
db.user=appuser
db.pass=app1234

Nota: si tu WAR ya estaba compilado con localhost, toca recompilar con mysql-jee.

6) Probar la aplicación desde el navegador

1. Entra a tu app (depende del nombre del WAR):

• Si el WAR se llama miapp.war, normalmente será:
  • http://localhost:8080/miapp/

2. Prueba el endpoint del servlet que devuelve JSON:

• Ejemplo:
  • http://localhost:8080/miapp/api/items

7) Verificar el fetch() y el DOM (JS)

Tu JavaScript hará algo así:

fetch('/miapp/api/items')
  .then(r => r.json())
  .then(data => {
    // pintar DOM
  });

Errores típicos

• 404 en fetch → la ruta no coincide con el url-pattern del servlet.
• El fetch devuelve HTML en vez de JSON → estás pegando a una ruta que devuelve una página, no el endpoint.
• CORS: si sirves el HTML desde Tomcat y llamas al servlet en el mismo host/puerto, normalmente no hay CORS.
  CORS aparece si llamas a otro host/puerto distinto.

8) Comandos útiles de operación (vida real)

Ver contenedores

docker ps
docker ps-a

Parar / arrancar

docker stop tomcat-jee mysql-jee
docker start mysql-jee
docker start tomcat-jee

Entrar a un contenedor

docker exec -it tomcat-jee bash
docker exec -it mysql-jee bash

Ver redes y comprobar nombres

docker network ls
docker network inspect red-jee

9) Reinicio limpio (sin perder datos)

Si quieres borrar Tomcat y recrearlo (sin perder DB):

docker rm -f tomcat-jee
docker run -d \
  --name tomcat-jee \
  --network red-jee \
  -p 8080:8080 \
  -v "$PWD/deploy:/usr/local/tomcat/webapps" \
  tomcat:10.1-jdk17

La BD se conserva porque está en el volumen mysql_data.

Resumen de pasos a realizar:

• He creado red-jee
• He creado el volumen mysql_data
• He levantado mysql-jee y responde
• He creado tablas y datos en appdb
• He levantado tomcat-jee con el WAR montado
• La app carga en http://localhost:8080/...
• El servlet devuelve JSON válido
• El fetch() recibe JSON y pinta en el DOM

Reto1

– Crear un contenedor docker de ubuntu.
– Instalar python, la libreria request y de mysql
– Crear una imgane personalizada con el contenedor

Reto 2

• Crear un contenedor nuevo con la imagen personalizada  de docker
• Este contenedor tendra un volumen con una ruta en el disco del anfitrión (Bind)

Reto 3

• Crear un repositorio git en la carpeta del anfitrión y unirlo con un repositorio en Github

Reto 4

• Crear un contenedor mysql.
• Crear una base de datos, para almacenar Coches. Los campos seran id, marca, modelo, color, km y precio
• añadir almenos 10 coches a modo de contenido de muestra.

Reto 5 

• Crear en el repositorio Local un programa en python que se conecte a la base de datos y obtenga los registros de la mase de datos.
  – El programa debe listar los datos de los coches guardados en la base de datos de forma estetica.

ID    MARCA          MODELO         COLOR     KM        PRECIO    
————————————————————————
1     Toyota             Corolla              Blanco    20000     15000     
2     Honda              Civic                Rojo        30000     17000     
3     Ford                  Focus               Azul       25000     16000     

Reto 6

• Almacenar los datos de conexion a la base de datos en un archivo JSON y que el programa Python los lea de dicho archivo. 
  * crear un nuevo archivo para la modificación.
  * Realiza un commit en cada paso
• crear el .gitignore para que no suba el archivo con los datos de conexión.

Reto 7

Formatear la tabla para que quede mas estetica con la libreria 

+—-+——–+———+——-+————-+——–+
| ID | Marca  | Modelo  | Color | Kilometraje  | Precio |
+—-+——–+———+——-+————-+——–+
| 1  | Toyota | Corolla | Rojo  | 25000        | 15000  |
| 2  | Honda  | Civic   | Azul  | 30000        | 18000  |
| 3  | Ford   | Focus   | Blanco| 40000        | 17000  |
+—-+——–+———+——-+————-+——–+

Reto 8

Crear un conetenedor Mongo y conectarse desde la terminal y utilizando MongoDB
Crea la una bd e inserta en una colecci’on coches con el criterio de de campos del reto anterior
Crear un Script de Python  para leer los datos de colecciones de MongoDB y los imprima en una tabla.

Reto 9

Subir una imagen personaliza de nuestro contenedor mongodb al  hub de Docker.
En el Linux Parrot montar un contenedor con la imagen subida al hub.

Documento de ayuda y pistas para los retos

🚀 RETO 1 — Tu primer contenedor personalizado

Objetivo

Crear un contenedor Ubuntu con Python y librerías necesarias, y convertirlo en una imagen reutilizable.

Pistas

Según la guía visual del PDF (pág. 1), debes:

• Ejecutar un contenedor Ubuntu
• Instalar:
  • python3
  • pip
  • requests
  • cliente MySQL

Después crea una imagen personalizada con:

docker commit <contenedor> mi-imagen-personalizada

✅ Checkpoint

Debes poder ver tu imagen con:

docker images

🚀 RETO 2 — Persistencia con Bind Mount

Objetivo

Crear un nuevo contenedor usando la imagen anterior y asociarlo a una carpeta del host.

📌 En la página 2 del PDF se muestra cómo activar modo interactivo y configurar el volumen.

Ejemplo conceptual:

docker run -it -v /ruta/host:/ruta/contenedor mi-imagen

¿Por qué es importante?

Si borras el contenedor, los datos seguirán vivos.

Bienvenido al mundo real.

✅ Checkpoint

Crea un archivo dentro del contenedor y verifica que aparece en el host.

🚀 RETO 3 — Control de versiones

Objetivo

Versionar tu carpeta de trabajo y conectarla a GitHub.

Tal como aparece en la página 3 del PDF:

1️⃣ Inicializa Git
2️⃣ Crea un repositorio en GitHub
3️⃣ Ejecuta:

git add .
git commit -m "Inicio del laboratorio"
git remote add origin <repo>
git push -u origin main

✅ Checkpoint

Tu repositorio debe contener al menos:

• scripts
• documentación
• archivos de configuración

🚀 RETO 4 — MySQL en contenedor

Objetivo

Levantar un contenedor MySQL y crear una base de datos de coches.

Campos:

• id
• marca
• modelo
• color
• km
• precio

Inserta mínimo 10 registros.

📌 La página 4 del PDF muestra la configuración del contenedor.

✅ Checkpoint

Debe funcionar:

SELECT * FROM coches;

🚀 RETO 5 — Python contra la base de datos

Objetivo

Crear un script que lea los coches desde MySQL.

Las páginas 5–7 del PDF enseñan:

• conexión con mysql.connector
• uso de cursor
• fetchall()

Ejemplo conceptual:

cursor.execute("SELECT * FROM coches")
for coche in cursor.fetchall():
    print(coche)

⚠️ Problema común

En la página 9 se menciona un conflicto con el conector de MySQL en Ubuntu.

Solución alternativa:

pip install mysql-connector-python --break-system-packages

✅ Checkpoint

El script debe mostrar registros sin errores.

🚀 RETO 6 — Seguridad básica

Objetivo

Separar credenciales en un archivo JSON.

Después:

✔ Leer ese archivo desde Python
✔ Crear .gitignore
✔ Evitar subir credenciales

✅ Checkpoint

Tu repo NO debe contener:

config.json
.env
credenciales

🚀 RETO 7 — Salida profesional

Objetivo

Mostrar los datos en formato tabla.

En la página 10 se recomienda usar:

apt install python3-prettytable

Ejemplo:

from prettytable import PrettyTable

✅ Checkpoint

La salida debe parecer una tabla real, no texto desordenado.

🚀 RETO 8 — MongoDB entra en escena

Ahora pasamos a bases de datos NoSQL.

Según las páginas 12–16:

Debes:

• Crear contenedor Mongo
• Definir usuario y contraseña
• Crear BD
• Insertar coches
• Consultar datos

Acceso desde terminal:

docker exec -it <contenedor> bash
mongosh -u usuario -p password --authenticationDatabase admin

✅ Checkpoint

Debe funcionar:

db.coches.find().pretty()

🚀 RETO 9 — Python + MongoDB

Instala pymongo (pág. 18):

apt install python3-pymongo

Conecta y recorre la colección.

Después muestra los datos en tabla (pág. 20).

✅ Checkpoint

Debes tener:

• script funcional
• salida formateada
• conexión estable

🚀 RETO FINAL — Publica tu imagen

Sube tu imagen de Mongo personalizada a Docker Hub.

Después:

👉 descárgala desde otra máquina (por ejemplo Parrot)
👉 levanta el contenedor

Si funciona…

Acabas de reproducir un flujo profesional real.

• Desplegar MySQL y phpMyAdmin con docker compose
• Usar volumen para persistencia
• Verificar conexión y datos
• Practicar variables de entorno, puertos y reinicios

1) Estructura del proyecto

Crea una carpeta de práctica:

mkdir mysql-pma-compose
cd mysql-pma-compose

2) Crear el archivo docker-compose.yml

Crea el fichero:

# Define los servicios (contenedores) que vamos a ejecutar
services:

  # ----- SERVICIO MYSQL -----
  mysql:
    image: mysql:8.0              # Imagen oficial que se descargará de Docker Hub
    container_name: mysql1        # Nombre fijo del contenedor (opcional, pero útil)
    restart: unless-stopped       # Reinicia el contenedor automáticamente salvo que lo pares tú

    # Variables de entorno que usa la imagen de MySQL en su primer arranque
    environment:
      MYSQL_ROOT_PASSWORD: "RootPass_123!"   # Contraseña del usuario root
      MYSQL_DATABASE: "academia"             # Base de datos que se crea automáticamente
      MYSQL_USER: "alumno"                   # Usuario adicional que se creará
      MYSQL_PASSWORD: "AlumnoPass_123!"      # Contraseña del usuario alumno

    # Volúmenes → permiten persistencia (los datos sobreviven aunque borres el contenedor)
    volumes:
      - mysql_data:/var/lib/mysql   # Guarda los datos reales de MySQL fuera del contenedor

    # Conecta el contenedor a una red Docker interna
    networks:
      - red-bbdd


  # ----- SERVICIO PHPMYADMIN -----
  phpmyadmin:
    image: phpmyadmin:latest        # Imagen oficial de phpMyAdmin
    container_name: pma1
    restart: unless-stopped

    # Indica que MySQL debe arrancar antes (solo orden, no espera a que esté listo)
    depends_on:
      - mysql

    # Variables que indican a phpMyAdmin a qué servidor MySQL conectarse
    environment:
      PMA_HOST: "mysql"   # Nombre del servicio MySQL dentro de la red Docker
      PMA_PORT: 3306      # Puerto interno de MySQL

    # Publica puertos → expone el servicio al exterior
    ports:
      - "8080:80"         # Puerto HOST:PUERTO_CONTENEDOR → http://localhost:8080

    # Conecta phpMyAdmin a la misma red que MySQL para que puedan verse
    networks:
      - red-bbdd


# ----- DEFINICIÓN DE VOLÚMENES -----
volumes:
  mysql_data:   # Volumen gestionado por Docker (no es carpeta local visible normalmente)


# ----- DEFINICIÓN DE REDES -----
networks:
  red-bbdd:     # Red interna donde los contenedores se comunican por nombre (DNS interno)

Qué está pasando aquí (muy importante)

• services: dos contenedores, uno para MySQL y otro para phpMyAdmin.
• volumes: mysql_data guarda la base de datos fuera del contenedor (persistencia).
• networks: red privada para que phpmyadmin pueda acceder a mysql por nombre.
• depends_on: arranca primero MySQL (ojo: no garantiza “ready”, solo orden de arranque).

3) Levantar los contenedores

docker compose up -d

Verifica:

docker compose ps
docker compose logs mysql --tail 30
docker compose logs phpmyadmin --tail 30

4) Acceder a phpMyAdmin

Abre en el navegador:

• http://localhost:8080

Credenciales:

• Usuario: root (o alumno)
• Password: RootPass_123! (o AlumnoPass_123!)

Comprueba:

• Existe la BD academia

5) Crear tabla de prueba (verificación)

Opción A: desde phpMyAdmin (SQL)
Ejecuta:

USE academia;
CREATE TABLE prueba (
  id INT PRIMARY KEY AUTO_INCREMENT,
  texto VARCHAR(50)
);
INSERT INTO prueba (texto) VALUES ("hola compose");
SELECT * FROM prueba;

Opción B: desde terminal (dentro del contenedor)

docker compose exec mysql mysql -u root -p

Comandos útiles para alumnos

docker compose ps
docker compose logs -f
docker compose exec mysql bash
docker compose exec phpmyadmin bash
docker compose down
docker compose down -v

1. Contexto de la práctica

En esta práctica vas a desplegar una pequeña infraestructura de servicios utilizando Docker y Docker Compose.

El objetivo no es únicamente “levantar contenedores”, sino comprender cómo se organizan los servicios, cómo se comunican entre ellos, cómo se almacenan los datos, cómo se exponen puertos al exterior y cómo se puede documentar y justificar una instalación técnica.

Durante la práctica se trabajará con servicios similares a los vistos en clase:

• Servidor web HTTP con Apache.
• PHP para ejecutar código dinámico.
• MySQL como base de datos relacional.
• phpMyAdmin como herramienta de administración.
• MongoDB como base de datos NoSQL.
• Mongo Express como herramienta de administración.
• Redes Docker.
• Volúmenes persistentes.
• Variables de entorno.
• Logs y comprobaciones.
• Copias de seguridad básicas.
• Documentación técnica.

2. Objetivos de aprendizaje

Al finalizar la práctica, el alumno deberá ser capaz de:

1. Explicar qué es Docker y para qué se utiliza.
2. Diferenciar una imagen de un contenedor.
3. Crear y ejecutar contenedores mediante Docker Compose.
4. Configurar servicios conectados entre sí.
5. Usar volúmenes para conservar datos.
6. Usar redes Docker para aislar servicios.
7. Configurar variables de entorno.
8. Desplegar una aplicación PHP conectada a MySQL.
9. Desplegar y consultar una base de datos MongoDB.
10. Comprobar el estado de los servicios mediante comandos.
11. Interpretar errores básicos mediante logs.
12. Documentar una instalación técnica de forma clara.
13. Defender oralmente el trabajo realizado.

3. Resultado final esperado

Al terminar la práctica deberás tener funcionando una infraestructura compuesta por varios contenedores:

La aplicación PHP deberá mostrar una página web con información del alumno, conexión a MySQL y, opcionalmente, conexión a MongoDB.

4. Normas de entrega

El alumno deberá entregar:

1. Carpeta completa del proyecto.
2. Archivo docker-compose.yml.
3. Archivo .env.
4. Código fuente de la aplicación PHP.
5. Capturas de pantalla.
6. Documento de memoria en PDF.
7. Comandos utilizados.
8. Respuestas a las preguntas de reflexión.
9. Evidencias de funcionamiento.
10. Breve vídeo opcional de demostración.

5. Estructura recomendada del proyecto

Crea una carpeta llamada:

practica-docker-servicios-nombre-apellido

Dentro de ella deberás crear una estructura similar a esta:

practica-docker-servicios-nombre-apellido/
│
├── docker-compose.yml
├── .env
├── README.md
│
├── web/
│   ├── index.php
│   ├── conexion_mysql.php
│   ├── insertar.php
│   ├── listar.php
│   └── estilos.css
│
├── mysql/
│   └── init.sql
│
├── evidencias/
│   ├── captura_01_docker_version.png
│   ├── captura_02_contenedores.png
│   ├── captura_03_web_funcionando.png
│   ├── captura_04_phpmyadmin.png
│   ├── captura_05_mongo_express.png
│   └── captura_06_logs.png
│
└── memoria/
    └── memoria_practica.pdf

6. Fase 1 — Preparación del entorno

6.1. Comprobar Docker

Ejecuta los siguientes comandos:

docker --version
docker compose version

Guarda una captura de pantalla donde se vea el resultado.

Preguntas de reflexión

Responde en tu memoria:

1. ¿Qué diferencia hay entre Docker y Docker Compose?
2. ¿Qué problema soluciona Docker cuando trabajamos con varios servicios?
3. ¿Por qué puede ser útil usar Docker en un entorno educativo o de laboratorio?

6.2. Comprobar que Docker funciona

Ejecuta:

docker run hello-world

Evidencia obligatoria

Incluye una captura del resultado del comando.

Pregunta de reflexión

Explica con tus palabras qué ha ocurrido al ejecutar hello-world.

Debes mencionar:

• Si Docker ha usado una imagen local o la ha descargado.
• Qué es un contenedor.
• Por qué el contenedor termina después de ejecutarse.

7. Fase 2 — Primer diseño de la infraestructura

Antes de escribir el docker-compose.yml, realiza un pequeño esquema de la infraestructura.

Puedes hacerlo con una tabla, un dibujo o un diagrama sencillo.

Debe aparecer:

• Servicio web.
• Base de datos MySQL.
• phpMyAdmin.
• MongoDB.
• Mongo Express.
• Red interna.
• Volúmenes de datos.
• Puertos publicados.

Ejemplo conceptual:

Navegador
   |
   | puerto 8080
   v
Apache + PHP
   |
   | red interna docker
   v
MySQL

Navegador
   |
   | puerto 8081
   v
phpMyAdmin
   |
   v
MySQL

Navegador
   |
   | puerto 8082
   v
Mongo Express
   |
   v
MongoDB

Preguntas de reflexión

1. ¿Por qué no es recomendable instalar todos los servicios dentro del mismo contenedor?
2. ¿Qué ventajas tiene separar web, base de datos y herramientas de administración?
3. ¿Qué servicios deberían ser accesibles desde el navegador y cuáles deberían quedar solo dentro de la red Docker?

8. Fase 3 — Creación del archivo .env

Crea un archivo llamado .env en la raíz del proyecto.

Ejemplo:

MYSQL_ROOT_PASSWORD=rootpassword
MYSQL_DATABASE=asir_db
MYSQL_USER=asir_user
MYSQL_PASSWORD=asir_password

MONGO_INITDB_ROOT_USERNAME=admin
MONGO_INITDB_ROOT_PASSWORD=adminpassword
MONGO_DATABASE=asir_mongo

WEB_PORT=8080
PHPMYADMIN_PORT=8081
MONGO_EXPRESS_PORT=8082

Importante

El archivo .env permite separar configuración del archivo docker-compose.yml.

No deberías escribir directamente las contraseñas dentro del docker-compose.yml si puedes evitarlo.

Preguntas de reflexión

1. ¿Qué ventaja tiene usar variables de entorno?
2. ¿Por qué puede ser peligroso subir un archivo .env real a un repositorio público?
3. ¿Qué información sensible contiene este archivo?

9. Fase 4 — Creación del docker-compose.yml

Crea el archivo docker-compose.yml.

Propuesta base:

services:

  web:
    image: php:8.2-apache
    container_name: asir_web_php
    ports:
      - "${WEB_PORT}:80"
    volumes:
      - ./web:/var/www/html
    depends_on:
      - mysql
      - mongodb
    networks:
      - red_asir

  mysql:
    image: mysql:8.0
    container_name: asir_mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - mysql_data:/var/lib/mysql
      - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql
    networks:
      - red_asir

  phpmyadmin:
    image: phpmyadmin:latest
    container_name: asir_phpmyadmin
    restart: always
    ports:
      - "${PHPMYADMIN_PORT}:80"
    environment:
      PMA_HOST: mysql
      PMA_PORT: 3306
    depends_on:
      - mysql
    networks:
      - red_asir

  mongodb:
    image: mongo:latest
    container_name: asir_mongodb
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: ${MONGO_INITDB_ROOT_USERNAME}
      MONGO_INITDB_ROOT_PASSWORD: ${MONGO_INITDB_ROOT_PASSWORD}
    volumes:
      - mongo_data:/data/db
    networks:
      - red_asir

  mongo-express:
    image: mongo-express:latest
    container_name: asir_mongo_express
    restart: always
    ports:
      - "${MONGO_EXPRESS_PORT}:8081"
    environment:
      ME_CONFIG_MONGODB_ADMINUSERNAME: ${MONGO_INITDB_ROOT_USERNAME}
      ME_CONFIG_MONGODB_ADMINPASSWORD: ${MONGO_INITDB_ROOT_PASSWORD}
      ME_CONFIG_MONGODB_SERVER: mongodb
    depends_on:
      - mongodb
    networks:
      - red_asir

volumes:
  mysql_data:
  mongo_data:

networks:
  red_asir:
    driver: bridge

9.1. Preguntas sobre el docker-compose.yml

Responde en tu memoria:

1. ¿Qué significa services?
2. ¿Qué diferencia hay entre image y container_name?
3. ¿Para qué sirve ports?
4. ¿Qué diferencia hay entre el puerto de la izquierda y el de la derecha en esta línea?

- "8080:80"

5. ¿Para qué sirve volumes?
6. ¿Qué pasaría con los datos de MySQL si no usásemos un volumen?
7. ¿Qué hace depends_on?
8. ¿Qué limitación tiene depends_on?
9. ¿Para qué sirve definir una red propia llamada red_asir?
10. ¿Por qué el servicio web puede conectarse a MySQL usando el nombre mysql?

10. Fase 5 — Script inicial de MySQL

Dentro de la carpeta mysql, crea el archivo init.sql.

Ejemplo:

CREATE TABLE IF NOT EXISTS alumnos (
    id INT AUTO_INCREMENT PRIMARY KEY,
    nombre VARCHAR(100) NOT NULL,
    apellido VARCHAR(100) NOT NULL,
    curso VARCHAR(100) NOT NULL,
    fecha_registro TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

INSERT INTO alumnos (nombre, apellido, curso)
VALUES 
('Alumno', 'Ejemplo', 'ASIR'),
('Docker', 'Compose', 'Servicios');

Este script se ejecutará automáticamente cuando se cree por primera vez el contenedor de MySQL y el volumen esté vacío.

Preguntas de reflexión

1. ¿Cuándo se ejecutan los scripts dentro de /docker-entrypoint-initdb.d/?
2. Si modificas init.sql después de haber creado el volumen, ¿se vuelve a ejecutar automáticamente?
3. ¿Qué tendrías que hacer para reiniciar completamente la base de datos desde cero?
4. ¿Por qué hay que tener cuidado al borrar volúmenes?

11. Fase 6 — Crear la aplicación PHP

Dentro de la carpeta web, crea el archivo index.php.

Ejemplo:

<?php
$host = 'mysql';
$db = 'asir_db';
$user = 'asir_user';
$password = 'asir_password';

$conexionCorrecta = false;
$error = '';

try {
    $pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8", $user, $password);
    $conexionCorrecta = true;
} catch (PDOException $e) {
    $error = $e->getMessage();
}
?>

<!DOCTYPE html>
<html lang="es">
<head>
    <meta charset="UTF-8">
    <title>Práctica Docker ASIR</title>
    <link rel="stylesheet" href="estilos.css">
</head>
<body>

    <main>
        <h1>Práctica Docker, Docker Compose y Servicios</h1>

        <section>
            <h2>Datos del alumno</h2>
            <p><strong>Nombre:</strong> Escribe aquí tu nombre</p>
            <p><strong>Curso:</strong> ASIR</p>
            <p><strong>Módulo:</strong> Implantación de aplicaciones / Servicios / Sistemas</p>
        </section>

        <section>
            <h2>Estado de la conexión con MySQL</h2>

            <?php if ($conexionCorrecta): ?>
                <p class="ok">Conexión correcta con MySQL.</p>
            <?php else: ?>
                <p class="error">Error de conexión con MySQL.</p>
                <pre><?php echo $error; ?></pre>
            <?php endif; ?>
        </section>

        <section>
            <h2>Listado de alumnos desde MySQL</h2>

            <?php
            if ($conexionCorrecta) {
                $consulta = $pdo->query("SELECT * FROM alumnos");

                echo "<table>";
                echo "<tr><th>ID</th><th>Nombre</th><th>Apellido</th><th>Curso</th><th>Fecha</th></tr>";

                while ($fila = $consulta->fetch(PDO::FETCH_ASSOC)) {
                    echo "<tr>";
                    echo "<td>" . htmlspecialchars($fila['id']) . "</td>";
                    echo "<td>" . htmlspecialchars($fila['nombre']) . "</td>";
                    echo "<td>" . htmlspecialchars($fila['apellido']) . "</td>";
                    echo "<td>" . htmlspecialchars($fila['curso']) . "</td>";
                    echo "<td>" . htmlspecialchars($fila['fecha_registro']) . "</td>";
                    echo "</tr>";
                }

                echo "</table>";
            }
            ?>
        </section>
    </main>

</body>
</html>

11.1. Archivo CSS

Crea estilos.css:

body {
    font-family: Arial, sans-serif;
    background-color: #f4f4f4;
    margin: 0;
    padding: 0;
}

main {
    width: 80%;
    margin: 40px auto;
    background-color: white;
    padding: 30px;
    border-radius: 10px;
}

h1 {
    color: #333;
}

section {
    margin-bottom: 30px;
}

.ok {
    color: green;
    font-weight: bold;
}

.error {
    color: red;
    font-weight: bold;
}

table {
    width: 100%;
    border-collapse: collapse;
}

th {
    background-color: #333;
    color: white;
}

td, th {
    padding: 10px;
    border: 1px solid #ccc;
}

11.2. Problema intencionado

Con la imagen oficial php:8.2-apache, puede ocurrir que PHP no tenga activada la extensión necesaria para conectarse a MySQL mediante PDO.

Si al abrir la web aparece un error relacionado con MySQL o PDO, deberás investigarlo y solucionarlo.

Pista

Puede ser necesario crear un Dockerfile personalizado para el servicio web.

12. Fase 7 — Crear una imagen personalizada para PHP

Crea un archivo llamado Dockerfile dentro de la carpeta web.

FROM php:8.2-apache

RUN docker-php-ext-install pdo pdo_mysql mysqli

Ahora modifica el servicio web en el docker-compose.yml.

Antes:

web:
  image: php:8.2-apache

Después:

web:
  build: ./web

El servicio completo quedaría así:

web:
  build: ./web
  container_name: asir_web_php
  ports:
    - "${WEB_PORT}:80"
  volumes:
    - ./web:/var/www/html
  depends_on:
    - mysql
    - mongodb
  networks:
    - red_asir

Preguntas de reflexión

1. ¿Qué diferencia hay entre usar image y usar build?
2. ¿Para qué sirve un Dockerfile?
3. ¿Qué hace esta línea?

RUN docker-php-ext-install pdo pdo_mysql mysqli

4. ¿Por qué necesitamos instalar extensiones de PHP?
5. ¿Qué ventaja tiene crear nuestra propia imagen personalizada?

13. Fase 8 — Levantar los servicios

Ejecuta:

docker compose up -d

Después comprueba:

docker compose ps

También puedes usar:

docker ps

Evidencias obligatorias

Incluye capturas donde se vea:

• Los contenedores levantados.
• Los puertos publicados.
• El estado de cada contenedor.

Preguntas de reflexión

1. ¿Qué significa ejecutar Docker Compose con -d?
2. ¿Qué diferencia hay entre docker compose ps y docker ps?
3. ¿Qué significa que un contenedor esté en estado Up?
4. ¿Qué harías si un contenedor aparece como Restarting?

14. Fase 9 — Comprobación de servicios en navegador

Accede desde el navegador a:

http://localhost:8080

Deberías ver la aplicación PHP.

Accede también a:

http://localhost:8081

Deberías ver phpMyAdmin.

Accede a:

http://localhost:8082

Deberías ver Mongo Express.

Evidencias obligatorias

Incluye capturas de:

1. Página PHP funcionando.
2. phpMyAdmin mostrando la base de datos.
3. Tabla alumnos dentro de MySQL.
4. Mongo Express funcionando.

Preguntas de reflexión

1. ¿Por qué accedemos a la web usando localhost:8080 y no localhost:80?
2. ¿Qué usuario y contraseña has utilizado para entrar en phpMyAdmin?
3. ¿Qué base de datos aparece creada automáticamente?
4. ¿Qué diferencia hay entre administrar MySQL desde línea de comandos y hacerlo desde phpMyAdmin?
5. ¿Qué riesgos tendría dejar phpMyAdmin abierto en un servidor real?

15. Fase 10 — Insertar datos desde PHP

Crea un archivo llamado insertar.php.

<?php
$host = 'mysql';
$db = 'asir_db';
$user = 'asir_user';
$password = 'asir_password';

try {
    $pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8", $user, $password);

    $sql = "INSERT INTO alumnos (nombre, apellido, curso) VALUES (:nombre, :apellido, :curso)";
    $stmt = $pdo->prepare($sql);

    $stmt->execute([
        ':nombre' => 'NombreAlumno',
        ':apellido' => 'ApellidoAlumno',
        ':curso' => 'ASIR'
    ]);

    echo "Registro insertado correctamente.";
} catch (PDOException $e) {
    echo "Error: " . $e->getMessage();
}

Accede a:

http://localhost:8080/insertar.php

Después vuelve a:

http://localhost:8080/index.php

Comprueba que el nuevo registro aparece en la tabla.

Trabajo obligatorio

Modifica el archivo para que inserte tus propios datos.

Preguntas de reflexión

1. ¿Qué ocurre cada vez que recargas insertar.php?
2. ¿Por qué puede ser peligroso insertar datos directamente sin un formulario controlado?
3. ¿Qué diferencia hay entre una consulta normal y una consulta preparada?
4. ¿Qué problema de seguridad ayudan a evitar las consultas preparadas?

16. Fase 11 — Crear formulario de inserción

Crea una página formulario.php.

<!DOCTYPE html>
<html lang="es">
<head>
    <meta charset="UTF-8">
    <title>Formulario de alumnos</title>
    <link rel="stylesheet" href="estilos.css">
</head>
<body>

<main>
    <h1>Insertar alumno</h1>

    <form action="guardar.php" method="post">
        <label>Nombre:</label><br>
        <input type="text" name="nombre" required><br><br>

        <label>Apellido:</label><br>
        <input type="text" name="apellido" required><br><br>

        <label>Curso:</label><br>
        <input type="text" name="curso" required><br><br>

        <button type="submit">Guardar</button>
    </form>
</main>

</body>
</html>

Crea ahora guardar.php.

<?php
$host = 'mysql';
$db = 'asir_db';
$user = 'asir_user';
$password = 'asir_password';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $nombre = $_POST['nombre'] ?? '';
    $apellido = $_POST['apellido'] ?? '';
    $curso = $_POST['curso'] ?? '';

    try {
        $pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8", $user, $password);

        $sql = "INSERT INTO alumnos (nombre, apellido, curso) VALUES (:nombre, :apellido, :curso)";
        $stmt = $pdo->prepare($sql);

        $stmt->execute([
            ':nombre' => $nombre,
            ':apellido' => $apellido,
            ':curso' => $curso
        ]);

        echo "Alumno guardado correctamente.";
        echo "<br><a href='index.php'>Volver al listado</a>";

    } catch (PDOException $e) {
        echo "Error: " . $e->getMessage();
    }
}

Evidencia obligatoria

Incluye captura del formulario y del registro insertado.

Preguntas de reflexión

1. ¿Qué método HTTP utiliza el formulario?
2. ¿Qué diferencia hay entre GET y POST?
3. ¿Dónde llegan los datos enviados por el formulario?
4. ¿Qué validaciones mínimas debería tener este formulario?
5. ¿Por qué no deberíamos confiar nunca únicamente en la validación del navegador?

17. Fase 12 — Trabajo con MongoDB

MongoDB es una base de datos NoSQL. En lugar de trabajar con tablas y filas, trabaja con bases de datos, colecciones y documentos.

Accede a Mongo Express:

http://localhost:8082

Crea una base de datos llamada:

asir_mongo

Crea una colección llamada:

inventario

Inserta al menos tres documentos similares a estos:

{
  "nombre": "Servidor web",
  "tipo": "contenedor",
  "servicio": "Apache PHP",
  "puerto": 8080
}

{
  "nombre": "Base de datos relacional",
  "tipo": "contenedor",
  "servicio": "MySQL",
  "puerto": 3306
}

{
  "nombre": "Base de datos NoSQL",
  "tipo": "contenedor",
  "servicio": "MongoDB",
  "puerto": 27017
}

Evidencias obligatorias

Incluye capturas de:

• Base de datos creada.
• Colección creada.
• Documentos insertados.

Preguntas de reflexión

1. ¿Qué diferencia hay entre una tabla de MySQL y una colección de MongoDB?
2. ¿Qué diferencia hay entre una fila y un documento?
3. ¿Qué ventajas puede tener MongoDB frente a MySQL?
4. ¿Qué ventajas puede tener MySQL frente a MongoDB?
5. ¿En qué tipo de proyecto usarías cada uno?

18. Fase 13 — Comandos de administración

Ejecuta y documenta los siguientes comandos.

Ver contenedores activos

docker ps

Ver todos los contenedores

docker ps -a

Ver imágenes

docker images

Ver redes

docker network ls

Ver volúmenes

docker volume ls

Ver logs del servicio web

docker compose logs web

Ver logs de MySQL

docker compose logs mysql

Entrar dentro del contenedor web

docker exec -it asir_web_php bash

Dentro del contenedor, ejecuta:

ls -la /var/www/html

Después sal:

exit

Evidencias obligatorias

Incluye capturas de al menos cinco comandos anteriores.

Preguntas de reflexión

1. ¿Para qué sirve docker ps?
2. ¿Qué información muestra docker images?
3. ¿Qué diferencia hay entre una imagen y un contenedor?
4. ¿Qué utilidad tienen los logs?
5. ¿Para qué puede servir entrar dentro de un contenedor?
6. ¿Por qué no deberíamos modificar manualmente demasiadas cosas dentro de un contenedor en producción?

19. Fase 14 — Persistencia de datos

Vas a comprobar que los datos sobreviven aunque los contenedores se detengan.

Ejecuta:

docker compose down

Después vuelve a levantar:

docker compose up -d

Comprueba:

• Que la web sigue funcionando.
• Que los datos de MySQL siguen estando.
• Que los documentos de MongoDB siguen estando.

Ahora ejecuta:

docker compose down -v

Vuelve a levantar:

docker compose up -d

Comprueba qué ha ocurrido con los datos.

Mucho cuidado

El parámetro -v elimina los volúmenes asociados al proyecto.

Preguntas de reflexión

1. ¿Qué diferencia hay entre docker compose down y docker compose down -v?
2. ¿Por qué se han conservado los datos en el primer caso?
3. ¿Por qué se han perdido los datos en el segundo caso?
4. ¿Qué papel tienen los volúmenes en Docker?
5. ¿Por qué la persistencia es fundamental en bases de datos?

20. Fase 15 — Copia de seguridad de MySQL

Realiza una copia de seguridad de la base de datos MySQL.

Ejemplo:

docker exec asir_mysql mysqldump -u root -p asir_db > backup_asir_db.sql

El sistema pedirá la contraseña de root.

Después comprueba que se ha creado el archivo:

ls -lh backup_asir_db.sql

Evidencia obligatoria

Incluye captura del archivo generado.

Preguntas de reflexión

1. ¿Qué es mysqldump?
2. ¿Por qué es importante hacer copias de seguridad?
3. ¿Dónde se ha guardado el archivo SQL?
4. ¿Qué información contiene ese archivo?
5. ¿Sería suficiente esta copia de seguridad en un entorno real? Justifica la respuesta.

21. Fase 16 — Restauración básica de MySQL

Para comprobar la restauración, puedes crear una nueva base de datos desde phpMyAdmin o desde consola e importar el archivo.

Ejemplo orientativo:

docker exec -i asir_mysql mysql -u root -p asir_db < backup_asir_db.sql

Preguntas de reflexión

1. ¿Qué diferencia hay entre exportar e importar una base de datos?
2. ¿Qué riesgos existen al restaurar una copia sobre una base de datos que ya contiene información?
3. ¿Qué medidas tomarías antes de restaurar una copia en producción?

22. Fase 17 — Comprobación de red entre contenedores

Entra en el contenedor web:

docker exec -it asir_web_php bash

Instala herramientas de red si fuera necesario:

apt update
apt install -y iputils-ping

Prueba conectividad:

ping mysql
ping mongodb

Sal del contenedor:

exit

Preguntas de reflexión

1. ¿Por qué podemos hacer ping mysql y no necesitamos conocer la IP del contenedor?
2. ¿Qué papel hace el DNS interno de Docker?
3. ¿Cambiaría la IP del contenedor si lo eliminamos y lo volvemos a crear?
4. ¿Por qué es mejor usar nombres de servicio que direcciones IP?

23. Fase 18 — Seguridad básica

Analiza la configuración actual.

Responde:

1. ¿Qué puertos están expuestos al equipo anfitrión?
2. ¿Qué servicios son accesibles desde el navegador?
3. ¿Tiene sentido exponer MySQL directamente al exterior?
4. ¿Tiene sentido exponer MongoDB directamente al exterior?
5. ¿Qué contraseñas son débiles?
6. ¿Qué cambiarías si esto fuese un servidor real?
7. ¿Qué riesgos tiene usar root para administrar la base de datos?
8. ¿Qué riesgos tiene dejar herramientas como phpMyAdmin o Mongo Express accesibles públicamente?

Mejora obligatoria

Modifica el docker-compose.yml para que MySQL y MongoDB no publiquen puertos hacia el exterior.

Es decir, evita configuraciones como:

ports:
  - "3306:3306"

o:

ports:
  - "27017:27017"

Los servicios internos deben comunicarse por la red Docker, no necesariamente por puertos públicos.

Pregunta de reflexión

Si MySQL no tiene puerto publicado, ¿por qué phpMyAdmin puede seguir conectando con él?

24. Fase 19 — Personalización del proyecto

El alumno deberá personalizar la práctica.

Como mínimo deberá:

1. Cambiar el nombre de los contenedores.
2. Cambiar el nombre de la base de datos.
3. Cambiar usuario y contraseña.
4. Personalizar la página principal.
5. Insertar datos propios.
6. Añadir una nueva tabla en MySQL.
7. Añadir una nueva colección en MongoDB.
8. Documentar los cambios realizados.

Nueva tabla obligatoria

Crea una tabla llamada servicios.

Ejemplo:

CREATE TABLE IF NOT EXISTS servicios (
    id INT AUTO_INCREMENT PRIMARY KEY,
    nombre VARCHAR(100) NOT NULL,
    imagen VARCHAR(100) NOT NULL,
    puerto VARCHAR(20),
    descripcion TEXT
);

Inserta al menos cinco servicios:

• Apache/PHP.
• MySQL.
• phpMyAdmin.
• MongoDB.
• Mongo Express.

Preguntas de reflexión

1. ¿Qué campos has elegido para la tabla servicios?
2. ¿Por qué has elegido esos campos?
3. ¿Qué relación existe entre esta tabla y la infraestructura desplegada?
4. ¿Cómo podrías mostrar esta tabla desde PHP?

25. Fase 20 — Ampliación opcional

Para subir nota, puedes realizar una o varias de estas mejoras.

Opción A — Añadir Nginx como proxy inverso

Añade un contenedor Nginx que actúe como punto de entrada.

Debe permitir acceder a la aplicación PHP desde otro puerto o ruta.

Opción B — Añadir Adminer

Añade Adminer como alternativa a phpMyAdmin.

Opción C — Añadir Redis

Añade Redis como servicio adicional y explica para qué se utiliza.

Opción D — Crear una aplicación PHP más completa

La aplicación deberá permitir:

• Insertar alumnos.
• Listar alumnos.
• Borrar alumnos.
• Editar alumnos.