Instalación de la plataforma¶

En desarrollo

Esta sección está siendo actualizada. La documentación se basan en versiones nightly del código.

Instalación del backend¶

Prerrequisitos¶

Instala el software requerido por el backend descrito en Requisitos del sistema.

Compilación¶

En desarrollo

Esta sección está siendo actualizada. Las instrucciones de instalación son un ejemplo de como serán en un futuro. Actualmente, se recomienda solo usar en modo de prueba heroku-dev-full que requiere de una base de datos postgres.

Una vez completada la instalación de los prerrequisitos y la configuración, puedes proceder con la compilación del backend siguiendo estos pasos:

Descarga el proyecto https://github.com/sitmun/sitmun-backend-core en tu equipo.
Crea un proyecto nuevo a partir de las plantillas de la carpeta deploy y añádelo a settings.gradle.
Configura el fichero application.yml del nuevo proyecto. Ver Configuración.
Ejecutar el siguiente comando desde la raíz del proyecto en una terminal.
```
./gradlew clean :[proyecto]:build
```
Este comando genera el fichero JAR del proxy en la ruta .[proyecto]/build/libs/[proyecto]-${version}.jar con el nombre [proyecto]-[version].jar.

Despliegue¶

Los sistemas operativos en los que se pueden desplegar el backend son:

Linux: como servicio init.d, como servicio systemd o mediante un script de arranque.
Windows: puede ejecutarse como un servicio Windows usando la herramienta WinSW o mediante un script de arranque.

Instalación del proxy¶

Prerrequisitos¶

Instala el software requerido por el proxy descrito en Requisitos del sistema.

Compilación¶

Una vez completada la instalación de los prerrequisitos y la configuración, puedes proceder con la compilación del proxy siguiendo estos pasos:

Descarga el proyecto https://github.com/sitmun/sitmun-proxy-middleware en tu equipo.
Abre el proyecto descargado y modifica del fichero application.yml las propiedades security.authentication.middleware.secret y sitmun.config.url. security.authentication.middleware.secret debe contener el token que se ha configurado en el backend para que el proxy pueda autenticarse. sitmun.config.url debe contener la URI de la API de Configuración y Autorización del backend. Si el proxy y el backend son servicios internos de la misma red, se recomienda usar el nombre interno o la dirección IP interna del backend. Ver Configuración.
Ejecutar el siguiente comando desde la raíz del proyecto en una terminal.
```
./gradlew clean build
```
Este comando genera el fichero JAR del proxy en la ruta ./build/libs/ con el nombre sitmun-proxy-middleware-[version].jar.

Despliegue¶

Los sistemas operativos en los que se pueden desplegar el proxy son:

Linux: como servicio init.d, como servicio systemd o mediante un script de arranque.
Windows: puede ejecutarse como un servicio Windows usando la herramienta WinSW o mediante un script de arranque.

El proxy middleware puede ser desplegado usando Docker. En la raíz del proyecto se encuentra la carpeta docker, en la cual se puede encontrar el fichero docker-compose.yml y el fichero Dockerfile.

Si se quiere desplegar únicamente el proxy, se puede hacer construyendo y arrancando la imagen del Dockerfile.

docker build -t sitmun/proxy-middleware .
docker run -p 8080:8080 sitmun/proxy-middleware

Como se ha comentado anteriormente, el proxy depende de la API de Configuración y Autorización y, por lo tanto, es importante tener correctamente configurada la URL a la API en el fichero de configuración (sitmun.config.url).

Es posible desplegar el proxy middleware en local sin necesidad de Docker mediante JVM ejecutando el siguiente comando en la ubicación del fichero JAR generado al construir el proxy.

java -jar sitmun-proxy-middleware-[version].jar

Instalación del visor de mapas¶

Prerrequisitos¶

Instala el software requerido por el visor de mapas descrito en Requisitos del sistema.

Compilación¶

Una vez completada la instalación de los prerrequisitos puedes proceder con la compilación del visor de mapas siguiendo estos pasos:

Descarga el proyecto https://github.com/sitmun/sitmun-viewer-app en tu equipo.
Obtiene un token de GitHub para trabajar con el registro de npm de GitHub Packages.
Desde la consola de comandos ejecuta el siguiente comando para autenticarte en el registro de GitHub Packages de npm:
```
npm set //npm.pkg.github.com/:_authToken <token>
```

Sustituye <token> por el token que has obtenido en el paso anterior. 4. Abre el proyecto descargado y modifica el parámetro apiUrl en el archivo environments.ts para que apunte a la URI donde está desplegado el backend. Ver Configuración. 5. Desde la consola de comandos, navega hasta el directorio raíz del proyecto y ejecuta el comando:

  ```shell
  npm ci
  npm build -- --configuration=<conf> --baseHref=<baseHref>
  ```

Donde <conf> es la configuración y <baseHref> es la URI donde se va a desplegar. Este comando compilará el visor de mapas para el entorno de producción y generará los archivos en la carpeta dist/sitmun-admin-app.

Despliegue¶

Para desplegar el visor de mapas en un servidor web, copia la carpeta sitmun-viewer-app a tu servidor web.

Configura tu servidor para redirigir las solicitudes de archivos no encontrados a index.html Es fundamental configurar correctamente esta redirección para el correcto funcionamiento del visor de mapas.

No olvides configurar la redirección a index.html en tu servidor

Si no se configura correctamente la redirección, es posible que la navegación dentro del visor de mapas funcione correctamente, pero al hacer clic en un enlace externo (por ejemplo, un enlace de correo electrónico), al introducir una URI directamente en la barra de direcciones o simplemente al refrescar la página, se produzca un error 404. Esto ocurre porque estas peticiones son manejadas directamente por el navegador y no por enrutador de Angular que gestiona la navegación dentro del visor de mapas. Ver Routed apps must fall back to index.html en la documentación oficial de Angular para más información.

Instalación del administrador¶

Prerrequisitos¶

Instala el software requerido por el administrador descrito en Requisitos del sistema.

Compilación¶

Una vez completada la instalación de los prerrequisitos puedes proceder con la compilación del administrador siguiendo estos pasos:

Descarga el proyecto https://github.com/sitmun/sitmun-admin-app en tu equipo.
Obtiene un token de GitHub para trabajar con el registro de npm de GitHub Packages.
Desde la consola de comandos ejecuta el siguiente comando para autenticarte en el registro de GitHub Packages de npm:
```
npm set //npm.pkg.github.com/:_authToken <token>
```

Sustituye <token> por el token que has obtenido en el paso anterior. 4. Abre el proyecto descargado y modifica el parámetro apiUrl en el archivo environments.ts para que apunte a la URI donde está desplegado el backend. Ver Configuración. 5. Desde la consola de comandos, navega hasta el directorio raíz del proyecto y ejecuta el comando:

  ```shell
  npm ci
  npm build -- --configuration=<conf> --baseHref=<baseHref>
  ```

Donde <conf> es la configuración y <baseHref> es la URI donde se va a desplegar. Este comando compilará el administrador para el entorno de producción y generará los archivos en la carpeta dist/sitmun-admin-app.

Despliegue¶

Para desplegar el administrador en un servidor web, copia la carpeta sitmun-admin-app a tu servidor web.