Repository for the next iteration of composite service (e.g. Ingress) and load balancing APIs. https://gateway-api.sigs.k8s.io
  • Go 91.8%
  • Python 2.5%
  • Shell 2.4%
  • HTML 2.2%
  • Makefile 0.4%
  • Other 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Grant Spence ddbd6bafd2
GEP-1619: Backend as attachment point for Session Persistence (#4876)
* GEP-1619: Backend as attachment point for session persistence

Move session persistence from BackendTrafficPolicy and route-inline to
the Backend resource (GEP-4488). Remove BTP and route-inline API sections,
update API Attachment Points to only Backend, and deprecate route-inline.

* GEP-1619: Traffic Split applies AFTER Backend Selection

Prior ART shows that most, if not all, implementations and data planes
apply session persistence after routing (backend selection). Update traffic
splitting guidance so that session persistence does not override backend
selection. Also remove redundant mixed-backends edge case.

* GEP-1619: Code Review Updates

- Move SessionPersistence to be within EndpointSelector in Backend
- Specify relationship with backend protocol
- Clarify that the cookie/header MAY not be sent to the backend

* GEP-1619: Backend SHOULD receive Cookie

Update from MAY to SHOULD for whether the backend behavior of receiving
the gateway generated cookie based on prior art.
2026-09-24 13:58:17 +00:00
.github Adding AIL labels to PR template (#5245) 2026-09-12 00:23:10 +00:00
.openvex/templates Spelling (#3400) 2025-02-12 10:32:22 -08:00
api/openapi-spec GEP-1619: Backend as attachment point for Session Persistence (#4876) 2026-09-24 13:58:17 +00:00
apis GEP-1619: Backend as attachment point for Session Persistence (#4876) 2026-09-24 13:58:17 +00:00
apisx GEP-1619: Backend as attachment point for Session Persistence (#4876) 2026-09-24 13:58:17 +00:00
applyconfiguration GEP-1619: Backend as attachment point for Session Persistence (#4876) 2026-09-24 13:58:17 +00:00
CHANGELOG chore: Add changelog for the 1.6 release (#5285) 2026-09-21 20:12:11 +00:00
config/crd GEP-1619: Backend as attachment point for Session Persistence (#4876) 2026-09-24 13:58:17 +00:00
conformance change timeout in ExpectMirroredRequest to MaxTimeToConsistency (#5292) 2026-09-24 13:28:18 +00:00
examples docs: TCP and UDP examples / documentation (#4932) 2026-06-23 01:25:32 +00:00
geps GEP-1619: Backend as attachment point for Session Persistence (#4876) 2026-09-24 13:58:17 +00:00
gwctl Remove gwctl code from gateway-api repository. New development will happen in kubernetes-sigs/gwctl (#3338) 2024-09-16 20:35:14 +01:00
hack Add new implist tool (#5191) 2026-08-28 19:24:03 +00:00
pkg GEP-1619: Backend as attachment point for Session Persistence (#4876) 2026-09-24 13:58:17 +00:00
roles Spelling (#4279) 2025-12-08 17:15:33 -08:00
site build(deps-dev): bump autoprefixer from 10.5.5 to 10.6.0 in /site (#5265) 2026-09-22 00:22:27 +00:00
tests build(deps): bump sigs.k8s.io/controller-runtime (#5264) 2026-09-22 00:22:19 +00:00
tools fix(generator): support inline references on experimental validation (#5288) 2026-09-23 19:26:17 +00:00
wasm site: fix wizard theme compatibility and paths for dark mode (#4857) 2026-05-14 22:48:29 +05:30
.custom-gcl.yml Bump golangci-lint (and KAL) to support Go 1.26 (#4820) 2026-05-02 18:55:24 +05:30
.gitattributes Mark openapi generated files as generated in PRs (#5261) 2026-09-17 13:07:24 +00:00
.gitignore EXP: XBackend Implementation (#4901) 2026-05-30 09:34:47 +05:30
.golangci-kal.yml Controller matching wizard (#4584) 2026-03-05 11:14:17 +05:30
.golangci.yml Enable golangci-lint modernize linter (#4821) 2026-05-12 03:10:10 +05:30
.yamllint.yaml cleanup: Remove echo-basic (#5090) 2026-07-21 13:10:18 +00:00
AI-POLICY.md Add AI Policy document (#5151) 2026-08-18 01:05:06 +00:00
CHANGELOG.md Splitting Changelogs for each minor version (#3060) 2024-05-07 08:11:49 -07:00
code-of-conduct.md Initial commit 2019-11-01 16:33:33 -04:00
CONTRIBUTING.md Update CONTRIBUTING.md with links (#5180) 2026-08-18 12:07:07 +00:00
crd-ref-docs.yaml Updating deps to k8s 1.32 and go 1.24 (#3697) 2025-03-21 10:56:32 -07:00
crdify.yaml bugfix: crdify should not break on description and enum addition changes (#4963) 2026-06-11 21:41:04 +05:30
go.mod Update k8s dependencies to 1.37 (#5232) 2026-09-11 21:49:13 +00:00
go.sum Update k8s dependencies to 1.37 (#5232) 2026-09-11 21:49:13 +00:00
go.work Bump Go toolchain to 1.26.8 to fix stdlib CVEs (#5280) 2026-09-21 18:18:14 +00:00
LICENSE revamp readme to point to relevant resources 2020-10-29 10:24:07 -05:00
Makefile Add make lint target to Makefile (#5198) 2026-09-14 16:25:25 +00:00
netlify.toml Migrate documentation from MkDocs to Docsy (#4734) 2026-05-14 17:36:29 +05:30
OWNERS chore: remove mesh leads from * reviews 2022-12-06 15:18:33 -05:00
OWNERS_ALIASES chore: promote Norwin to conformance and docs approver (#5286) 2026-09-22 16:14:13 +00:00
README.md Followups from v1.6.1 release (#5074) 2026-07-17 18:53:26 +00:00
RELEASE.md Add new implist tool (#5191) 2026-08-28 19:24:03 +00:00
RELEASE_MANAGEMENT.md Update deadline extension policy (#4111) 2025-09-25 21:22:16 -07:00
SECURITY_CONTACTS Update OWNERS, OWNERS_ALIASES and SECURITY_CONTACTS. 2019-11-01 16:57:13 -04:00

Kubernetes Gateway API

The Gateway API is a part of SIG Network, and this repository contains the specification and Custom Resource Definitions (CRDs).

Status

The latest supported version is v1 as released by the v1.6.1 release of this project.

This version of the API has GA level support for the following resources:

  • v1.GatewayClass
  • v1.Gateway
  • v1.ListenerSet
  • v1.HTTPRoute
  • v1.GRPCRoute
  • v1.TLSRoute
  • v1.TCPRoute
  • v1.UDPRoute
  • v1.BackendTLSPolicy
  • v1.ReferenceGrant

For all the other APIs and their support levels please consult the spec.

Documentation

Website

The API specification and detailed documentation is available on the project website: https://gateway-api.sigs.k8s.io.

Concepts

To get started, please read through API concepts and Security model. These documents give the necessary background to understand the API and the use-cases it targets.

Getting started

Once you have a good understanding of the API at a higher-level, check out getting started to install your first Gateway controller and try out one of the guides.

References

For a complete API reference, please refer to:

Gateway API conformance

If you are developing a Gateway API implementation and want to run conformance tests against your project and eventually submit the proof of conformance, visit the conformance documentation for the test suite documentation, and the conformance reports readme to see the reports submission rules. If you are a user who wants to explore the features supported by the various implementations, navigate the conformance reports

Contributing

Community meeting schedule, notes and developer guide can be found on the community page. Our Kubernetes Slack channel is #sig-network-gateway-api.

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.