Anatomia de uma instância Lizmap: as peças e como se encadeiam

O que é uma instância Lizmap no LizPack?

Com o LizPack Map, uma instância Lizmap é um portal cartográfico completo, em seu nome, instalado e mantido por nós. É criada em cerca de quatro minutos a partir da área de cliente: escolhe um nome, esse nome passa a ser o seu subdomínio, e o conjunto dos componentes é instalado e ligado entre si de forma automática.

Há um ponto essencial a ter em conta: o LizPack não escreveu estes programas. O Lizmap Web Client, o QGIS Server, o PostgreSQL e o PostGIS são desenvolvidos pelas respetivas comunidades. O LizPack, uma infraestrutura geoespacial de código aberto, orquestra-os: implementa-os, configura-os para que comuniquem entre si, atualiza-os e monitoriza-os. É isso que descreve em pormenor o guia O que faz o LizPack.

Uma instância contém, portanto, seis elementos, que também se encontram na página do LizPack Map, a nossa oferta de alojamento Lizmap: o Lizmap Web Client, o QGIS Server, uma base de dados PostgreSQL com PostGIS, uma cache de mosaicos, um subdomínio e um certificado HTTPS. Cada um deles tem uma função precisa, descrita nas secções seguintes.

Os seis componentes de uma instância Lizmap

A isto juntam-se as ferramentas que servem para alimentar a instância: o gestor de ficheiros online, para carregar, organizar e substituir os seus projetos e os seus dados a partir do navegador, e a extensão gratuita LizPack Publisher, que envia um projeto e os respetivos dados diretamente a partir do QGIS Desktop.

Porquê tantas peças? Porque cada uma faz uma só coisa e fá-la bem. O Lizmap Web Client gere a interface e as permissões, mas não sabe desenhar um mapa. O QGIS Server desenha, mas não oferece qualquer interface aos visitantes. O PostGIS armazena e consulta, mas não produz imagens. É a sua combinação que forma um portal. A vantagem de uma instância preparada é que as versões destes programas são escolhidas para serem compatíveis entre si, e que os componentes são entregues já ligados, subdomínio e certificado incluídos, antes mesmo do seu primeiro início de sessão. Instalar o Lizmap por conta própria continua a ser possível: o programa é livre e está bem documentado. A diferença está no tempo gasto a ligar tudo e, depois, a manter tudo.

Como uma instância Lizmap apresenta um mapa

Eis, de forma simplificada, o percurso de um mapa, desde o projeto QGIS até ao ecrã do seu visitante. Este funcionamento é o do Lizmap em geral: o LizPack não o altera, limita-se a garantir que cada elo da cadeia está no seu lugar.

1. O projeto é preparado no QGIS Desktop. Compõe as camadas, os estilos e as etiquetas e, em seguida, configura a publicação com o plugin Lizmap, como em qualquer publicação Lizmap.
2. O projeto chega à instância. Envia-o com o LizPack Publisher ou com o gestor de ficheiros online. O ficheiro do projeto e os respetivos dados em ficheiros (GeoPackage, Shapefile, rasters) são colocados na instância; as camadas PostGIS, por sua vez, permanecem na base de dados.
3. O visitante abre o endereço do portal. O navegador dele acede ao seu subdomínio em HTTPS. O Lizmap Web Client verifica as permissões de acesso e apresenta-lhe a lista de mapas e, depois, o mapa pedido.
4. O Lizmap pede as imagens ao QGIS Server. Para cada vista do mapa, o Lizmap transmite o pedido ao QGIS Server, que abre o projeto, lê os dados nos ficheiros ou no PostGIS, aplica os estilos do projeto e devolve uma imagem.
5. A cache de mosaicos evita repetir o trabalho. Os fragmentos do mapa já calculados podem ser servidos de novo diretamente, o que acelera a apresentação das camadas que mudam pouco.
6. As interações seguem o mesmo caminho. Uma consulta de objeto, uma pesquisa, uma exportação ou uma edição online são tratadas pelo Lizmap, com o QGIS Server e o PostGIS por trás.

É porque o QGIS Server lê o projeto QGIS tal como está que o mapa online se parece com o do seu computador. Um projeto pesado de apresentar no QGIS Desktop também o será online: o trabalho de preparação continua a ser da sua responsabilidade.

A base de dados PostGIS, o coração dos dados vivos

As camadas em ficheiros são adequadas para dados que mudam pouco. Assim que os dados são alterados com frequência, por várias pessoas ou a partir do terreno, a base de dados PostGIS da instância assume o papel principal. É entregue já ligada ao Lizmap e ao QGIS Server: uma camada PostGIS do projeto é lida em cada apresentação, estando por isso sempre atualizada.

Os planos Basic e Pro incluem um armazenamento de base de dados associado à instância. A partir do plano Pro, liga-se a ela diretamente a partir do QGIS Desktop ou do pgAdmin, e o LizPack Publisher permite adicionar tabelas como camadas, importar uma camada e diagnosticá-la. Se precisar de mais espaço ou de uma base de dados independente, podem ser criadas à parte bases de dados PostgreSQL e PostGIS dedicadas de 1 a 10 GB, que depois se ligam à instância.

É também a base de dados que faz a ligação com a recolha de dados no terreno: com o LizPack Field e o plano Pro, os levantamentos introduzidos no QField são escritos no PostGIS, e o mapa Lizmap que os apresenta é atualizado em cada sincronização. O guia Sincronizar QField, PostGIS e Lizmap descreve este circuito em pormenor.

O que rodeia a instância: módulos, equipa, monitorização

• Os módulos. A partir do separador Modules da instância, adiciona módulos Lizmap como os painéis de controlo ou o MapBuilder. A instalação demora menos de um minuto e o portal continua acessível durante esse tempo.
• A equipa. O plano Pro permite convidar até cinco colaboradores. As permissões de consulta dos mapas, por sua vez, são definidas na administração do Lizmap.
• Os temas. Um tema do marketplace pode ser copiado para dar aos seus mapas um aspeto próprio.
• As atualizações. A atualização do Lizmap e do QGIS Server é lançada com um clique. Está incluída a partir do plano Pro e custa 10 USD por componente nos planos Free e Basic.
• A monitorização. O estado dos serviços de cada instância é verificado continuamente, e uma ligação interrompida entre os componentes é detetada e reparada. O estado geral da plataforma é publicado numa página pública.

O que muda de um plano para outro numa instância Lizmap

Os seis componentes estão presentes em todas as instâncias. O que varia consoante o plano é a forma como são atribuídos: partilhados ou dedicados, e com quanto espaço. A tabela abaixo retoma os preços de referência publicados no site; a página de Preços apresenta sempre os valores atualizados.

Um QGIS Server partilhado serve os projetos de várias contas: é suficiente para descobrir o Lizmap e testar um projeto. Um QGIS Server dedicado serve apenas a sua instância, o que evita que um mapa pesado de outra conta torne o seu mais lento. É por isso que um projeto destinado a ser consultado regularmente deve estar, no mínimo, num plano Basic.

O plano Pro acrescenta dois elementos que mudam a forma de trabalhar com a instância: a ligação direta à base de dados a partir do QGIS Desktop ou do pgAdmin, e as atualizações do Lizmap e do QGIS Server incluídas. Permite também convidar até cinco membros da equipa. O guia Compreender os planos e as quotas do LizPack explica cada linha da tabela de preços.

Da criação da instância ao mapa partilhado

Os quatro passos descritos na página do LizPack Map bastam para passar de uma conta vazia a um mapa online. Eis o que cada um deles põe em movimento dentro da instância.

1. Criar a instância. Escolhe um nome, que passa a ser o seu subdomínio. Durante os cerca de quatro minutos que a criação demora, o LizPack instala o Lizmap Web Client, prepara o QGIS Server na versão escolhida, cria a base de dados PostGIS, configura a cache de mosaicos e obtém o certificado HTTPS.
2. Preparar o projeto. No QGIS Desktop, configura o projeto com o plugin Lizmap: camadas visíveis, ferramentas disponibilizadas, escalas, impressão. Esta configuração acompanha o projeto; é ela que o Lizmap lê quando o mapa é aberto.
3. Publicar. O LizPack Publisher valida o projeto aberto e, em seguida, envia-o com os respetivos dados. Também pode enviar uma pasta inteira do seu computador, mantendo a estrutura, ou recorrer ao gestor de ficheiros online. Cada operação da extensão fica anotada num registo, que se copia com um clique para o anexar a um pedido ao suporte.
4. Partilhar. O mapa está online. As permissões de acesso são definidas na administração do Lizmap: mapa público, ou reservado a determinadas contas ou a determinados grupos.

O guia Publicar um mapa Lizmap a partir do QGIS retoma este percurso passo a passo, com as definições do plugin Lizmap.

Projetos e dados que uma instância Lizmap aceita

Uma instância LizPack Map serve projetos QGIS comuns. Não existe nenhum formato próprio do LizPack: um projeto que funciona num Lizmap instalado noutro local também funciona numa instância, e vice-versa.

• O projeto. Qualquer projeto QGIS configurado com o plugin Lizmap no QGIS Desktop.
• As camadas em ficheiros. GeoPackage, Shapefile e rasters, carregados juntamente com o projeto.
• As camadas PostGIS. As tabelas da base de dados da instância, ou de uma base de dados dedicada ligada à instância.
• Os serviços externos. Um serviço WMS ou WFS, por exemplo publicado no GeoServer Cloud, é adicionado ao projeto QGIS e depois apresentado no Lizmap como as restantes camadas.
• A extensão de publicação. O LizPack Publisher requer, no mínimo, o QGIS 3.16 e não acrescenta qualquer biblioteca à sua instalação do QGIS.

Os módulos Lizmap são instalados numa instância em funcionamento, com o Lizmap 3.9. O separador Modules assinala um módulo incompatível com a versão da sua instância.

A vida de uma instância: espaço, alertas, expiração

Uma instância ocupa espaço: os ficheiros dos projetos de um lado e a base de dados do outro. Cada um tem a sua quota consoante o plano. No caso da base de dados, o LizPack avisa antes de estar cheia, e uma ultrapassagem nunca apaga nada: a base de dados é parada, não é esvaziada. As bases de dados dedicadas enviam um e-mail a partir dos 60 % de ocupação, depois aos 75, 80, 90 e 95 %, e concedem 24 horas para libertar espaço depois de a quota ser ultrapassada.

Se a subscrição expirar, a instância para, mas os seus projetos, os seus ficheiros e a sua base de dados são conservados durante 60 dias. Três e-mails avisam antes de qualquer eliminação, e uma renovação dentro desse prazo devolve-lhe a instância tal como estava. As subscrições são mensais, sem fidelização: a subscrição mantém-se ativa até ao fim do período pago.

As cópias de segurança das instâncias são propostas como opção. Os módulos adicionados fazem parte da configuração da instância e são guardados e restaurados juntamente com ela. O guia Os seus dados e a sua segurança no LizPack reúne tudo o que protege o conteúdo de uma instância.

O que não vê, e porquê

Na oferta alojada, nunca abre uma sessão no servidor. Tudo é feito a partir da área de cliente, do gestor de ficheiros online e da extensão do QGIS. É uma escolha deliberada: sem acesso de administrador aos servidores partilhados, o LizPack pode garantir a sua segurança e as suas atualizações. Se precisar de controlo total sobre o servidor, a edição LizPack Entreprise instala as mesmas instâncias nas suas próprias instalações; o guia Alojado ou nos seus servidores ajuda a escolher.

Nada disto o prende. O projeto publicado é um projeto QGIS padrão, a base de dados é uma base PostgreSQL padrão e os serviços são serviços OGC padrão. Pode recuperar tudo e executá-lo noutro local, como explica o guia Alojar o Lizmap ou instalá-lo por conta própria. Para continuar, veja como a instância se integra no conjunto das soluções LizPack.

Perguntas frequentes