06 - Despliegue en producción
Una aplicación que funciona en el ordenador del equipo todavía no está disponible para sus usuarios. Para publicarla hay que llevar una versión comprobada al servidor, iniciar sus servicios y verificar que responde desde la URL asignada.
En el proyecto, el despliegue se realiza manualmente por SSH. Cada pareja tiene una URL y un proyecto Docker Compose propios. La rama que se publica es main.
1. Desarrollo local y producción
El despliegue local del tema 04 sirve para desarrollar y probar la aplicación en el equipo. Producción, en cambio, es el entorno compartido al que se accede desde la URL de la pareja. No se debe confundir el uso local de dev.sh con la publicación de una versión en ese servidor.
Antes de desplegar, el equipo debe comprobar que los cambios que quiere publicar están en main y que la versión ha superado las pruebas del tema 05. Una vez preparada, el acceso al servidor y la publicación se realizan manualmente:
- Comprobar los cambios de
mainy que la versión está lista. - Conectarse por SSH con el acceso proporcionado por el profesorado.
- Ejecutar el despliegue en el servidor.
- Verificar el estado de los servicios, consultar logs si hace falta y abrir la URL de la pareja.
Los nombres de host, usuarios, rutas y URL concretos los proporciona el profesorado. No deben inventarse ni compartirse en el repositorio.
2. Servicios de la aplicación
La aplicación se compone de cuatro servicios gestionados con Docker Compose:
- Frontend: los archivos TypeScript se compilan a JavaScript estático y nginx los sirve.
- nginx: es el punto de entrada público. Además de servir el frontend, reenvía las peticiones a
/api/hacia la API. - API Spring Boot: procesa las peticiones de la aplicación.
- MariaDB y MinIO: proporcionan almacenamiento de datos y de archivos.
El recorrido de una petición es el siguiente:
La configuración del proyecto debe construir o preparar el frontend para servir su JavaScript y construir o ejecutar la aplicación Spring Boot. Los comandos concretos de compilación dependen del proyecto; no hay que asumir herramientas o instrucciones que no se hayan acordado.
Solo nginx queda accesible mediante el proxy del servidor. La API, MariaDB y MinIO permanecen en la red interna de Docker Compose. No se deben publicar al exterior los puertos de MariaDB ni de MinIO.
3. Aislamiento en el servidor compartido
El servidor aloja los proyectos de varias parejas. Para evitar que sus contenedores y datos se mezclen, cada equipo dispone de una configuración de proyecto Compose y de volúmenes persistentes propios.
- El nombre de proyecto de Compose (
COMPOSE_PROJECT_NAME) debe ser el asignado a esa pareja. - Los volúmenes de MariaDB y MinIO deben ser propios del proyecto.
- La URL de la pareja y su configuración en el proxy corresponden al profesorado o a la administración del servidor.
El alumnado no debe cambiar la configuración global del servidor, el proxy ni la asignación de URL. Un despliegue normal puede reconstruir o actualizar servicios, pero no debe borrar los volúmenes de producción. Así se conservan los datos entre despliegues.
4. El script ''devops-cloud.sh''
El equipo crea devops-cloud.sh para reunir las operaciones habituales de despliegue y consulta. Es una interfaz sencilla para el proyecto, no una herramienta para administrar globalmente el servidor. Se utiliza manualmente y trabaja con la pareja, su URL y el proyecto Compose asignados.
El contrato del script incluye estos comandos:
| Comando | Comportamiento esperado |
|---|---|
deploy | Publica o actualiza main, construye y levanta el stack, espera a que los servicios estén saludables e informa de la URL asignada. No elimina los volúmenes de MariaDB ni de MinIO. |
status | Muestra el estado del stack y la URL de la pareja. |
log [servicio] | Muestra los logs de todos los servicios o, si se indica uno, de ese servicio. |
undeploy | Detiene el stack y conserva los datos persistentes. |
help | Muestra los comandos disponibles y su uso. |
Antes de actuar, el script debe comprobar las precondiciones necesarias y comunicar los errores de forma clara. Por ejemplo, debe informar si no se está en el servidor o proyecto esperado, si falta la configuración asignada a la pareja, si no puede actualizar main o si un servicio no llega a estar saludable. Ante un error, no debe ocultar el problema ni continuar con una configuración global distinta.
El método concreto para actualizar el código y construir los servicios debe ajustarse a la infraestructura y al proyecto. El script no sustituye la conexión manual por SSH ni implica automatizaciones con GitHub Actions, despliegues por ramas o publicación de varias URL.
5. Verificación y seguridad
Un despliegue no termina al iniciar los contenedores. El equipo debe comprobar que el stack está activo, revisar los logs si aparece un error y abrir la URL asignada para confirmar que el frontend carga y que las peticiones a la API funcionan.
Las credenciales, claves SSH, tokens y demás secretos no se guardan en Git. Tampoco se deben incluir contraseñas ni datos bancarios reales en el código, los archivos de configuración versionados o los logs. La forma de proporcionar al proyecto los valores sensibles necesarios debe seguir las indicaciones del profesorado; no se deben inventar valores ni modificar la configuración global del servidor.
6. Referencias del proyecto
- Arquitectura de aplicación en SI: Arquitectura de aplicación en SI
- Git en el proyecto: Git en el proyecto
- Build y despliegue local: Build y despliegue local
- Test: Test