VOOZH about

URL: https://thenewstack.io/unifying-kubernetes-service-networking-again-with-the-gateway-api/

⇱ Unifying Kubernetes Service Networking (Again) with the Gateway API - The New Stack


TNS
SUBSCRIBE
Join our community of software engineering leaders and aspirational developers. Always stay in-the-know by getting the most important news and exclusive content delivered fresh to your inbox to learn more about at-scale software development.
REQUIRED
It seems that you've previously unsubscribed from our newsletter in the past. Click the button below to open the re-subscribe form in a new tab. When you're done, simply close that tab and continue with this form to complete your subscription.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.
Welcome and thank you for joining The New Stack community!
Please answer a few simple questions to help us deliver the news and resources you are interested in.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Great to meet you!
Tell us a bit about your job so we can cover the topics you find most relevant.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Welcome!

We’re so glad you’re here. You can expect all the best TNS content to arrive Monday through Friday to keep you on top of the news and at the top of your game.

What’s next?

Check your inbox for a confirmation email where you can adjust your preferences and even join additional groups.

Follow TNS on your favorite social media networks.

Become a TNS follower on LinkedIn.

Check out the latest featured and trending stories while you wait for your first TNS newsletter.

PREV
1 of 2
NEXT
VOXPOP
As a JavaScript developer, what non-React tools do you use most often?
Angular
0%
Astro
0%
Svelte
0%
Vue.js
0%
Other
0%
I only use React
0%
I don't use JavaScript
0%
Thanks for your opinion! Subscribe below to get the final results, published exclusively in our TNS Update newsletter:
NEW! Try Stackie AI
From clobbered drafts to real-time sync
Apr 14th 2026 10:00am, by David Moore
TypeScript 6.0 RC arrives as a bridge to a faster future
Mar 14th 2026 9:00am, by Darryl K. Taft
Mastra empowers web devs to build AI agents in TypeScript
Jan 28th 2026 11:00am, by Loraine Lawson
2021-05-03 10:00:22
Unifying Kubernetes Service Networking (Again) with the Gateway API
contributed,sponsor-cncf,sponsored,sponsored-post-contributed,
Kubernetes / Networking

Unifying Kubernetes Service Networking (Again) with the Gateway API

Thanks to well-defined conformance and a layered API model, the Gateway API already shows a lot of promise and a long road ahead.
May 3rd, 2021 10:00am by Mark Church and Rob Scott
👁 Featued image for: Unifying Kubernetes Service Networking (Again) with the Gateway API
Feature image via Pixabay.
CNCF sponsored this post.

The Gateway API, formerly known as the Services API and before that Ingress V2, was first discussed in detail — and in-person — at Kubecon 2019 in San Diego. There were already many well-known and well-documented limitations of Ingress and Kubernetes networking APIs. The Gateway API was intended as a redo of these APIs, built on the lessons from Services, Ingress and the service mesh community.

With a group of Ingress and Service controller implementors assembled, we came up with the properties that we wanted to have in our version 2 of the Kubernetes networking APIs:

Mark Church
Mark Church is a product manager at Google, where he focuses on Kubernetes networking for Google Cloud. Before joining Google, he worked at Docker and Cisco.
  • Extensibility: We abused our annotations, we admit it. Complex routing rule structs were never meant to be placed in annotations, but what other choice did we have? The Gateway API is designed with flexible conformance, which mandates 100% support for core features. It requires portability for an optional set of extended features and, most importantly, adds many more extension points for unique custom features. This makes portability explicit and doesn’t constrain vendor-specific capabilities.
  • API Composability: While it may all boil down to a single proxy configuration, numerous users, on both the app and the infra side, must define different portions of the service networking surface area for their roles. Monolithic Ingress resources simply don’t provide the role-oriented design needed for shared infrastructure. A composable API (more API resources that work together vs a single monolithic resource) also allows a mixing and matching of resources that promotes continued and gradual evolution.
  • Expressiveness: The simplicity of Ingress (host/path routing and TLS) made portability easy, but it was also a lowest common denominator that limited Ingress. The Gateway API uplevels the core routing capabilities with traffic splitting, traffic mirroring, HTTP header manipulation and much more. These core and extended capabilities make a much larger set of features truly portable across implementations.
  • Portability: This is the one thing we did not want to change. The ubiquitousness of Service LoadBalancer and Ingress implementations are what allowed an ecosystem of networking projects and products to exist; and that simply made users’ lives easier. Above all, the Gateway API aims to keep industry-standard networking semantics portable between implementations.

Over a year later, there are several Gateway controller implementations in progress that users can use. This overwhelming conformity between implementations demonstrated the demand by vendors and users for a service networking refresh.

Hands-on with the Gateway API

Robert Scott
Robert Scott is a software engineer at Google, where he focuses on Google Kubernetes Engine — networking.

To understand how the Gateway API achieves these goals, let’s introduce two of its resources:

  • Gateways represent a load balancer or any generic data plane that listens for traffic that it routes. You can have many gateways, or just a single gateway that might be shared between apps.
  • Routes are the routing configuration applied to these gateways. These resources are protocol-specific, so there are HTTPRoutes, TCPRoutes, UDPRoutes, and so on. One or more routes can bind to a gateway; and together they define the routing configuration of the underlying data plane represented by the gateway resource.

A gateway+route is somewhat equivalent to a single Ingress resource. Because they are two resources, it gives the ability for the infrastructure team to own the gateway (and attach policy and configuration to it) and for the app owners to own their routes. This allows less direct coordination between these groups and more developer autonomy.

👁 Image

Role-Oriented and Multitenant Design

If this concept is taken further, it also allows many teams to share the same gateway. Gateways provide built-in controls for the way they bind with routes, even across namespace boundaries. This gives admins control of the way apps are exposed to clients. The following diagram shows two different teams in their own respective namespaces using the same load balancer (modeled by a gateway resource).

👁 Image

This arrangement allows app owners to define traffic routing, traffic weighting, redirects or health checks, because these are attributes tied closely to their app. The infrastructure owners may want to define which load balancers the apps can use, which TLS certificates are used or which source IPs are allowed to connect, as these are platform-level attributes independent of the application. The separation of concerns may be different across organizations, and the API model also provides flexibility to match different models of ownership.

Multicluster Networking with Gateway

The extensibility of the Gateway API also enables new use cases that were not possible before. Released last week, the GKE Gateway controller from Google Cloud allows HTTPRoutes to reference services across different clusters. This opens up the world of multicluster networking for things like multicluster high availability or blue-green/multicluster traffic splitting. Google’s Gateway controller is able to do this multicluster load balancing using its global network, making routing decisions before traffic even gets into the cluster.

The Cloud Native Computing Foundation (CNCF) hosts critical components of the global technology infrastructure including Kubernetes, OpenTelemetry, and Argo. CNCF is the neutral home for cloud native collaboration, bringing together the industry’s top developers, end users, and vendors.
Learn More
The latest from CNCF

The Road Ahead

While the Gateway API has already shown promise to unify cluster ingress, there already are proposals for modeling sidecar-based service mesh and TCP/UDP load balancing using gateway and route resources. This would bring a unification of routing APIs, which might lower the barrier to entry for new service mesh users and provide some convergence between L4 and L7 as well.

It is early in the journey for the Gateway API, and there is still plenty of work to do. Thanks to well-defined conformance and a layered API model, the Gateway API already shows a lot of promise and a long road ahead.

Try It out and Get Involved

There are many resources to check out to learn more:

  • Check out the user guides to see what use cases can be addressed.
  • Learn about the Google Kubernetes Engine Gateway controller on the Google Cloud blog.
  • Find more episodes about Gateway API on the Learn Kubernetes with Google video series
  • Try out one of the existing Gateway controllers 
  • Or get involved and help design and influence the future of Kubernetes service networking!
The Cloud Native Computing Foundation (CNCF) hosts critical components of the global technology infrastructure including Kubernetes, OpenTelemetry, and Argo. CNCF is the neutral home for cloud native collaboration, bringing together the industry’s top developers, end users, and vendors.
Learn More
The latest from CNCF
TRENDING STORIES
Mark Church is a product manager at Google, where he focuses on Kubernetes networking for Google Cloud. Before joining Google, he worked at Docker and Cisco.
Read more from Mark Church
Robert Scott is a software engineer at Google, where he focuses on Google Kubernetes Engine — networking.
Read more from Rob Scott
CNCF sponsored this post.
SHARE THIS STORY
TRENDING STORIES
KubeCon+CloudNativeCon is a sponsor of The New Stack.
TNS owner Insight Partners is an investor in: Pragma, Docker.
SHARE THIS STORY
TRENDING STORIES
TNS DAILY NEWSLETTER Receive a free roundup of the most recent TNS articles in your inbox each day.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.