Lancement en local:
- Installer les modules : npm install
- Lancer l'application : npm run start:dev
(ou start:prod pour tester la configuration de production)
Déploiement:
Sur le serveur via SSH:
- Installer node & npm : sudo apt install nodejs npm -y
- Installer pm2 : npm install pm2 -g
Sur le serveur via FTP:
- Livrer l'application dans le dossier backendapp (sans le dossier dist & node_modules)
Sur le serveur via SSH:
- Entrer le répertoire : cd backendapp
- Installer les modules : npm install
- Supprimer le fichier
development.env
s'il existe : rm src\common\envs\development.env - Builder l'application : npm run build
- Stopper le service s'il est déjà lancé : pm2 stop main
- Supprimer le service : pm2 delete main
- Lancer à nouveau le service : pm2 start dist/main.js
Déploiement continue:
Le fichier .gitlab-ci.yml décrit le l'intégration et le déploiement continue de la solution. L'ensemble de la solution étant conteneurisée, elle se construit et se déploie facilement sur OpenShift. Le CI/CD est paramétrer pour construire et déployer une image docker du Back-end du calque de plantabilité, ainsi qu'un serveur de tuile au choix, soit Qgis, soit GeoServer.
Paramétrage de Qgis
Le paramétrage de Qgis se est intégré dans le fichier ./qgis/data/calque-planta.qgs.template. Ce fichier est parsé à la construction de l'image de Qgis et les paramètres de base de données y sont intégrés selon l'environnement de déploiement.
paramétrage de Geoserver
Le paramétrage du Geoserver est archivé dans le fichier ./geoserver/geoserver-params.zip. Cette archive est dézippée et montée sur un volume persistant dans l'image de geoserver au moment de sa construction.
Pour modifier ce paramétrage, il est nécessaire de construire et de monter l'image de Geoserver en local, puis accéder à l'interface de paramétrage à l'url http://localhost:8080/geoserver/ (login et mot de passe par défaut sur l'environnement de dev).
Génération du cache
Un script bash permet de lancer le (re)calcul/troncature du cache en ligne de commande : /opt/regenerate-cache.sh
Il est lancé au startup de tomcat/geoserver mais attend le démarrage du server.