Skip to content

Frequently Asked Questions (FAQ)

  • Q: How can I get involved with Gateway API?
    A: The community page keeps track of how to get involved with the project.

  • Q: Will Gateway API replace the Ingress API?
    A: No. The Ingress API is GA since Kubernetes 1.19. There are no plans to deprecate this API and we expect most Ingress controllers to support it indefinitely.

  • Q: What are the differences between Ingress and Gateway API?
    A: Ingress primarily targets exposing HTTP applications with a simple, declarative syntax. Gateway API exposes a more general API for proxying that can be used for more protocols than just HTTP, and models more infrastructure components to provide better deployment and management options for cluster operators.

    For more information, see the Migrating from Ingress guide.

  • Q: Will there be a default controller implementation (in this repo)?
    A: There is no current plan to have an "official" or "default" implementation. You will see the controller code in this repo be used for testing the support libraries.

  • Q: How can I expose custom capabilities through Gateway API?
    A: There are a few mechanisms available for extending the API with implementation-specific capabilities:

    • The Policy Attachment model allows you to decorate Gateway API objects with implementation-specific CRDs. A policy or configuration object could match the Gateway API object either by name or by using an explicit object reference.

    • Use implementation-specific values for string fields in Gateway API resources.

    • As a last resort, use implementation-specific annotations on Gateway API objects.

    • Use API-defined extension points. Some Gateway API objects have explicit extension points for implementations to use.

  • Q: Where can I find Gateway API releases?
    A: Gateway API releases are tags of the Github repository. The Github releases page shows all the releases.

  • Q: How should I think about alpha API versions?
    A: Similar to upstream Kubernetes, alpha API versions indicate that resources are still experimental in nature and may either be removed or changed in breaking ways in future releases of Gateway API.

See the Versioning documentation for more info.

  • Q: Which Kubernetes versions are supported?
    A: See our policy on Supported Version

  • Q: Is SSL Passthrough supported? A: SSL Passthrough (wherein a Gateway routes traffic with the Transport Layer Security (TLS) encryption intact to a backend service instead of terminating it) is supported by TLSRoutes. See the TLS Guide for more details about passthrough and other TLS configurations.