v1alpha1 has been deprecated
Please upgrade to v1alpha2, v1alpha1 will be removed from Gateway API in an upcoming release.
Gateway is 1:1 with the life cycle of the configuration of infrastructure.
When a user creates a
Gateway, some load balancing infrastructure is
provisioned or configured (see below for details) by the
Gateway is the resource that triggers actions in this API. Other
resources in this API are configuration snippets until a Gateway has been
created to link the resources together.
Gateway spec defines the following:
GatewayClassName- Defines the name of a
GatewayClassobject used by this Gateway.
Listeners- Define the hostnames, ports, protocol, termination, TLS settings and which routes should be associated to a listener.
Addresses- Define the network addresses requested for this gateway.
If the desired configuration specified in Gateway spec cannot be achieved, the Gateway will be in an error state with details provided by status conditions.
Depending on the
GatewayClass, the creation of a
Gateway could do any of
the following actions:
- Use cloud APIs to create an LB instance.
- Spawn a new instance of a software LB (in this or another cluster).
- Add a configuration stanza to an already instantiated LB to handle the new routes.
- Program the SDN to implement the configuration.
- Something else we haven’t thought of yet...
The API does not specify which one of these actions will be taken.
GatewayStatus is used to surface the status of a
Gateway relative to the
desired state represented in
GatewayStatus consists of the following:
Addresses- Lists the IP addresses that have actually been bound to the Gateway.
Listeners- Provide status for each unique listener port defined in
Conditions- Describe the current status conditions of the Gateway.
Listeners.conditions follow the conditions pattern used
elsewhere in Kubernetes. This is a list that includes a type of condition, the
status of the condition and the last time this condition changed.