Prezado leitor,
No dia a dia, é comum termos diversos workspaces configurados, cada um com seus stores, layers e estilos associados. Em ambientes de produção, manter cópias de segurança é fundamental para prevenir perdas em caso de falhas ou para replicar configurações em outro servidor.
1. Exportar (backup) um workspace
O GeoServer expõe endpoints REST que permitem exportar a configuração completa de um workspace em formato .zip.
# Exporta o workspace "meu_workspace" # -u admin:geoserver → autenticação no GeoServer (usuário:senha) # -XGET → método HTTP utilizado # -H "Accept: application/zip" → define que a resposta será um arquivo ZIP # URL do endpoint com ?recurse=true → inclui stores, layers e estilos associados # -o meu_workspace_backup.zip → salva o backup no arquivo ZIP local curl -u admin:geoserver -XGET \ -H "Accept: application/zip" \ http://localhost:8080/geoserver/rest/workspaces/meu_workspace?recurse=true \ -o meu_workspace_backup.zip
Como resultado você terá um arquivo meu_workspace_backup.zip contendo toda a estrutura do workspace desejado.
2. Importar (restore) um workspace
Para restaurar, basta enviar o .zip de volta ao GeoServer via POST:
# Restaura o workspace a partir do backup ZIP # -u admin:geoserver → autenticação no GeoServer # -XPOST → método HTTP utilizado # -H "Content-type: application/zip" → indica que o arquivo enviado é ZIP # --data-binary @meu_workspace_backup.zip → envia o arquivo binário # URL do endpoint /workspaces → local onde o workspace será recriado curl -u admin:geoserver -XPOST \ -H "Content-type: application/zip" \ --data-binary @meu_workspace_backup.zip \ http://localhost:8080/geoserver/rest/workspaces
Esse processo recriará o workspace no GeoServer de destino, com toda a configuração previamente exportada.
3. Conclusão
Com poucos comandos, conseguimos automatizar o processo de backup e restore de workspaces via REST API. Essa prática é indispensável para migrações, ambientes de testes e recuperação rápida em caso de falhas.