Déploiement et configuration d'un serveur QFieldCloud#

Date de publication initiale : 6 février 2024

Dans cet article, nous allons voir comment mettre en place un serveur QFieldCloud custom, qui permettra pour vos enquêtes et relevés terrain de synchroniser vos données entre QGIS, graĉe au plugin QFieldSync, et l'application QField, et ce sans avoir à brancher ni péter des câbles.

Les informations se trouvent ici , merci de lire et suivre les instructions #RTFM.

Voilà, au revoir, merci, bon week-end et Joyeuses Pâques !

Auteur#

Jean-Marc Jisse#

Je m'appelle Jean-Marc Jisse, je suis le cousin un peu tech de Jean-Claude Dusse, je dois mettre à jour mes refs, j'adore le jardinage et je déteste le bricolage !

Licence #

Ce contenu est sous licence PV.

NAN NAN ATTENDEZ !! PARTEZ PAS C'EST PAS FINI !

Bon allez, on reprend.

Mise en place d'une instance QFieldCloud#

Connaissez-vous QField ? QField c'est de la magie ! Mais c'est pas ambiance au chaud, le Q vissé dans son siège, dans une salle avec des rideaux qui s'ouvrent, avec des chapeaux desquels sortent des lapins ... tout ça c'est la magie de QFieldSync. QField, c'est de la magie plutôt ambiance dehors, avec gourde, sac-à-dos, casquette, lunettes, parce qu'y'a du monde partout, ça chauffe à l'arrière de la Modus [...] là j'suis tranquille, j'passe vers le marché aux Puces, posé à la playa playa, avec tous les vaillants vaillants

Plus concrètement, il s'agit d'une application mobile de saisie et relevé terrain, hautement compatible avec QGIS, permettant de reproduire les paramétrages de saisie et formulaires des couches quasi à l'identique, poussée par OPENGIS.ch qu'on remercie pour tout le développement made with . Un précédent article explique plus en détail un processus de relevé grâce à l'appli QField qu'on ne présente dorénavant plus.

Maintenant, connaissez-vous Claude QField, la cousine un peu éloignée de Jean-Marc ? Euh non, pardon, "le cloud QField", "QFieldCloud", QFC pour les intimes. Aucun rapport avec Quantum Fried Chicken, même si on va voir qu'il est parfois question de buckets. QfieldCloud c'est LA brique qui permet de faire la liaison cloud entre QGIS et QField, faisant ainsi de ce triptyque un système robuste et complet d'enquête terrain. QFieldCloud offre entre autres la possibilité de synchroniser les données saisies dans QField directement dans l'application, grâce à un mode semi-offline bien articulé, qui permet de se libérer de pas mal de contraintes concernant le transfert de données PC - smartphone/tablette initialement filaire. Ainsi qu'un système de droits et d'accès aux projets qui permet de gérer finement la configuration et les permissions de plusieurs utilisateur/rices en lecture-écriture.

Infrastructure#

Si vous êtes toujours là, c'est donc que vous n'aimez pas les ceintures et les bretelles. Un traumatisme survenu lors de la Fête de la Bière peut-être ? N'hésitez pas à partager vos aventures dans la partie commentaires.

À moins que ce soit des gusses de la cybersécurité qui vous aient dit "gnagnagna c'est nous qu'on doit héberger les données"... Bon, toute ressemblance avec des situations existantes ou ayant existé serait purement fortuite.

Pour le déploiement, on aura besoin d'un système Linux. On va partir sur une VM sous debian 12. Si vous avez un gentil Service Informatique capable de vous fournir ça, vous pouvez gentiment leur demander. Ou alors en commander une chez votre hébergeur préféré, ce qui va être fait ici pour la suite, chez un hébergeur bavarois. Eh oui, vive la bière ! Vive les traumatismes !

Concernant les specs, pas forcément besoin de beaucoup de ressources, enfin tout dépend du nombre d'utilisateur/rices simultané/es que vous souhaitez pouvoir supporter. Ceci dit le côté asynchrone de QFieldCloud et le fonctionnement de la synchronisation en semi-offline le rend peu gourmand en ressources. Ici 4 CPU et 6GB de RAM nous suffiront.

Au niveau de l'espace de stockage, il nous faudra au grand minimum une vingtaine de Go. Prenons-en 100 pour être sûrs #CeintureEtBretelles. D'autant plus que nous verrons par la suite qu'il y a la possibilité de stocker nos données géo des projets QGIS (geopackages, photos...) séparément du stockage principal du système QFieldCloud, via des buckets respectant le protocole "Simple Storage Service". Même si ici (spoiler) nous allons tout stocker sur le même serveur.

Il nous faudra également une entrée DNS qui pointe vers la VM. Ici ce sera une entrée de type A et le nom de domaine "qfieldcloud.pennarmenez.com" qui pointe vers la VM mise en place pour l'article.

Installations#

Une fois l'accès à la VM effectif, on s'y connecte via une session ssh. Commençons par créer un utilisateur pour gérer l'installation et le déploiement, auquel on donne le sudo:

adduser --shell /bin/bash qfc
apt install -y sudo
usermod -aG sudo qfc

Il nous faudra ensuite installer git, de sorte à pouvoir récupérer le dépôt QFieldCloud par la suite :

apt install -y git

Maintenant, il est nécessaire d'installer docker, en suivant les instructions de la doc officielle dont voici les commandes résumées, que vous pouvez copier-coller (le savoir-faire numero uno de tout/e développeur/se qui se respecte):

sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Docker (et compose) sont les outils de containerisation qui nous permettront de lancer les différents services nécessaires pour notre instance QFieldCloud, qu'il n'est pas recommandé de lancer en tant que root. C'est pourquoi on peut ajouter l'utilisateur qfc précédemment créé au groupe docker :

usermod -aG docker qfc

Puis on lance une session avec cet utilisateur via su qfc.

Un zeste de RTFM#

Suivons maintenant les instructions sur le dépôt GitHub de QFieldCloud :

• récupérer le code du dépôt avec git :

# si vous avez renseigné une clé SSH/GPG sur votre compte GitHub
git clone --recurse-submodules git@github.com:opengisch/qfieldcloud.git

# si vous n'avez pas de clé SSH enregistrée
git clone --recurse-submodules https://github.com/opengisch/qfieldcloud.git

• basculer sur la branche de la dernière version, 0.24.0 à l'heure où sont écrites ces lignes :

cd qfieldcloud
git checkout v0.26.4

• copier le fichier .env.local vers un fichier .env qui va contenir toute la configuration du serveur :

cp .env.example .env

Paramétrage#

Jetons à présent un coup d' sur ce fichier .env, qui va contenir le gros de la configuration du serveur. Il s'agit d'une liste de variables d'environnement ÉCRITES EN MAJUSCULES dont il nous faut adapter certaines :

• ENVIRONMENT=production : on passe en prod direct tester c'est douter

• QFIELDCLOUD_HOST : dans cette variable on met le nom de domaine utilisé pour l'instance QFieldCloud, "qfieldcloud.pennarmenez.com" dans notre cas

• SECRET_KEY : générer une clé et la mettre ici, via pwgen 64 par exemple

• les variables qui commencent par STORAGE_ font référence au bucket compatible S3 dans lequel seront stockées les données géo : projets QGIS, geopackages, photos ... Il est possible d'utiliser un bucket de grande enseigne si vous le souhaitez, mais l'équipe de Geotribu vous propose d'utiliser un bucket frais, local et de saison avec minio. Qui possède en plus le (gros) avantage de ne rien avoir à changer au niveau de la config (sauf la variable STORAGE_SECRET_ACCESS_KEY bien sûr), étant donné que le dépôt de QFieldCloud propose la mise en place d'un service de buckets minio que nous allons voir dans la suite

• les variables qui commencent par POSTGRES_ représentent les informations de connexion à la base de données postgres. Attention il ne s'agit pas d'une BD spatiale, qui aurait vocation à héberger des données SIG (la config par défaut en propose une, configurable avec les variables qui commencent par GEODB_). Il s'agit de la BD interne de QFieldCloud, qui contiendra les données des utilisateurs, des organisations, des équipes ... On peut donc allègrement ne rien changer à ce niveau-là, sauf le POSTGRES_PASSWORD bien sûr

• dans les variables qui commencent par EMAIL_ on peut mettre les informations d'un serveur mél existant, ou les laisser telles quelles dans le cas où on ne souhaite pas utiliser de méls

• COMPOSE_FILE=docker-compose.yml:docker-compose.override.standalone.yml: il s'agit des fichiers "compose" qui déclarent les services en question de notre instance QFieldCloud. Zieutons-y un petit coup !

Déploiement#

Ces différents fichiers docker-compose.*.yml déclarent donc les différents services nécessaires à notre instance QFieldCloud. On remarque qu'il y en a plusieurs : le principal docker-compose.yml, qui contient les services "vitaux", qui vont être enrichis ("surchargés") par d'autres selon l'environnement que l'on souhaite : dev, local, prod, test ... et standalone, soit celui qu'on va mettre en place ici. Il s'agit d'un environnement autonome, qui offre tous les services nécessaires au bon fonctionnement de l'instance : stockage, BD postgres ...

Si un fichier docker-compose.override.standalone.yml n'existe pas déjà dans le dépôt, créons-le :

touch docker-compose.override.standalone.yml

Puis remplissons-le via un bon CTRL+C / CTRL+V des familles avec le contenu de ce fichier.

C'est parti #

Pour démarrer la musique et donner le signe à l'orchestre, un coup de baguette avec la commande suivante :

docker compose up -d --build

Cette commande va télécharger et/ou construire les images docker utilisées pour les services, ce qui peut prendre quelques minutes et consommer de la bande passante (~10 GO).

Une fois la commande arrivée à son terme et tous les containers dans le , nos services sont actifs, on peut passer à l'initialisation :

# appliquer les migrations pour créer la base de données interne
docker compose exec app python manage.py migrate

# collecter les fichiers web statiques
docker compose run app python manage.py collectstatic --noinput3

# créer le compte admin pour l'interface web, en remplaçant avec le nom d'utilisateur et le mél adéquat
docker compose run app python manage.py createsuperuser --username admin --email admin@mon.domain

Pour vérifier l'état des composantes du serveur, la commande suivante doit normalement renvoyer des "ok" :

docker compose exec app python manage.py status

Normalement.

Certificats SSL#

Afin d'être en capacité de nous connecter à notre instance QFieldCloud en HTTPS, un certificat SSL il nous faut. Il est possible d'en récupérer un grâce à Let's Encrypt et son utilitaire en ligne de commande certbot :

apt install certbot
source .env
certbot certonly --standalone -d ${QFIELDCLOUD_HOST}

Voici l'interrupteur :

# nuit
docker compose down --remove-orphans

# jour
docker compose up -d --build

Une fois le certificat généré, valable 3 mois, il nous faut à présent le copier dans la config de QFieldCloud :

sudo cp /etc/letsencrypt/live/${QFIELDCLOUD_HOST}/privkey.pem ./docker-nginx/certs/${QFIELDCLOUD_HOST}-key.pem
sudo cp /etc/letsencrypt/live/${QFIELDCLOUD_HOST}/fullchain.pem ./docker-nginx/certs/${QFIELDCLOUD_HOST}.pem

Après avoir relancé les services, normalement le serveur doit maintenant être fonctionnel et prêt à l'emploi. Normalement.

En tapant l'URL de votre nom de domaine en HTTPS dans un navigateur, l'interface web d'admin est maintenant disponible :

Configuration dans l'interface web#

C'est dans cette interface - l'interface d'admin de Django soit le framework utilisé par QFieldCloud - que nous allons créer les utilisateurs, les organisations, les équipes, et assigner les droits sur les projets. Les projets sont eux créés directement dans QGIS grâce au plugin QFieldSync.

Voyons maintenant comment créer notre première utilisatrice : il faut nous rendre dans la partie people people have the power puis cliquer sur "Add person" en-haut à droite :

À noter que la case "Staff status" permet à ce/tte people de se connecter à l'interface d'admin web. Combiné à une gestion des droits d'admin via la partie "Groups", cela peut permettre de créer des groupes d'admins avec des droits spécifiques et ce sans avoir à utiliser le super user principal.

N.B. : Au cours de la vie du QFieldCloud, il est possible que dans QGIS / QField, un message d'erreur comportant la mention "subscription inactive" apparaisse, empêchant par là la possibilité de récupérer ou synchroniser les projets. Pour régler cela, il faut se connecter au serveur et rentrer les commandes suivantes de sorte à corriger le statut des souscriptions (qui deviennent inactives après un mois généralement) :

# se connecter en bash dans le container de la base de données interne
docker exec -it qfieldcloud-db-1 /bin/bash

# se connecter à la base de données avec psql en rentrant le mot de passe renseigné dans le fichier .env
psql -U qfieldcloud_db_admin qfieldcloud_db

Puis changer le statut des subscriptions en SQL :

UPDATE subscription_subscription SET status = 'active_paid';

Création d'un projet QGIS#

Créons maintenant un projet pour tester un tant soit peu notre setup. Il faudra d'abord se connecter à notre instance QFC dans le plugin QFieldSync. Pour cela, cliquer deux fois sur l'abeille cool dans l'interface de connexion et renseigner l'URL de l'instance de même que login / mot de passe :

Ensuite créer un projet bateau puis le téléverser grâce au bouton "Create new project".

Le projet apparaît maintenant dans la liste, et même dans les signets "QFieldCloud" de l'explorateur QGIS !

Dans l'application mobile QField, même chose: on clique sur l'abeille 2 fois pour pouvoir rentrer l'URL de l'instance et le login / mot de passe :

Une fois le projet téléchargé dans la liste puis ouvert, c'est parti pour la saisie !

Magie magie !

Et maintenant ?#

Et maintenant ? Nous venons de voir comment mettre en place une instance QFieldCloud fonctionnelle sur un serveur linux, nous permettant de synchroniser aisément les données entre QGIS et QField. Mais ... vous vous souvenez ? La Fête de la Bière ? La ceinture ? Les bretelles ?

Les backups, les maintenances, les montées de version ... ne font pas l'objet de cet article. Pourquoi ne pas s'entourer de vrai/es expert/es sur ce domaine purement IT ? Il y a des boîtes qui proposent ces services et qui permettent de se soulager de ces contraintes, tout en discutant de la stratégie la plus adéquate à adopter. Car après tout, qui de mieux que votre partenaire QField pour s'occuper de votre QField ?

Auteur·ice#

Guilhem Allaman#

Je suis ingénieur informaticien. J'aime les ordinateurs. Mais ce que j'aime par-dessus tout (oh oui !), c'est itérer, et ce de manière agile, transverse et langoureuse, de bon matin, dès l'aube, à l'heure où blanchit le dashboard du sprint backlog.

Basé à Paris, j'ai commencé par le développement Java avant de découvrir les joies des SIG et de m'y spécialiser.

Licence Beerware #

Ce contenu est sous licence Beerware (Révision 42).
Les médias d'illustration sont potentiellement soumis à d'autres conditions d'utilisation.

Commentaires