UD 3 - Guía docente de la línea argumental
Finalidad de este documento¶
Esta guía está dirigida al profesorado que desarrolla la unidad 3, Arquitecturas y despliegue web. No pretende sustituir a los nueve apuntes de teoría, sino facilitar su uso conjunto: explica qué pregunta responde cada punto, qué conceptos conviene remarcar, qué conexiones deben hacerse visibles y qué evidencia permite comprobar cada criterio de evaluación.
Uso docente
La unidad se entiende mejor como un único proceso de despliegue que como nueve temas independientes. Conviene volver varias veces al mismo caso de referencia y mostrar cómo cada punto añade una decisión, una configuración, una prueba o una evidencia nueva.
1. Marco curricular y secuencia global¶
La unidad desarrolla el RA1 del módulo 0614, «Implanta arquitecturas web analizando y aplicando criterios de funcionalidad». Los nueve puntos trabajan, respectivamente, los criterios CE a, b, g, h, e, c, d, f e i.
El orden didáctico no sigue literalmente el orden de las letras de los criterios. Se ha elegido para que el alumnado avance desde la comprensión del problema hasta la demostración y la documentación del resultado:
3.1 Decidir la arquitectura
↓
3.2 Entender cómo viaja una petición
↓
3.3 Inspeccionar qué contiene la aplicación
↓
3.4 Convertir lo observado en requisitos verificables
↓
3.5 Preparar el entorno de ejecución
↓
3.6 Configurar el punto de entrada web
↓
3.7 Configurar el runtime de la aplicación
↓
3.8 Probar la cadena completa y diagnosticar fallos
↓
3.9 Documentar el procedimiento para que otra persona pueda repetirlo
La idea que debe mantenerse durante toda la unidad es:
No se empieza por una herramienta. Se parte de una funcionalidad, se identifican los componentes y sus requisitos, se prepara el entorno, se configura cada servicio, se comprueba el resultado y se documentan las evidencias.
1.1. Caso conductor recomendado¶
Se recomienda utilizar una aplicación de catálogo web con estas características:
- el navegador consulta productos y permite crear pedidos;
- la aplicación impide realizar pedidos superiores al stock disponible;
- el dominio es suficientemente pequeño para trabajar con un monolito organizado en tres capas lógicas y con pocas personas usuarias;
- Nginx sirve los recursos estáticos y actúa como punto de entrada;
- Tomcat ejecuta un archivo WAR con la aplicación Java;
- MariaDB conserva productos, cuentas y pedidos;
- los servicios se ejecutan en una red interna y los datos se guardan en un volumen persistente;
- la aplicación se publica mediante una URL y se comprueba con
curl; - el despliegue se documenta en un repositorio con Compose, configuración y evidencias.
Este caso permite repetir las mismas preguntas en todos los puntos:
- ¿Qué componente participa?
- ¿Qué responsabilidad tiene?
- ¿Qué necesita para funcionar?
- ¿Cómo se configura?
- ¿Cómo se comprueba?
- ¿Qué evidencia se conserva?
1.2. Mapa de puntos, criterios y función didáctica¶
| Punto | CE | Pregunta central | Función en la secuencia | Evidencia orientativa |
|---|---|---|---|---|
| 3.1 | RA1.a | ¿Cómo organizamos la solución? | Distinguir interacción, capas lógicas, niveles de despliegue y unidades desplegables | Diagramas lógico y de despliegue, más una decisión razonada |
| 3.2 | RA1.b | ¿Cómo se comunican? | Seguir una petición desde el cliente hasta la respuesta | Descomposición de URL, mensaje HTTP y diagnóstico de respuestas |
| 3.3 | RA1.g | ¿Qué contiene la aplicación? | Relacionar fuente, artefacto, runtime, configuración y datos | Inventario de recursos y mapa de ejecución |
| 3.4 | RA1.h | ¿Qué debe ofrecer el entorno? | Convertir el análisis en condiciones previas comprobables | Ficha de requisitos con valores, responsables y evidencias |
| 3.5 | RA1.e | ¿Dónde y con qué aislamiento se ejecuta? | Preparar VM, nube o contenedores | Entorno reproducible con red, puertos, volúmenes y límites |
| 3.6 | RA1.c | ¿Cómo entra la petición? | Instalar y configurar Nginx | Sitio configurado, validación de sintaxis y registros |
| 3.7 | RA1.d | ¿Quién ejecuta la aplicación? | Instalar y configurar Tomcat | Runtime compatible, WAR, puerto, contexto y logs |
| 3.8 | RA1.f | ¿Cómo sabemos que funciona? | Verificar la cadena y localizar fallos | Matriz de pruebas, resultados, incidencias y evidencias |
| 3.9 | RA1.i | ¿Cómo puede repetirse? | Convertir decisiones y evidencias en una guía operativa | Documentación versionada, segura y validada por otra persona |
2. Hilos conceptuales que atraviesan la unidad¶
Además de los contenidos concretos de cada tema, conviene mantener visibles varios hilos que dan coherencia al conjunto.
2.1. Funcionalidad antes que tecnología¶
La arquitectura se elige porque resuelve una necesidad. El alumnado debe poder explicar qué necesita la aplicación antes de decir que utilizará Nginx, Tomcat, Docker o una plataforma cloud. La tecnología aparece como una decisión posterior que debe justificarse por funcionalidad, mantenimiento, seguridad, coste o escalabilidad.
2.2. Separación de responsabilidades¶
La presentación, la lógica de negocio, el acceso a datos, la persistencia, el servidor web, el runtime y la infraestructura tienen responsabilidades diferentes. Separarlas no significa necesariamente instalar un servidor distinto para cada una: hay que distinguir capas lógicas, niveles de despliegue y unidades desplegables.
2.3. Evidencia frente a afirmación¶
«Está instalado», «funciona» o «es persistente» son afirmaciones incompletas. En cada punto debe preguntarse qué evidencia permite sostenerlas:
- una versión consultada;
- un archivo de configuración;
- una salida de comando;
- una respuesta HTTP;
- un registro;
- una prueba de reinicio o recuperación;
- una revisión realizada por otra persona.
2.4. Seguridad integrada en el despliegue¶
La seguridad no debe aparecer solo al final. Se introduce progresivamente:
- no exponer la base de datos ni el backend sin necesidad;
- separar redes y puertos internos de puertos publicados;
- proteger secretos y claves privadas;
- usar HTTPS cuando proceda;
- aplicar permisos mínimos;
- no confundir validación del cliente con autorización del servidor;
- conservar logs sin incluir credenciales ni datos innecesarios.
2.5. Reproducibilidad y recuperación¶
La unidad no termina cuando la aplicación responde una vez. Un despliegue profesional debe poder repetirse, actualizarse y recuperarse. Por eso se relacionan versiones, configuración, artefactos, pruebas, datos persistentes, copias y procedimiento de vuelta atrás.
Conviene diferenciar esta reproducibilidad de la redundancia y la alta disponibilidad. Poder levantar de nuevo tres contenedores con Compose no implica que existan instancias alternativas, detección de fallos, balanceo ni tolerancia a la caída de la máquina anfitriona.
3. Orientación punto por punto¶
3.1. Arquitecturas web — RA1.a¶
Criterio: «Se han analizado aspectos generales de arquitecturas web, sus características, ventajas e inconvenientes».
Papel dentro de la línea argumental¶
Este es el punto de partida. Antes de instalar un servicio hay que decidir qué componentes participan y qué responsabilidad tiene cada uno. El alumnado pasa de ver una aplicación como una página a representarla como un conjunto de componentes, comunicaciones y datos.
La pregunta rectora es:
¿Qué arquitectura permite atender la funcionalidad necesaria con una complejidad que el equipo pueda mantener?
Conceptos que conviene remarcar¶
- modelo cliente-servidor y diferencia entre rol y máquina;
- capas lógicas: presentación, lógica de negocio y acceso a datos;
- niveles de ejecución o despliegue (tiers) de dos, tres o más niveles;
- diferencia entre capas lógicas, niveles de despliegue y unidades desplegables;
- monolito organizado por capas frente a microservicios;
- reproducibilidad, distribución de componentes, redundancia y alta disponibilidad;
- evolución de la web sin asumir una progresión obligatoria hacia modelos más complejos;
- patrón MVC y su relación con la aplicación web clásica;
- servicios, microservicios, serverless y arquitectura orientada a eventos;
- ventajas, límites, coste operativo y criterios de decisión.
Mensaje docente principal¶
Las clasificaciones responden a preguntas distintas: cliente-servidor describe la interacción, las capas organizan responsabilidades lógicas, los niveles describen la distribución de ejecución y el monolito o los microservicios indican cómo se agrupan las unidades desplegables. Una aplicación puede ser cliente-servidor, estar organizada en tres capas lógicas, ser un monolito y ejecutarse en tres niveles. Varios contenedores pueden distribuir componentes que se comunican por red, pero tampoco son automáticamente microservicios ni proporcionan redundancia.
La redundancia exige instancias o recursos adicionales, detección de fallos, balanceo y una estrategia para los elementos compartidos. Dos instancias en una sola máquina pueden tolerar el fallo de una instancia, pero no la caída de la máquina completa.
Al presentar la evolución de la web, conviene evitar una explicación basada en «versiones» que sustituyen a las anteriores. Una web puede ser estática, una aplicación dinámica puede ser un monolito organizado en tres capas y un sistema grande puede combinar monolitos con servicios independientes. Estas clasificaciones no son excluyentes: hay que indicar si se está describiendo la forma de generar la interfaz, la organización lógica, la distribución de componentes o las unidades de despliegue.
Qué debería producir el alumnado¶
Dos representaciones relacionadas: un diagrama lógico que muestre las responsabilidades de presentación, negocio y acceso a datos, y un diagrama de despliegue que muestre navegador, servidor web, aplicación, persistencia, procesos o contenedores, protocolos y redes. No basta con dibujar cajas: hay que indicar qué componente atiende la petición, qué se publica y qué queda en una red interna. Si se afirma que existe redundancia, también debe indicarse qué instancias alternativas hay, cómo se detecta el fallo y qué dominio de fallo se tolera.
Enlace con el punto siguiente¶
Los diagramas plantean los componentes, sus responsabilidades y su distribución, pero todavía no explican con detalle el mensaje que circula. La transición natural es:
«Ya sabemos quién participa, qué responsabilidad tiene y dónde se ejecuta. Ahora vamos a seguir una petición concreta para saber cómo se comunican esos componentes».
Errores que conviene detectar¶
- elegir microservicios, Kubernetes o cloud antes de describir la funcionalidad;
- confundir una capa lógica con un nivel de despliegue, un contenedor o un servidor;
- poner la base de datos directamente a disposición del navegador;
- considerar que una arquitectura compleja es automáticamente mejor;
- confundir varios contenedores con microservicios o redundancia;
- creer que dos instancias en una misma máquina protegen frente a la caída de esa máquina;
- presentar la evolución desde la web estática hasta los microservicios como un camino obligatorio para cualquier proyecto;
- dibujar componentes sin flechas, protocolos, responsabilidades ni límites.
3.2. Comunicación web: HTTP y HTTPS — RA1.b¶
Criterio: «Se han descrito los fundamentos y protocolos en los que se basa el funcionamiento de un servidor web».
Papel dentro de la línea argumental¶
Este punto convierte el diagrama de arquitectura en un flujo observable. El alumnado aprende que una navegación implica DNS, dirección, puerto, conexión, petición, servidor web, backend, datos y respuesta. Esta secuencia será la base del diagnóstico de los puntos 3.6, 3.7 y 3.8.
Conceptos que conviene remarcar¶
- URL: esquema, host, puerto, ruta, consulta y fragmento;
- DNS, IP, puertos y conexiones;
- estructura de petición y respuesta HTTP;
- métodos
GET,POST,PUT,PATCH,DELETE,HEADyOPTIONS; - cabeceras, cuerpo y tipo MIME;
- códigos
2xx,3xx,4xxy5xx; - diferencia entre
401y403, y entre500,502,503y504; - cookies, sesiones, estado de la aplicación y CORS;
- HTTPS, TLS, certificado, confidencialidad, integridad y autenticación del servidor.
Mensaje docente principal¶
Un código HTTP es una pista, no un diagnóstico completo. Un 502 orienta hacia
la comunicación entre proxy y backend, pero hay que contrastarlo con la ruta, el
puerto y los registros. HTTPS protege el canal, pero no autentica por sí solo a
la persona usuaria ni autoriza operaciones de negocio.
Qué debería producir el alumnado¶
La lectura razonada de una URL y de un intercambio HTTP, junto con una
comprobación sencilla mediante curl. Conviene pedir que indiquen desde dónde se
lanza la prueba y qué componente podría haber generado la respuesta.
Enlace con el punto siguiente¶
Una vez comprendido el recorrido de la petición, hay que saber qué archivos, dependencias y datos hacen posible que ese recorrido funcione:
«La petición ya tiene un recorrido. Ahora vamos a abrir la aplicación y relacionar cada tramo con sus recursos reales».
Errores que conviene detectar¶
- tratar una URL como si fuera solo una dirección IP;
- pensar que el fragmento de una URL se envía al servidor;
- confundir
AcceptconContent-Type; - utilizar
GETpara cambiar o borrar datos; - interpretar
401como falta de permisos en lugar de falta de autenticación; - creer que un certificado autofirmado sirve automáticamente para producción;
- pensar que CORS autentica o protege una API.
3.3. Estructura de una aplicación web — RA1.g¶
Criterio: «Se ha analizado la estructura y recursos que componen una aplicación web».
Papel dentro de la línea argumental¶
Este punto conecta la arquitectura y HTTP con la entrega concreta que se va a desplegar. El alumnado deja de mirar únicamente la infraestructura y aprende a inspeccionar el proyecto: qué se edita, qué se construye, qué se ejecuta, qué se configura y qué datos deben sobrevivir.
Conceptos que conviene remarcar¶
- código fuente, artefacto y ejecución;
- recursos estáticos y dinámicos;
- configuración y secretos;
- dependencias de construcción y de ejecución;
- archivos de bloqueo y versiones reproducibles;
- WAR,
WEB-INF,pom.xml,package.json,composer.json,Dockerfileycompose.yaml; - runtime, punto de entrada, puerto y contexto;
- datos persistentes, temporales y externos;
- imagen, contenedor, red y volumen.
Mensaje docente principal¶
No se despliega «el repositorio entero» por defecto. Primero se identifica el artefacto correcto y se relaciona con el runtime que lo ejecutará. Una imagen o un WAR puede recrearse; los datos de trabajo deben permanecer en el servicio o volumen adecuado.
Qué debería producir el alumnado¶
Una ficha o inventario que responda, como mínimo:
- cuál es la entrada de la aplicación;
- qué artefacto se despliega;
- qué runtime necesita;
- qué variables cambian por entorno;
- qué servicios externos utiliza;
- qué puertos y rutas intervienen;
- qué datos deben persistir;
- cómo se comprobará cada decisión.
Enlace con el punto siguiente¶
El inventario describe lo que trae la aplicación. El siguiente paso describe lo que debe ofrecer el entorno:
«Ya sabemos qué contiene la entrega. Ahora convertiremos sus necesidades en requisitos previos medibles».
Errores que conviene detectar¶
- confundir
Dockerfilecon imagen y contenedor; - considerar
schema.sqlcomo si fueran los datos de producción; - incluir secretos en
.env, Git o la imagen; - copiar dependencias sin respetar el archivo de bloqueo;
- asumir la tecnología por el nombre de una carpeta sin comprobar la documentación ni el punto de entrada.
3.4. Requisitos de implantación — RA1.h¶
Criterio: «Se han descrito los requerimientos del proceso de implantación de una aplicación web».
Papel dentro de la línea argumental¶
Este punto transforma la inspección en una lista de condiciones que se pueden comprobar antes de instalar. Es el puente entre «la aplicación necesita una base de datos» y «el entorno debe proporcionar una base de datos compatible, una red interna, permisos, persistencia y una prueba de recuperación».
Conceptos que conviene remarcar¶
- requisito, restricción y supuesto;
- requisitos de sistema, software, red, configuración, almacenamiento, seguridad, operación y coste;
- valor esperado, prioridad, responsable y evidencia;
- puerto interno, puerto publicado y puerto permitido por firewall;
- nombres de servicio frente a IP efímeras;
- variables de entorno y gestión de secretos;
- compatibilidad de versiones;
- estados
Pendiente,Conforme,BloqueadoyExcepción; - salud, persistencia, copia y recuperación.
Mensaje docente principal¶
«El servidor debe ser rápido» no es un requisito comprobable. Un requisito útil
expresa una condición, un valor esperado y una prueba. Pendiente tampoco
significa Conforme: indica que aún falta verificarlo.
Qué debería producir el alumnado¶
Una ficha con columnas similares a:
| ID | Requisito | Prioridad | Valor esperado | Evidencia | Responsable | Estado |
|---|---|---|---|---|---|---|
| R-01 | Runtime compatible | Obligatorio | Java 17 y Tomcat compatible | Versiones y matriz del proyecto | Desarrollo | Pendiente |
| R-02 | Entrada web | Obligatorio | 443 público; backend interno | Firewall, ss y curl |
Infraestructura | Pendiente |
| R-03 | Persistencia | Obligatorio | Datos sobreviven a recrear servicios | Prueba de reinicio y restauración | Operación | Pendiente |
Enlace con el punto siguiente¶
Los requisitos todavía son condiciones de entorno. El siguiente punto aborda cómo preparar ese entorno mediante virtualización, nube o contenedores:
«Ya sabemos qué debe cumplir la plataforma. Ahora elegiremos cómo crearla y qué responsabilidades asumimos en cada opción».
Errores que conviene detectar¶
- confundir inventario de la aplicación con requisitos del entorno;
- publicar todos los puertos porque resulta cómodo;
- usar la IP de un contenedor como si fuera estable;
- escribir contraseñas reales en Compose o Git;
- marcar como correcto un requisito que todavía no tiene evidencia;
- olvidar coste, cuotas, recuperación o permisos.
3.5. Virtualización, nube y contenedores — RA1.e¶
Criterio: «Se ha realizado la instalación y configuración básica de tecnologías de virtualización de servidores en la nube y en contenedores».
Papel dentro de la línea argumental¶
Este punto prepara el lugar donde se ejecutarán los componentes. Debe presentarse como una decisión de infraestructura condicionada por los requisitos de 3.4, no como una introducción aislada a Docker o a la nube.
Conceptos que conviene remarcar¶
- hipervisor tipo 1 y tipo 2;
- máquina virtual, sistema anfitrión y sistema invitado;
- instancia cloud y modelo de responsabilidad compartida;
- IaaS, PaaS y CaaS;
- imagen, contenedor, motor, registro y ciclo de vida;
- red, puerto interno, puerto publicado y
expose; - volumen, bind mount y
tmpfs; - etiqueta, versión y digest;
- límites de CPU y memoria, usuario no privilegiado y rootless;
- coste, cuotas, apagado y eliminación de recursos cloud.
Mensaje docente principal¶
Un contenedor no es una máquina virtual pequeña: comparte el núcleo del
anfitrión. Un volumen proporciona persistencia, pero no es una copia de
seguridad. Que un contenedor esté en estado Up tampoco demuestra que el
servicio esté preparado para atender peticiones.
Qué debería producir el alumnado¶
Un entorno mínimo que incluya red, servicios, puertos, almacenamiento y configuración declarativa. Debe quedar justificado por qué se ha elegido una VM, una instancia cloud o contenedores y qué límites tiene la elección.
Enlace con el punto siguiente¶
Con el entorno preparado, la unidad pasa de la infraestructura a los servicios que atienden la aplicación:
«La plataforma ya existe. Ahora instalaremos el primer punto de entrada de la cadena: el servidor web».
Errores que conviene detectar¶
- publicar todos los puertos con
-p; - guardar los datos dentro del ciclo efímero del contenedor;
- usar
latestsin registrar la versión comprobada; - confundir volumen con backup;
- dejar recursos cloud encendidos o sin límites;
- tratar el grupo
dockercomo si fuera una cuenta sin privilegios.
3.6. Servidor web con Nginx — RA1.c¶
Criterio: «Se ha realizado la instalación y configuración básica de servidores web».
Papel dentro de la línea argumental¶
Nginx materializa el punto de entrada de la arquitectura. Aquí el alumnado instala el servicio, entiende cómo selecciona un sitio y una ruta, publica contenido estático y prepara la colaboración con el backend. La prueba completa se reserva para 3.8, por lo que en este punto conviene distinguir configuración válida de funcionamiento integral.
Conceptos que conviene remarcar¶
- servicio web, proceso principal y procesos de trabajo;
listen,server_name,serverylocation;- raíz del sitio y
try_files; sites-available,sites-enabled,conf.deinclude;- configuración efectiva mediante
nginx -T; nginx -t,reload,restarty ciclo de vida;- registros de acceso y error;
- proxy inverso y
proxy_pass; - cabeceras
Host,X-Real-IP,X-Forwarded-ForyX-Forwarded-Proto; - diferencia entre
localhostdel host ylocalhostde un contenedor.
Mensaje docente principal¶
Una configuración puede ser sintácticamente válida y no dirigir la petición al backend correcto. Deben separarse tres preguntas: si el proceso está administrado y escucha, si la configuración cargada es la esperada y si la respuesta llega al cliente.
Qué debería producir el alumnado¶
Un sitio identificable, una configuración validada, un recurso estático servido y un proxy básico preparado. Debe saber localizar el archivo que se carga, validar antes de recargar y consultar los registros después del cambio.
Enlace con el punto siguiente¶
Nginx puede recibir la petición, pero no ejecuta por sí mismo el WAR Java. El próximo punto prepara el runtime que atenderá las peticiones dinámicas:
«El servidor web ya sabe a dónde reenviar. Ahora hay que preparar el servicio que ejecuta la aplicación».
Errores que conviene detectar¶
- editar un archivo que no está incluido;
- recargar sin ejecutar
nginx -t; - apuntar a
localhostdesde un contenedor esperando alcanzar otro servicio; - exponer directamente el backend cuando Nginx es el punto de entrada;
- afirmar que el sitio funciona porque el servicio aparece como
active.
3.7. Servidor de aplicaciones con Tomcat — RA1.d¶
Criterio: «Se ha realizado la instalación y configuración básica de servidores de aplicaciones».
Papel dentro de la línea argumental¶
Tomcat completa la parte dinámica de la arquitectura. El alumnado aprende que Nginx y Tomcat no son sinónimos: el primero recibe y sirve o reenvía; el segundo proporciona el entorno de ejecución de la aplicación Java y despliega el WAR.
Conceptos que conviene remarcar¶
- servidor web frente a contenedor web o servidor de aplicaciones;
- servlet, ciclo de vida, conector,
Service,Engine,HostyContext; - Java, Tomcat y matriz de compatibilidad;
- diferencia entre
javax.servletyjakarta.servlet; CATALINA_HOMEyCATALINA_BASE;bin,conf,lib,logs,webapps,workytemp;server.xml, contexto y puerto8080;- WAR,
WEB-INF, nombre del contexto yROOT.war; - artefacto, imagen y procedimiento de despliegue;
- logs de despliegue y petición HTTP.
Mensaje docente principal¶
Que Tomcat escuche en 8080 no demuestra que el WAR se haya desplegado ni que
la aplicación funcione. Hay que combinar versión compatible, archivo presente,
contexto correcto, log de despliegue y petición a la ruta esperada.
También conviene aclarar que Tomcat es, en sentido estricto, un contenedor de servlets y JSP; no ofrece automáticamente todos los servicios de una plataforma Jakarta EE completa.
Qué debería producir el alumnado¶
Una instalación identificable de Tomcat, con Java compatible, puerto documentado, WAR desplegado, contexto conocido y logs consultados. La integración con Nginx debe quedar preparada, aunque la prueba extremo a extremo se cierre en 3.8.
Enlace con el punto siguiente¶
Ahora están preparados el entorno, Nginx y Tomcat. Falta demostrar que el recorrido completo funciona y poder localizar el punto exacto si falla:
«La cadena está configurada. Ahora vamos a comprobarla por capas, desde el entorno hasta los datos».
Errores que conviene detectar¶
- mezclar versiones incompatibles de Java, Tomcat y el WAR;
- confundir el puerto interno con el publicado;
- copiar el WAR a un directorio incorrecto;
- editar
workotempcomo si fueran configuración; - exponer Tomcat directamente sin necesidad;
- pensar que
redirectPortactiva HTTPS.
3.8. Pruebas de funcionamiento del despliegue — RA1.f¶
Criterio: «Se han realizado pruebas de funcionamiento de los servidores web y de aplicaciones, y de tecnologías de virtualización en la nube y en contenedores».
Papel dentro de la línea argumental¶
Este punto convierte las configuraciones anteriores en resultados comprobables. No se trata de probar al final de forma improvisada, sino de transformar cada requisito en un caso con precondiciones, origen, acción, resultado esperado, evidencia y limpieza.
Conceptos que conviene remarcar¶
- prueba de funcionamiento y condición observable;
- matriz de pruebas;
- pruebas de humo, integración, funcionales, extremo a extremo, recuperación y negativas;
- origen de la prueba: contenedor, red interna, anfitrión o cliente previsto;
- estado del proceso, puerto, DNS, HTTP, aplicación y persistencia;
- healthcheck frente a prueba funcional;
- interpretación de códigos HTTP junto con logs;
- datos sintéticos y limpieza;
- estados
PASS,FAIL,BLOCKEDyN/A; - incidencia reproducible y cambio aislado.
Mensaje docente principal¶
«Está en ejecución» no equivale a «funciona». Una prueba útil dice desde dónde se ejecuta, qué se solicita, qué resultado se esperaba, qué ocurrió y qué evidencia se conserva. Para diagnosticar, conviene avanzar de dentro hacia fuera y modificar una condición cada vez.
Qué debería producir el alumnado¶
Una matriz con pruebas de entorno, contenedor, red, Nginx, Tomcat, aplicación y persistencia. El informe debe incluir resultados, hora, versión, comandos, incidencias y conclusión, sin exponer secretos ni datos personales.
Enlace con el punto siguiente¶
Las pruebas generan evidencias y decisiones. El último punto reúne todo ese material en una guía que otra persona pueda utilizar:
«Ya hemos demostrado qué funciona y qué problemas quedan. Ahora convertiremos el proceso y sus evidencias en documentación reproducible».
Errores que conviene detectar¶
- probar solo desde
localhost; - aceptar un
200sin leer cabeceras, contenido ni logs; - confundir
runningconhealthy; - cambiar varias configuraciones antes de conservar el primer fallo;
- usar datos reales en lugar de datos sintéticos;
- considerar una captura aislada como una prueba reproducible.
3.9. Documentación reproducible de la instalación — RA1.i¶
Criterio: «Se han documentado los procesos de instalación y configuración realizados sobre los servidores web, de aplicaciones y sobre tecnologías de virtualización en la nube y en contenedores».
Papel dentro de la línea argumental¶
Este punto cierra la unidad y da sentido a los anteriores. La documentación no es una tarea decorativa posterior: recoge la arquitectura, los requisitos, las versiones, las decisiones, los comandos, las pruebas, las incidencias, la seguridad y la recuperación.
Conceptos que conviene remarcar¶
- guía para otra persona y contrato de la guía;
- hechos del entorno, acciones y resultados;
- alcance, requisitos previos y límites;
- documentación como código y control de versiones;
- versiones, etiquetas, digest y fecha de validación;
- arquitectura, comandos, archivos y resultados esperados;
- protección de secretos y datos sensibles;
- inicio, parada, actualización y rollback;
- revisión en un entorno limpio;
- relación entre prueba, incidencia y recuperación.
Mensaje docente principal¶
Una guía reproducible no es un historial de terminal ni una lista de comandos. Otra persona debe saber desde qué entorno ejecutarlos, qué resultado esperar, qué valores deben cambiar, cómo comprobar el resultado y cómo volver atrás.
Qué debería producir el alumnado¶
Una guía versionada con, como mínimo:
- alcance, destinatario y estado inicial;
- arquitectura y flujo de peticiones;
- versiones y requisitos;
- instalación y configuración;
- arranque, parada y actualización;
- matriz de pruebas y evidencias;
- incidencias y recuperación;
- límites de seguridad y tratamiento de secretos;
- fecha de validación y registro de cambios.
Enlace con el cierre de la unidad¶
La unidad termina cuando el alumnado puede defender la cadena completa:
«He elegido una arquitectura, sé cómo viaja la petición, conozco los recursos, he preparado los requisitos y el entorno, he configurado los servicios, he probado el despliegue y puedo explicar cómo repetirlo o recuperarlo».
Errores que conviene detectar¶
- documentar solo el resultado final;
- omitir versiones, estado inicial o directorio de ejecución;
- publicar claves, tokens, contraseñas o datos personales;
- copiar capturas sin comando, contexto ni resultado esperado;
- no explicar cómo detener, actualizar o recuperar el despliegue;
- no pedir a otra persona que siga la guía desde un entorno limpio.
4. Puentes explícitos entre los puntos¶
Estos puentes pueden utilizarse como cierre de una sesión y apertura de la siguiente. Ayudan a que el alumnado perciba la continuidad del proyecto.
| Transición | Idea que debe quedar cerrada | Pregunta de enlace |
|---|---|---|
| 3.1 → 3.2 | Ya se han decidido componentes y responsabilidades | ¿Qué mensaje intercambian y por qué puerto? |
| 3.2 → 3.3 | Ya se conoce el recorrido externo de la petición | ¿Qué archivos y procesos responden en cada tramo? |
| 3.3 → 3.4 | Ya se conocen recursos, dependencias y datos | ¿Qué condiciones debe ofrecer el entorno? |
| 3.4 → 3.5 | Ya existen requisitos verificables | ¿Qué plataforma permite cumplirlos con el aislamiento adecuado? |
| 3.5 → 3.6 | Ya existe el entorno de ejecución | ¿Cómo se publica y enruta la entrada web? |
| 3.6 → 3.7 | Nginx sirve o reenvía, pero no ejecuta el WAR | ¿Qué runtime atiende la petición dinámica? |
| 3.7 → 3.8 | Nginx y Tomcat están preparados | ¿Cómo se prueba cada tramo y la cadena completa? |
| 3.8 → 3.9 | Ya hay resultados, logs e incidencias | ¿Cómo puede otra persona repetir y recuperar el proceso? |
5. Qué remarcar en cada criterio de evaluación¶
| CE | No reducirlo a… | Remarcar que… | Evidencia mínima |
|---|---|---|---|
| a | Memorizar modelos | Hay que justificar una arquitectura por funcionalidad y compromisos | Diagrama y decisión razonada |
| b | Memorizar métodos y códigos | HTTP permite seguir y diagnosticar el recorrido de una petición | Petición, respuesta y explicación |
| c | Instalar Nginx | Hay que localizar, cargar, validar y observar la configuración | nginx -t, sitio y logs |
| d | Arrancar Tomcat | Hay que alinear Java, Tomcat, WAR, contexto, puerto y logs | Versiones, WAR, respuesta y registro |
| e | Ejecutar Docker | Hay que decidir aislamiento, red, persistencia, límites y responsabilidades | Entorno reproducible y configuración |
| f | Ver un 200 |
Hay que probar por capas, desde el origen correcto y con resultado esperado | Matriz de pruebas e incidencias |
| g | Enumerar carpetas | Hay que relacionar recursos con build, runtime, configuración y datos | Inventario y mapa de ejecución |
| h | Copiar requisitos genéricos | Cada requisito debe tener valor, responsable, prioridad y evidencia | Ficha verificable |
| i | Copiar comandos | La guía debe permitir repetir, comprobar, mantener y recuperar | Documento versionado validado |
6. Comprobación de comprensión durante la unidad¶
Estas preguntas sirven para detectar si se está comprendiendo la línea argumental o si el aprendizaje se ha reducido a ejecutar comandos.
Al terminar 3.1¶
- ¿Qué funcionalidad justifica la arquitectura propuesta?
- ¿Qué componente recibe la petición y cuál aplica las reglas de negocio?
- ¿Qué parte está publicada y qué parte queda interna?
- ¿Qué ventaja y qué coste tiene la alternativa descartada?
Al terminar 3.2¶
- ¿Qué ocurre antes de que exista una petición HTTP?
- ¿Qué diferencia hay entre un puerto interno y uno publicado?
- ¿Qué puede indicar un
502y qué evidencia falta para confirmarlo? - ¿Qué protege TLS y qué responsabilidad sigue teniendo la aplicación?
Al terminar 3.3 y 3.4¶
- ¿Cuál es el artefacto que se despliega?
- ¿Qué dependencia se necesita para construir y cuál para ejecutar?
- ¿Qué datos deben sobrevivir a recrear el contenedor?
- ¿Qué requisito tiene un valor esperado y una prueba asociada?
Al terminar 3.5, 3.6 y 3.7¶
- ¿Qué nivel administra el equipo y qué nivel administra el proveedor?
- ¿Qué puerto se publica y cuál debe permanecer interno?
- ¿Qué archivo o bloque configura el sitio de Nginx?
- ¿Qué versión de Java, Tomcat y WAR es compatible?
Al terminar 3.8 y 3.9¶
- ¿Desde qué origen se ejecuta cada prueba?
- ¿Qué resultado esperado distingue una prueba correcta de una respuesta casual?
- ¿Qué evidencia demuestra la persistencia y la recuperación?
- ¿Puede otra persona repetir el procedimiento sin instrucciones orales?
7. Cierre didáctico de la unidad¶
Al finalizar, el alumnado debería poder defender un despliegue con esta cadena de razonamiento:
- Funcionalidad: la aplicación necesita unas operaciones y unos datos.
- Arquitectura: esas necesidades se distribuyen entre cliente, servidor web, aplicación y datos.
- Comunicación: las peticiones siguen un recorrido con DNS, puertos, protocolos, mensajes y respuestas.
- Estructura: la entrega contiene fuente, artefactos, configuración, dependencias, runtime y datos.
- Requisitos: el entorno debe cumplir condiciones técnicas y de seguridad que se puedan verificar.
- Infraestructura: se elige y prepara una VM, una instancia cloud o un entorno de contenedores con red y persistencia.
- Servicios: Nginx publica y enruta; Tomcat ejecuta el WAR; cada componente tiene configuración, ciclo de vida y registros.
- Pruebas: la cadena se comprueba por capas y se documentan resultados e incidencias.
- Documentación: el procedimiento queda versionado, seguro, reproducible y recuperable.
Idea clave para el profesorado
La unidad no enseña a instalar herramientas aisladas. Enseña a convertir una necesidad funcional en una arquitectura, una arquitectura en requisitos, los requisitos en un entorno, el entorno en servicios configurados y los servicios en un despliegue probado y documentado.
Fuentes de trabajo¶
- Índice de la unidad 3.
- 3.1. Arquitecturas web.
- 3.2. Comunicación web: HTTP y HTTPS.
- 3.3. Estructura de una aplicación web.
- 3.4. Requisitos de implantación.
- 3.5. Virtualización, nube y contenedores.
- 3.6. Servidor web con Nginx.
- 3.7. Servidor de aplicaciones con Tomcat.
- 3.8. Pruebas de funcionamiento del despliegue.
- 3.9. Documentación reproducible de la instalación.
- Normativa del módulo profesional 0614.