GitLab

Dependencias necesarias

A continuación se listan las versiones de software utilizadas para la creación y compilación del proyecto. Versiones diferentes podrían ser válidas, aunque esto no está garantizado. Todo el software se descargó del repositorio oficial del CESTIC (accesible desde INTRANET), aunque se incluyen rutas de descarga a los repositorios externos oficiales de cada aplicación.

1. Node.js (v24.7.0) y npm (v11.5.1): Descarga: nodejs.org
2. Maven (v3.9.11): Descarga: maven.apache.org
3. Java Development Kit (v17.0.2): Descarga: Oracle

Instrucciones para desarrollar el frontend

• Clonar el repositorio
• Ejecutar una consola/terminal dentro de la carpeta del repositorio.
• Cambiar al directorio del frontend ejecutando cd frontend.
• Ejecutar npm install para instalar las dependencias de Node.js.
• Realizar los cambios que se requieran en el código. Ejecutado npm run dev en la terminal se pueden ver los cambios en tiempo real.

Instrucciones para desarrollar el backend

• Clonar el repositorio.
• Importar el proyecto Maven en Eclipse. El directorio raíz del backend contiene el pom.xml general y las carpetas de los diferentes módulos. Al importarlo, aparecerán todos los módulos del proyecto.
• Abrir el menú Debug Configurations. Seleccionar Spring Boot App y la pestaña demeter-aplicacion - ArranqueAplicacion.
• En la pestaña Spring Boot seleccionar Override properties e introducir:

spring.config.location=ruta-a-los-repositorios/demeter/conf/local/application.properties

Esto es necesario ya que application.properties no se encuentra dentro del módulo demeter-aplicacion.

• En la pestaña Arguments seleccionar VM arguments e introducir:

-Dlog.dir="C:/temp/logs" -Dserver.name=localhost -Dnombre.app=demeter

• Guardar y salir.
• El módulo que se debe ejecutar en el IDE es el denominado demeter-aplicacion.

Instrucciones para desplegar el frontend

• Clonar el repositorio
• Ejecutar una consola/terminal dentro de la carpeta del repositorio.
• Cambiar al directorio del frontend ejecutando cd frontend.
• Ejecutar npm install para instalar las dependencias de Node.js.
• Ejecutar npm run build para construir los archivos que se deben desplegar en el servidor. Los archivos generados se encontrarán en la carpeta dist.

Instrucciones para desplegar el backend

• Clonar el repositorio
• Ejecutar una consola/terminal dentro de la carpeta del repositorio.
• Cambiar al directorio raíz del backend ejecutando cd demeter.
• Compilación. Existen dos formas de compilar el backend, generando un archivo jar o un archivo war. La diferencia radica en que los jar se utilizan para proyectos no desplegados en servidor, mientras que los war se usan para aplicaciones desplegadas.

Generar el war

• Incluir en el pom.xml del módulo demeter-aplicacion:

<packaging>war</packaging>

• Añadir el siguiente plugin dentro de <plugins>:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-war-plugin</artifactId>
  <version>3.4.0</version>
  <configuration>
    <failOnMissingWebXml>false</failOnMissingWebXml>
  </configuration>
</plugin>

• Ejecutar en la carpeta raíz del backend (la que contiene el pom.xml general y las carpetas de cada módulo) mvn clean package
• El archivo war generado se encuentra en la ruta demeter/demeter/demeter-aplicacion/target.

Generar el jar

• Eliminar del pom.xml del módulo demeter-aplicacion los elementos especificados en el apartado war.
• Ejecutar en la carpeta raíz del backend (la que contiene el pom.xml general y las carpetas de cada módulo) mvn clean package
• El archivo jar generado se encuentra en la ruta demeter/demeter/demeter-aplicacion/target.

Ejecución

En la máquina de despliegue:

• Crear la carpeta demeter y dentro de ella la carpeta logs.
• Copiar la carpeta conf desde la raíz del repositorio a demeter. Esta contiene el archivo application.properties y los certificados.

Ejecutar el backend desde la carpeta demeter con el comando:

java -jar -Dlog.dir="<ruta-a-demeter>\logs" -Dserver.name=<nombre-del-servidor> -Dnombre.app=demeter demeter-aplicacion.jar --spring.config.location="<ruta-a-demeter>\conf\local\application.properties"

Los parámetros de ejecución coinciden con los configurados en Eclipse para el desarrollo.