Skip to content

Commit ac44575

Browse files
committed
Clarify different between API Gateway and Gateway API
1 parent 7ded956 commit ac44575

File tree

2 files changed

+39
-3
lines changed

2 files changed

+39
-3
lines changed

site-src/faq.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,13 +54,33 @@
5454
* **Q: Which Kubernetes versions are supported?<br>**
5555
A: See our policy on [Supported Version](https://gateway-api.sigs.k8s.io/concepts/versioning/#supported-versions)
5656

57-
* **Q: Is SSL Passthrough supported?**
57+
* **Q: Is SSL Passthrough supported?<br>**
5858
A: SSL Passthrough (wherein a Gateway routes traffic with the [Transport
5959
Layer Security (TLS)][tls] encryption _intact_ to a backend service instead of
6060
terminating it) is supported by [TLSRoutes][tlsroute]. See the
6161
[TLS Guide][tlsguide] for more details about passthrough and other TLS
6262
configurations.
6363

64+
* **Q: What's the difference between Gateway API and an API Gateway?<br>**
65+
A: An API Gateway is a general concept that describes anything that exposes
66+
capabilities of a backend service, while providing extra capabilities for
67+
traffic routing and manipulation, such as load balancing, request and response
68+
transformation, and sometimes more advanced features like authentication and
69+
authorization, rate limiting, and circuit breaking.
70+
Gateway API is an interface, or set of resources, that model service networking
71+
in Kubernetes. One of the main resources is a `Gateway`, which declares the
72+
Gateway type (or class) to instantiate and its configuration. As a Gateway
73+
Provider, you can implement the Gateway API to model Kubernetes service
74+
networking in an expressive, extensible, and role-oriented way.
75+
Most Gateway API implementations are API Gateways to some extent, but not all
76+
API Gateways are Gateway API implementations.
77+
78+
* **Q: Is Gateway API a standard for API Management?<br>**
79+
A: No. API Management is a much broader concept than what Gateway API aims to
80+
be, or what an API Gateway is intended to provide. An API Gateway can be an
81+
essential part of an API Management solution. Gateway API can be seen as a
82+
way to standardize on that aspect of API Management.
83+
6484
[1]: https://github.com/kubernetes-sigs/gateway-api
6585
[2]: https://github.com/kubernetes-sigs/gateway-api/releases
6686
[tls]:https://en.wikipedia.org/wiki/Transport_Layer_Security

site-src/index.md

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
## What is the Gateway API?
22

33
Gateway API is an open source project managed by the [SIG-NETWORK][sig-network]
4-
community. It is a collection of resources that model service networking
4+
community. It is an API (collection of resources) that model service networking
55
in Kubernetes. These resources - `GatewayClass`, `Gateway`, `HTTPRoute`,
66
`TCPRoute`, `Service`, etc - aim to evolve Kubernetes service networking through
77
expressive, extensible, and role-oriented interfaces that are implemented by
@@ -94,8 +94,24 @@ This flexibility allows the API to adapt to vastly different
9494
organizational models and implementations while remaining a portable and
9595
standard API.
9696

97+
## What's the difference between Gateway API and an API Gateway?
9798

98-
## Who is working on Gateway?
99+
An API Gateway is a general concept that describes anything that exposes
100+
capabilities of a backend service, while providing extra capabilities for
101+
traffic routing and manipulation, such as load balancing, request and response
102+
transformation, and sometimes more advanced features like authentication and
103+
authorization, rate limiting, and circuit breaking.
104+
105+
Gateway API is an interface, or set of resources, that model service networking
106+
in Kubernetes. One of the main resources is a `Gateway`, which declares the
107+
Gateway type (or class) to instantiate and its configuration. As a Gateway
108+
Provider, you can implement the Gateway API to model Kubernetes service
109+
networking in an expressive, extensible, and role-oriented way.
110+
111+
Most Gateway API implementations are API Gateways to some extent, but not all
112+
API Gateways are Gateway API implementations.
113+
114+
## Who is working on Gateway API?
99115

100116
The Gateway API is a
101117
[SIG-Network](https://github.com/kubernetes/community/tree/master/sig-network)

0 commit comments

Comments
 (0)