Navigation de la documentation
Ce document n’est pas encore traduit. La version anglaise vérifiée est affichée.
Documentation

Migrer depuis GeoServer

A controlled, reversible migration from Java GeoServer.

Mise à jour
Version cible
qualification

Understand the boundary

TasteGeo targets externally observable compatibility, not Java implementation compatibility. Java classes, servlet extensions, and GeoServer plugins do not run inside the Rust server.

  • Translate configuration into the supported TasteGeo schema.
  • Replace plugin behavior with a verified native capability or keep that traffic on GeoServer.
  • Compare HTTP status, headers, content type, and payload semantics.

Inventory

  • OGC services and versions
  • Workspaces, stores, layers, styles, and security rules
  • Community and commercial plugins
  • Reverse proxy, TLS, authentication, and monitoring
  • Peak traffic and cache behavior

Configuration, datastore, and plugin map

  • OGC operations: move only operations backed by a compatibility run for the exact versions in use.
  • Datastores: no adapter is implied by its crate or module name; retain each store on GeoServer until an application fixture verifies it.
  • Java, community, and commercial plugins: cannot execute inside the Rust process; retain their routes on GeoServer or replace them with a separately verified native capability.
  • Styles, security rules, and custom extensions: treat as explicit migration work and mark unverified behavior as currently unsupported.

Parallel operation

Run TasteGeo on a separate origin behind the same reverse proxy. Mirror read-only requests, retain GeoServer as the source of truth, and prevent duplicate write operations.

Traffic cutover

  • Freeze configuration changes for the comparison window.
  • Run the application-specific compatibility suite.
  • Shift a small percentage of read traffic.
  • Monitor error rate, latency, cache behavior, and payload differences.
  • Increase traffic only when the acceptance criteria remain satisfied.

Rollback

Keep GeoServer configuration and data unchanged during the initial cutover. Rollback must be a reverse-proxy route change, not a data recovery procedure.

  • Preserve the previous routing configuration.
  • Define an error-rate rollback threshold.
  • Stop TasteGeo write paths before restoring GeoServer traffic.
  • Record the failed request set as a new compatibility run.

Verification checklist

  • All required protocols have a recorded status.
  • Every required datastore has an application fixture.
  • Authentication and authorization behavior is compared.
  • Checksums, signatures, and SBOMs are verified.
  • Monitoring and rollback are tested before production traffic.