How-to guides

Manage the full operations lifecycle of the Gateway API integrator charm, from configuring a GatewayClass and publishing routes through TLS hardening and maintenance. Each guide assumes that you have already deployed the charm with Juju.

Traffic routing and endpoints

The charm manages Gateway and HTTPRoute resources to expose workloads through a gateway controller. These guides cover selecting the controller to bind to, configuring the hostname for backend applications, sharing one Gateway across several backends, and inspecting the public URLs for each backend.

TLS and transport security

The charm enforces HTTPS by default, so it requires a certificate provider and redirects plain HTTP to HTTPS. These guides cover supplying the TLS certificates via a provider charm, adjusting HTTPS enforcement, and tuning the policy that browsers apply after reaching the hostname over HTTPS.

  • Provide a certificate: Integrate a TLS provider such as self-signed-certificates, manual-tls-certificates, or LEGO to satisfy the certificates relation.

  • Configure HTTPS enforcement: Keep or turn off the default HTTP-to-HTTPS redirect, and control whether an HTTPS listener is created.

  • Configure HSTS: Set the Strict-Transport-Security max-age that browsers apply to the hostname.

Maintenance and development

Upgrades and community contributions ensure the Gateway API Integrator charm stays current and benefits from ongoing improvements.

  • Upgrade: Refresh the charm to a newer revision or channel with juju refresh.

  • Contribute: Set up a development and documentation workflow to build the charm, run tests, and submit improvements.