====== 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 ''main'' y 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: @startuml !theme cerulean skinparam backgroundColor transparent skinparam shadowing false skinparam ArrowThickness 1 skinparam classAttributeIconSize 0 skinparam class { BackgroundColor #FEFEFE BorderColor #344883 ArrowColor #344883 FontColor #0F172A } skinparam classAttributeFontColor #0F172A skinparam stereotypeCBackgroundColor #344883 skinparam stereotypeCBorderColor #273768 skinparam package { BackgroundColor transparent BorderColor #344883 FontColor #0F172A } skinparam ArrowColor #344883 skinparam participant { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } skinparam actor { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } skinparam sequence { ArrowColor #344883 LifeLineBorderColor #94A3B8 GroupBorderColor #344883 GroupBackgroundColor #E9EDF7 } skinparam note { BackgroundColor #FEF9C3 BorderColor #B6C2DE FontColor #0F172A } skinparam activity { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A StartColor #344883 EndColor #344883 DiamondBackgroundColor #FEFEFE DiamondBorderColor #344883 DiamondFontColor #0F172A } skinparam component { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } skinparam database { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } skinparam node { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } skinparam cloud { BackgroundColor transparent BorderColor #344883 FontColor #344883 } skinparam rectangle { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } skinparam state { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } skinparam usecase { BackgroundColor #FEFEFE BorderColor #344883 FontColor #0F172A } actor "Navegador" as Browser node "nginx\npuerto 80" as Nginx node "App\nTomcat :8080" as App database "MariaDB\n:3306" as Db node "MinIO\n:9000" as Minio Browser --> Nginx : HTTP (único puerto publicado) Nginx --> Browser : frontend estático Nginx --> App : /api/** (reverse proxy) App --> Db : JDBC (red interna) App --> Minio : API S3 (red interna) @enduml 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: [[clase:daw:si:arquitectura|Arquitectura de aplicación en SI]] * Git en el proyecto: [[clase:daw:proyecto-1daw:tema03|Git en el proyecto]] * Build y despliegue local: [[clase:daw:proyecto-1daw:tema04|Build y despliegue local]] * Test: [[clase:daw:proyecto-1daw:tema05|Test]]