Tema 3 · 4 · Web app propia en una EC2 y ejercicio 3 (exportar e importar)

Presentación del Tema 3: «Utilización de una WebApp propia» (con estudiantes.php y estudiantes-nota.php) y «Ejercicios 3 y 3B» (insertar, exportar y restaurar en otro servidor). Duración: unos 10 minutos para crear la máquina (el script lo hace todo) más 15-20 minutos para el ejercicio 3. Coste: una máquina t3.small (céntimos por hora; se apaga sola a las 4 horas); la RDS MySQL del ejercicio 3B, si la haces con RDS, factura por hora mientras exista (con --servidor-mysql no cuesta nada más).

¿Dudas con un script? Todos los scripts de esta carpeta traen su propia ayuda: ./gestionar-webapp.sh --ayuda (también vale --help o -h) explica los pasos y las opciones. Este README.md es el paso a paso de la actividad: tenlo a mano y consúltalo antes de preguntar.

Etiquetas de lo que creas. ./gestionar-webapp.sh crear etiqueta la máquina, su disco, el Security Group y el bucket temporal con curso = G214, universidad = CUNEF, actividad = 03.04-webappexportar y script = gestionar-webapp.sh. Lo que crees a mano (la segunda RDS del 3B, si la haces) etiquétalo con las tres primeras. Si hiciera falta borrar a mano, todo se localiza con aws resourcegroupstaggingapi get-resources --region eu-north-1 --tag-filters Key=actividad,Values=03.04-webappexportar. Más detalle (cómo etiquetar con la CLI, cómo buscar y qué hacer en una emergencia): README principal, sección «Etiquetas».

Qué vas a hacer

Vas a ejecutar, en una máquina EC2 propia que crea un script (sin instalar nada en tu PC y sin copiar ni pegar ficheros), una pequeña web en PHP que se conecta a tu RDS y hace altas, cambios y bajas sobre la tabla estudiantes. Después, con esa web y con Adminer, harás el ejercicio 3: insertar alumnos, exportar la base a un .sql y restaurarla en un servidor MySQL distinto (ejercicio 3B).

Tu navegador ──http://IP/estudiantes.php──> EC2 «webapp» (Apache + PHP) ──puerto 3306──> tu RDS (base universidad)
Adminer: Export (estudiantes.sql) ──Import──> segundo servidor MySQL (RDS MySQL, o MySQL en la propia EC2 «webapp»)

Qué se crea en AWS: una EC2 webapp (Amazon Linux 2023, t3.small), un Security Group (puertos 22 y 80) y un bucket temporal con los ficheros de la actividad (el script lo borra con eliminar). Con --rds se añade la regla que deja a la máquina llegar a tu RDS. Todo lleva las etiquetas del curso y se apaga solo a las 4 horas (se para, no se borra: volver a ejecutar crear la arranca y renueva el plazo). Esta actividad es independiente de la 03.05, que crea su propia máquina.

Qué contiene esta carpeta

Antes de empezar

• [ ] La base universidad cargada con tema3_estudiantes.sql en tu RDS (03.03) y hechos los ejercicios 1 y 2 de esa actividad (para que las cifras del ejercicio 3 cuadren).
• [ ] Tu RDS es MariaDB 10.11 (no la 11.x): esta web no cifra la conexión y las MariaDB 11.x la exigen (03.01).
• [ ] El nombre (DB identifier) de tu RDS, tal como sale en la consola de RDS: se lo das al script con --rds. No hace falta que la RDS sea pública ni abrir su Security Group a tu IP: el script deja pasar solo a la máquina de la web (de Security Group a Security Group).
• [ ] CloudShell abierto con la región eu-north-1 (Estocolmo). No hay variables de entorno que configurar: host, usuario y contraseña se escriben en el formulario de la propia web.
• [ ] Adminer funcionando (03.02) para la parte de exportar e importar.

Cómo llevar los ficheros a donde toque

Todo se hace desde CloudShell (la web corre en la EC2, no en tu PC). En tu PC comprime la carpeta 03.04-webappexportar (clic derecho > Comprimir en ZIP), en CloudShell usa Actions > Upload file y descomprime:

unzip -o 03.04-webappexportar.zip
cd 03.04-webappexportar
chmod -R u+rwX . && chmod +x gestionar-webapp.sh
./gestionar-webapp.sh --ayuda

Si ya subiste g214-materiales.zip (README principal), no necesitas este zip: entra con cd ~/g214-materiales/tema3/03.04-webappexportar y, si algún fichero da Permission denied, ejecuta allí chmod -R u+rwX . && chmod +x *.sh.

No hay que llevar estudiantes.php ni ningún otro fichero a la máquina: el script los lleva dentro y se los entrega solo. Los ficheros .sql que exportes con Adminer se guardan en tu PC.

Paso a paso

Paso 1. Crear la máquina de la web. En CloudShell, dentro de esta carpeta (con el nombre de tu RDS):

./gestionar-webapp.sh crear --rds nombre-de-tu-rds --servidor-mysql

--servidor-mysql instala además un MySQL en la misma máquina, que usarás como «segundo servidor» del ejercicio 3B (paso 7, opción B). Si vas a hacer el 3B con una segunda RDS, puedes omitirlo.

Qué verás: el Security Group creado, los ficheros subidos al bucket temporal, la máquina lanzada, Apagado automático: se apagará a las HH:MM UTC (dentro de 4 h 0 min), el aviso Tu máquina ya puede conectar con la RDS ... y, al final, un recuadro Tu web de estudiantes con las direcciones (la página de inicio http://IP/, http://IP/estudiantes.php y http://IP/estudiantes-nota.php) y, con --servidor-mysql, la dirección de su Adminer y la contraseña de root. Tarda unos 3 minutos; el MySQL, si lo pediste, puede tardar 1-3 minutos más en responder (./gestionar-webapp.sh estado te dice si ya responden). Es seguro repetir el comando: lo que ya existe se reutiliza.

Paso 2. Abrir la web y conectar. Abre http://IP/ (la IP del recuadro): verás dos botones, Estudiantes y Estudiantes con nota. Pulsa el primero (http://IP/estudiantes.php).

1. Formulario Conectar a MySQL: Host = el endpoint de tu RDS, Base de datos = universidad (ya viene rellenada), Usuario = admin, Contraseña = la tuya. Pulsa Guardar conexión.
2. La página se recarga con la tarjeta Conexión activa (host, base y usuario) y, debajo, Añadir estudiante y Listado de estudiantes con los registros de tu tabla. Campos del alta: nombre, apellidos, grupo (A, B o C), nº de convocatoria (1 a 3) y la casilla Derecho a examen. Cada fila del listado tiene Guardar y Eliminar.
3. Si la tabla estudiantes no existe, verás La tabla no existe todavía; el botón Crear/verificar tabla "estudiantes" la crea, pero lo normal es haber cargado antes tema3_estudiantes.sql.
4. Las credenciales se guardan en cookies del navegador durante 7 días. Cambiar conexión las borra. Es un ejemplo de docencia: la web va por HTTP, no metas credenciales que no sean de prueba.
5. Si la conexión falla, sale un aviso rojo Error de conexión: ... con el motivo y no aparecen ni el alta ni el listado: pulsa Cambiar conexión y revisa los datos (ver «Errores frecuentes»).

Paso 3. Probar altas, cambios y bajas desde la web (esto prepara el ejercicio 3, paso 5).

Paso 4. estudiantes-nota.php. Es la misma web con la columna nota. Abre http://IP/estudiantes-nota.php. Necesita que la tabla estudiantes tenga esa columna: ejecuta antes en Adminer el ALTER de la presentación (o el bloque Columna nota de 03.03), o pulsa el botón Crear/verificar tabla "estudiantes" dentro de estudiantes-nota.php, que intenta añadirla. Sin la columna, el listado y las altas y modificaciones de esa versión fallan. Este es el ejemplo de la presentación: si cambia la base de datos, hay que actualizar las aplicaciones que la consumen.

Respuesta de referencia a «¿qué ventajas y desventajas ves?»: ventaja, una interfaz a medida para usuarios que no saben SQL (alta, baja y edición con botones); desventaja, está atada al esquema: si cambia (por ejemplo, la columna nota), estudiantes.php no la muestra y estudiantes-nota.php falla en una tabla que no la tiene hasta que se actualice la aplicación.

Paso 5. Ejercicio 3: insertar. Este ejercicio se hace desde la interfaz (la web estudiantes.php y Adminer): inserta los dos alumnos nuevos que pide la presentación (para que las cifras de abajo cuadren, ponlos en el grupo A). Comprobación (en Adminer, SQL command; viene en ejercicios.txt):

USE universidad;
SELECT COUNT(*) FROM estudiantes;
SELECT grupo, COUNT(*) AS alumnos FROM estudiantes GROUP BY grupo;

Qué verás: tras los ejercicios anteriores la tabla tiene 50 filas (A 14, B 13, C 23, si los dos alumnos nuevos son del grupo A; sin el id 2, id más alto 51, o 52 si antes ejecutaste el bloque nota con ROLLBACK (el INSERT deshecho gasta el id 50), y Ana con derecho_a_examen vacío).

Paso 6. Exportar desde Adminer (ejercicio 3). En Adminer, con la base universidad elegida: Export > Output save, Format SQL, marca Table y Data > Export. El Output por defecto es open (se muestra en pantalla, no se descarga). Se descarga estudiantes.sql (el nombre de la tabla; si exportas varias tablas, el nombre de la base), con DROP TABLE IF EXISTS, CREATE TABLE y los INSERT, y sin CREATE DATABASE ni USE. Por eso, en el servidor de destino hay que crear la base vacía y elegirla antes de importar (paso 8).

Paso 7. Ejercicio 3B: el segundo servidor. Hay dos formas; las dos sirven para el objetivo del ejercicio (restaurar el .sql en un servidor distinto).

Opción A: segunda RDS MySQL. Se crea como la primera (03.01): MySQL 8.x, db.t3.micro, gp3 de 20 GiB, sin Multi-AZ, acceso público y el Security Group BaseDeDatos (en la misma VPC). Etiquétala con curso, universidad y actividad y bórrala al terminar.

Si AWS no te deja crear la segunda RDS. Con una cuenta del plan gratuito, create-db-instance o la consola responden InstanceQuotaExceeded: You reached the maximum number of instances available with free plan accounts cuando la cuenta ya tiene cierto número de instancias: es un límite del plan gratuito, no de la API. El número exacto depende de tu cuenta y de lo que ya tengas creado (se ha visto con dos instancias en la cuenta, una propia y otra ajena): si solo tienes la MariaDB, prueba primero a crear la de MySQL. Si da el error, tienes dos salidas:

1. Borrar antes la RDS MariaDB. Ya tienes estudiantes.sql exportado en tu PC: borra la MariaDB (limpieza de 03.01; los datos se pierden, pero el .sql los conserva), crea la RDS MySQL y restaura en ella. Después, para seguir con el resto del tema, vuelve a crear la MariaDB y recarga tema3_estudiantes.sql.
2. La opción B (sin RDS y sin coste añadido).

Opción B: MySQL en la propia máquina de la web (recomendada si no puedes crear otra RDS). Es el MySQL que instaló --servidor-mysql en el paso 1. Abre http://IP/adminer-3b.php (también está enlazado en la página de inicio http://IP/) y entra con Servidor localhost, Usuario root y la contraseña que mostró crear (queda guardada en el fichero .gestionar-webapp.mysql de tu carpeta de CloudShell: cat .gestionar-webapp.mysql). Si creaste la máquina sin esa opción, bórrala y créala otra vez (tu RDS no se toca):

./gestionar-webapp.sh eliminar
./gestionar-webapp.sh crear --rds nombre-de-tu-rds --servidor-mysql

Paso 8. Restaurar en el segundo servidor. Crea la base vacía y elígela ANTES de importar (viene en ejercicios.txt):

CREATE DATABASE IF NOT EXISTS universidad;
USE universidad;

Después: Import > estudiantes.sql > Execute, y comprueba SELECT COUNT(*) FROM estudiantes;. En la opción A usa tu Adminer de 03.02 con el endpoint de la nueva RDS; en la B, el Adminer de la propia máquina (adminer-3b.php).

Qué verás: 50 filas, A 14 / B 13 / C 23: el destino debe dar lo mismo que el origen. El mismo .sql de MariaDB 10.11 entra en MySQL 8 sin cambios (puede salir un aviso por el alias utf8).

Paso 9. Limpieza. Al terminar esta actividad:

./gestionar-webapp.sh eliminar

Borra la máquina, su disco, el Security Group, la regla que le daba acceso a tu RDS, el bucket temporal y la contraseña guardada del MySQL local. Es repetible: si algo falla, vuelve a ejecutarlo. Si hiciste la opción A, borra además la segunda RDS (limpieza de 03.01).

Errores frecuentes

Cómo sabes que has terminado

• [ ] estudiantes.php conecta con tu RDS y muestra el listado de estudiantes; has probado alta, cambio y baja.
• [ ] Has visto estudiantes-nota.php con la columna nota y sabes por qué falla sin ella.
• [ ] Tras el ejercicio 3, universidad.estudiantes tiene 50 filas (A 14, B 13, C 23).
• [ ] Has exportado estudiantes.sql y lo has restaurado en un segundo servidor (RDS MySQL o MySQL en tu máquina) con las mismas 50 filas.
• [ ] Has ejecutado ./gestionar-webapp.sh eliminar (y borrado la segunda RDS, si la creaste) y ./gestionar-webapp.sh estado dice que no queda nada.

La RDS MariaDB y Adminer no se borran aquí: se borran al final del tema (Adminer en 03.02, la RDS en 03.01, después de la actividad 03.09).

Anterior: 03.03 · SQL con la tabla de estudiantes · Siguiente: 03.05 · Ejercicios 4 y 5: países y Euribor