Anatomie d'une instance Lizmap : les pièces et leur enchaînement

Qu'est-ce qu'une instance Lizmap chez LizPack ?

Avec LizPack Map, une instance Lizmap est un portail cartographique complet, à votre nom, installé et entretenu pour vous. Elle naît en quatre minutes environ, depuis l'espace client : vous choisissez un nom, il devient votre sous-domaine, et l'ensemble des composants est mis en place et relié automatiquement.

Il faut garder en tête un point essentiel : LizPack n'a pas écrit ces logiciels. Lizmap Web Client, QGIS Server, PostgreSQL et PostGIS sont développés par leurs communautés. LizPack, infrastructure géospatiale open source, les orchestre : il les déploie, les configure pour qu'ils se parlent, les met à jour et les surveille. C'est ce que décrit en détail le guide Ce que fait LizPack.

Une instance contient donc six éléments, que l'on retrouve sur la page de LizPack Map, notre offre d'hébergement Lizmap : Lizmap Web Client, QGIS Server, une base PostgreSQL avec PostGIS, un cache de tuiles, un sous-domaine et un certificat HTTPS. Chacun a un rôle précis.

Les six composants d'une instance Lizmap

À cela s'ajoutent les outils qui servent à alimenter l'instance : le gestionnaire de fichiers en ligne, pour déposer, organiser et remplacer vos projets et vos données depuis le navigateur, et l'extension gratuite LizPack Publisher, qui envoie un projet et ses données depuis QGIS Desktop.

Pourquoi tant de pièces ? Parce que chacune fait une seule chose et la fait bien. Lizmap Web Client gère l'interface et les droits, mais ne sait pas dessiner une carte. QGIS Server dessine, mais n'offre pas d'interface aux visiteurs. PostGIS stocke et interroge, mais ne produit pas d'image. C'est leur assemblage qui fait un portail. L'intérêt d'une instance préparée, c'est que les versions de ces logiciels sont choisies pour être compatibles entre elles, et que les composants sont livrés déjà reliés, sous-domaine et certificat compris, avant même votre première connexion. Installer Lizmap soi-même reste possible : le logiciel est libre et bien documenté. La différence tient au temps passé à tout relier, puis à tout entretenir.

Comment une instance Lizmap affiche une carte

Voici, simplifié, le trajet d'une carte, du projet QGIS jusqu'à l'écran de votre visiteur. Ce fonctionnement est celui de Lizmap en général : LizPack ne le modifie pas, il fait en sorte que chaque maillon soit en place.

1. Le projet est préparé dans QGIS Desktop. Vous composez les couches, les styles et les étiquettes, puis vous configurez la publication avec le plugin Lizmap, comme pour toute publication Lizmap.
2. Le projet rejoint l'instance. Vous l'envoyez avec LizPack Publisher ou le gestionnaire de fichiers en ligne. Le fichier du projet et ses données fichiers (GeoPackage, Shapefile, rasters) sont déposés sur l'instance ; les couches PostGIS, elles, restent dans la base.
3. Le visiteur ouvre l'adresse du portail. Son navigateur joint votre sous-domaine en HTTPS. Lizmap Web Client vérifie ses droits d'accès et lui présente la liste des cartes, puis la carte demandée.
4. Lizmap demande les images à QGIS Server. Pour chaque vue de la carte, Lizmap transmet la requête à QGIS Server, qui ouvre le projet, lit les données dans les fichiers ou dans PostGIS, applique les styles du projet et renvoie une image.
5. Le cache de tuiles évite de refaire le travail. Les morceaux de carte déjà calculés peuvent être resservis directement, ce qui accélère l'affichage des couches qui changent peu.
6. Les interactions passent par le même chemin. Une interrogation d'objet, une recherche, un export ou une saisie en ligne sont traités par Lizmap, avec QGIS Server et PostGIS derrière.

C'est parce que QGIS Server lit le projet QGIS tel quel que la carte en ligne ressemble à celle de votre poste. Un projet lourd à afficher dans QGIS Desktop le sera aussi en ligne : le travail de préparation reste le vôtre.

La base PostGIS, cœur des données vivantes

Les couches fichiers conviennent aux données qui bougent peu. Dès que des données sont modifiées souvent, par plusieurs personnes ou depuis le terrain, la base PostGIS de l'instance prend le relais. Elle est livrée déjà reliée à Lizmap et à QGIS Server : une couche PostGIS du projet est lue à chaque affichage, donc toujours à jour.

Les plans Basic et Pro comprennent un stockage de base de données lié à l'instance. À partir du plan Pro, vous vous y connectez directement depuis QGIS Desktop ou pgAdmin, et LizPack Publisher permet d'y ajouter des tables comme couches, d'y importer une couche et de la diagnostiquer. Si vous avez besoin de plus d'espace ou d'une base indépendante, des bases PostgreSQL et PostGIS dédiées de 1 à 10 Go se créent à part et se relient à l'instance.

C'est aussi la base qui fait le lien avec la collecte terrain : avec LizPack Field et le plan Pro, les relevés saisis dans QField sont écrits dans PostGIS, et la carte Lizmap qui les affiche se met à jour à chaque synchronisation. Le guide Synchroniser QField, PostGIS et Lizmap détaille ce circuit.

Ce qui entoure l'instance : modules, équipe, surveillance

• Les modules. Depuis l'onglet « Modules » de l'instance, vous ajoutez des modules Lizmap comme les tableaux de bord ou MapBuilder. L'installation prend moins d'une minute et le portail reste accessible pendant ce temps.
• L'équipe. Le plan Pro permet d'inviter jusqu'à cinq collaborateurs. Les droits de consultation des cartes se règlent, eux, dans l'administration Lizmap.
• Les thèmes. Un thème de la marketplace se copie pour habiller vos cartes.
• Les mises à jour. La mise à jour de Lizmap et de QGIS Server se lance d'un clic. Elle est comprise à partir du plan Pro et coûte 10 USD par composant sur les plans Free et Basic.
• La surveillance. L'état des services de chaque instance est relevé en continu, et une liaison rompue entre les composants est détectée et réparée. L'état général de la plateforme est publié sur une page publique.

Ce qui change d'un plan à l'autre dans une instance Lizmap

Les six composants sont présents dans toutes les instances. Ce qui varie selon le plan, c'est la façon dont ils sont attribués : partagés ou dédiés, et avec combien d'espace. Le tableau ci-dessous reprend les prix de repli publiés sur la vitrine ; la page Tarifs affiche toujours les valeurs à jour.

Un QGIS Server partagé sert les projets de plusieurs comptes : c'est suffisant pour découvrir Lizmap et tester un projet. Un QGIS Server dédié ne sert que votre instance, ce qui évite qu'une carte lourde d'un autre compte ralentisse la vôtre. C'est la raison pour laquelle un projet destiné à être consulté régulièrement a sa place sur un plan Basic au moins.

Le plan Pro ajoute deux éléments qui changent la façon de travailler avec l'instance : la connexion directe à la base depuis QGIS Desktop ou pgAdmin, et les mises à jour de Lizmap et de QGIS Server comprises. Il permet aussi d'inviter jusqu'à cinq membres d'équipe. Le guide Lire les plans et les quotas LizPack détaille chaque ligne de la grille.

De la création de l'instance à la carte partagée

Les quatre étapes décrites sur la page de LizPack Map suffisent à passer d'un compte vide à une carte en ligne. Voici ce que chacune met en mouvement dans l'instance.

1. Créer l'instance. Vous choisissez un nom, qui devient votre sous-domaine. Pendant les quatre minutes environ que dure la création, LizPack installe Lizmap Web Client, prépare QGIS Server dans la version choisie, crée la base PostGIS, configure le cache de tuiles et obtient le certificat HTTPS.
2. Préparer le projet. Dans QGIS Desktop, vous configurez le projet avec le plugin Lizmap : couches visibles, outils proposés, échelles, impression. Cette configuration accompagne le projet ; c'est elle que Lizmap lit à l'ouverture de la carte.
3. Publier. LizPack Publisher valide le projet ouvert puis l'envoie avec ses données. Vous pouvez aussi envoyer un dossier entier de votre poste, structure conservée, ou passer par le gestionnaire de fichiers en ligne. Chaque opération de l'extension est notée dans un journal, qui se copie en un clic pour le joindre à une demande au support.
4. Partager. La carte est en ligne. Les droits d'accès se règlent dans l'administration Lizmap : carte publique, réservée à certains comptes ou à certains groupes.

Le guide Publier une carte Lizmap depuis QGIS reprend ce parcours pas à pas, avec les réglages du plugin Lizmap.

Projets et données qu'une instance Lizmap accepte

Une instance LizPack Map sert des projets QGIS ordinaires. Il n'existe pas de format propre à LizPack : un projet qui fonctionne dans un Lizmap installé ailleurs fonctionne aussi dans une instance, et inversement.

• Le projet. Tout projet QGIS configuré avec le plugin Lizmap dans QGIS Desktop.
• Les couches fichiers. GeoPackage, Shapefile et rasters, déposés avec le projet.
• Les couches PostGIS. Les tables de la base de l'instance, ou d'une base dédiée reliée à l'instance.
• Les flux externes. Un flux WMS ou WFS, par exemple publié dans GeoServer Cloud, s'ajoute dans le projet QGIS puis s'affiche dans Lizmap comme les autres couches.
• L'extension de publication. LizPack Publisher demande QGIS 3.16 au minimum et n'ajoute aucune bibliothèque à votre installation de QGIS.

Les modules Lizmap s'installent sur une instance démarrée, en Lizmap 3.9. L'onglet « Modules » signale un module incompatible avec la version de votre instance.

La vie d'une instance : espace, alertes, expiration

Une instance occupe de l'espace : les fichiers des projets d'un côté, la base de l'autre. Chacun a son quota selon le plan. Pour la base, LizPack prévient avant qu'elle soit pleine, et un dépassement n'efface jamais rien : la base est arrêtée, pas vidée. Les bases dédiées envoient un courriel dès 60 % de remplissage, puis à 75, 80, 90 et 95 %, et laissent 24 heures pour libérer de l'espace une fois le quota dépassé.

Si l'abonnement expire, l'instance s'arrête, mais ses projets, ses fichiers et sa base sont conservés 60 jours. Trois courriels vous préviennent avant toute suppression, et un renouvellement dans ce délai vous rend l'instance telle quelle. Les abonnements sont mensuels, sans engagement : l'abonnement reste actif jusqu'à la fin de la période payée.

Les sauvegardes des instances sont proposées en option. Les modules ajoutés font partie de la configuration de l'instance et sont sauvegardés et restaurés avec elle. Le guide Vos données et leur sécurité chez LizPack rassemble tout ce qui protège le contenu d'une instance.

Ce que vous ne voyez pas, et pourquoi

Sur l'offre hébergée, vous n'ouvrez jamais de session sur le serveur. Tout se fait depuis l'espace client, le gestionnaire de fichiers en ligne et l'extension QGIS. C'est un choix : sans accès administrateur aux serveurs partagés, LizPack peut garantir leur sécurité et leurs mises à jour. Si vous avez besoin de la main sur le serveur, l'édition LizPack Entreprise installe les mêmes instances chez vous ; le guide Hébergé ou sur vos serveurs aide à choisir.

Rien de tout cela ne vous enferme. Le projet publié est un projet QGIS standard, la base une base PostgreSQL standard, les services des services OGC standards. Vous pouvez reprendre l'ensemble et le faire tourner ailleurs, comme l'explique le guide Héberger Lizmap ou l'installer soi-même. Pour la suite, voyez comment l'instance s'insère dans l'ensemble des solutions LizPack.

Questions fréquentes