Skip to content

Latest commit

 

History

History
165 lines (135 loc) · 6.37 KB

README.md

File metadata and controls

165 lines (135 loc) · 6.37 KB
Raw

Portail GPS 3 Vallées

Portail de suivi de la faune équipée de balises GPS dans le cadre de la Convention 3 Vallées

Technologies

Machine virtuelle :

  • Système d’exploitation Linux : Debian v10
  • Système de gestion de base de données relationnelles : PostgreSQL v15.2 et PostGIS v3.3.2
  • Logiciel de gestion de version décentralisé : Git v2.20.1
  • Gestionnaire de paquets : npm v9.8.1
  • Logiciel d’exécution JavaScript : Node.js v16.13.0

Machine physique :

  • Logiciel de terminal pour Windows : MobaXterm v23.0
  • Logiciel d’échange de fichiers entre serveur local et distant : WinSCP v5.21.7
  • Logiciel de base de données : DBeaver v23.0.1
  • Logiciel d’édition de code : Visual Studio Code
  • Extensions VSCode : Python v2023.14.0, Pylance v2023.8.30, Vue Language Features (Volar) v1.8.8
  • Navigateur web : Google Chrome.

Application :

Fonctionnalités

  • Liste des espèces de la convention
  • Liste des individus équipés
  • Affichage des traces GPS selon l'individu et la période sélectionnés
  • Onglets pour contextualiser l'application

Installation

Prérequis :

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install postgresql-15
sudo apt-get install postgis postgresql-15-postgis-3
sudo apt-get install python3
sudo apt-get install python3-venv
sudo apt-get instamm python3-pip
sudo apt-get install apache2
sudo apt-get install git
sudo apt-get install libpq-dev

sudo pip3 install gunicorn

Installation de nvm : wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

Relancez votre serveur puis installez npm et Nodejs : nvm install --lts

Installation de FollowDem-Admin

Clonez le dépôt (dans /home/user):

sudo wget https://github.com/PnVanoise/FollowDem-admin/archive/refs/heads/main.zip
unzip main.zip

Le projet ayant été élaboré sur une branche, il est possible qu'elle ne soit pas encore appliquée au main, si c'est le cas (dans /home/user) :

sudo wget https://github.com/PnVanoise/FollowDem-admin/archive/refs/heads/FDadmin-tests-stage.zip
unzip FDadmin-tests-stage.zip

Suivez la doc d’installation (ignorez la partie "Import des données") : https://github.com/PnVanoise/FollowDem-admin/blob/FDadmin-tests-stage/docs/installation.rst

Ouverture de la base de données depuis l'extérieur :

  • Ajoutez une entrée dans le fichier pg_hba.conf : sudo nano /etc/postgresql/15/main/pg_hba.conf
  • Dans le bloc IPv4 local connections ajoutez la ligne : host all all 0.0.0.0/0 md5
  • Ajoutez les adresses dans postgresql.conf : sudo nano /etc/postgresql/15/main/postgresql.conf
  • Dans la section CONNECTIONS AND AUTHENTICATION, décommentez la propriété listen_adresses et remplacez localhost par '*'
  • Redémarrez le service postgresql : sudo service postgresql restart

Création d'un cron pour alimenter la base de données automatiquement : crontab -e puis choisir 1

# Toutes les 6h à :00 import des données Ornitela
0 */6 * * * python3 /home/user/Portail-3-vallees/app/public/import_data.py 
# Toutes les 6h à :15 refresh la vue
15 */6 * * * PGPASSWORD="password" psql -h "localhost" -p "5432" -U "user" "followdem" -c "REFRESH MATERIALIZED VIEW followdem.vm_animals_loc WITH DATA;"

Déploiement Gunicorn :

  • Copiez et éditez le fichier de settings (restez en localhost pour pouvoir passer en HTTPS plus tard): cp ./settings.ini.sample ./settings.ini
  • Copiez le fichier de service : sudo cp ./GPS3V-admin.service.template /etc/systemd/system/GPS3V-admin.service
  • Editez le fichier de service (remplacez le user et le chemin vers le fichier gunicorn_start.sh): sudo nano /etc/systemd/system/GPS3V-admin.service
  • Rendre exécutable le fichier sh : chmod +x /home/user/GPS3vallees-admin/gunicorn_start.sh
  • Démarrez le service :
sudo systemctl start GPS3V-admin
sudo systemctl daemon-reload
sudo systemctl enable GPS3V-admin
  • Pour vérifier l’état du service : sudo systemctl status GPS3V-admin
  • Pour arrêter le service si besoin : sudo systemctl stop GPS3V-admin
  • Pour relancer le service si besoin : sudo systemctl restart GPS3V-admin
  • Pour stopper le service si besoin : sudo systemctl disable GPS3V-admin

Installation de GPS 3 Vallées

Clonez le dépôt (dans /home/user):

sudo wget https://github.com/PnVanoise/Portail-3-vallees/archive/refs/heads/main.zip
unzip main.zip

Installez les packages (pour les librairies Leaflet, Bootstrap notamment) :

cd Portail-3-vallees/app 
npm install
npm install leaflet
npm install [email protected]
npm update --save

Personnalisation de l'application :

  • Copiez et éditez le fichier de config situé dans /public : cp ./config.json.sample ./config.json
  • Développement de l’application : npm run dev
  • Sur une IP spécifique : npm run dev -- --host IP
  • Compil de l’application pour la production (création d’un répertoire dist) : npm run build

Déploiement Apache :

  • Copiez la configuration située dans /app : sudo cp ./conf_apache.template /etc/apache2/sites-available/GPS3vallees.conf
  • Editez (le contenu de Location correspond au back-end déployé précédement): sudo nano /etc/apache2/sites-available/GPS3vallees.conf
  • Ajoutez les modules proxy :
sudo a2enmod proxy
sudo a2enmod proxy_http
sudo systemctl restart apache2
  • Activez le service : sudo a2ensite GPS3vallees.conf
  • Redémarrez Apache2 : sudo systemctl restart apache2

Votre site a été mis en ligne. Exemple d'appel API : http://mondomaine.fr/admin/api/v_animals

Ou : http://127.0.0.1:5000/api/v_animals (l'adresse est inaccessible c'est normal)

Sécurisation du site

Basé sur https://docs.geonature.fr/https.html :

  • Installez certbot : sudo apt-get install python3-certbot-apache
  • Lancez et générez le certificat pour votre domaine : sudo certbot --apache --email [email protected]
  • Activez les modules :
sudo a2enmod ssl
sudo a2enmod rewrite
sudo a2enmod headers
sudo apachectl restart

N'oubliez pas de modifier le fichier conf.json du front et de passer l'api_url en https.

Votre site est maintenant en HTTPS.

Copyright

Auteur·ices :

Parc National de la Vanoise

  • Alix Cornu-Lachamp
  • Claire Lagaye
  • Christophe Chillet

Licence :

  • OpenSource
  • (c) GPS 3 Vallées 2023 Parc National de la Vanoise