1
1
# GEP-3792: Out-of-Cluster Gateways
2
2
3
3
* Issue: [ #3792 ] ( https://github.com/kubernetes-sigs/gateway-api/issues/3792 )
4
- * Status: Provisional
4
+ * Status: Memorandum
5
5
6
6
(See [ status definitions] ( ../overview.md#gep-states ) .)
7
7
8
+ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
9
+ "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this
10
+ document are to be interpreted as described in BCP 14 ([ RFC8174] ) when, and
11
+ only when, they appear in all capitals, as shown here.
12
+
13
+ [ RFC8174 ] : https://www.rfc-editor.org/rfc/rfc8174
14
+
8
15
## User Story
9
16
10
17
** [ Chihiro] and [ Ian] want a way for out-of-cluster Gateways to be able to
@@ -19,6 +26,10 @@ cluster, for various reasons which are out of the scope of this GEP. [Chihiro]
19
26
and [ Ian] want to be able to use these out-of-cluster proxies effectively and
20
27
safely, though they recognize that this may require additional configuration.
21
28
29
+ This GEP defines the problems that need to be solved to allow out-of-cluster
30
+ Gateways (OCGs) to usefully participate in a GAMMA-compliant in-cluster mesh.
31
+ The API to actually solve these problems will be defined in a future GEP.
32
+
22
33
[ Chihiro ] : https://gateway-api.sigs.k8s.io/concepts/roles-and-personas/#chihiro
23
34
[ Ian ] : https://gateway-api.sigs.k8s.io/concepts/roles-and-personas/#ian
24
35
[ Ana ] : https://gateway-api.sigs.k8s.io/concepts/roles-and-personas/#ana
@@ -227,39 +238,23 @@ the same configuration, or you'll need to provide a single Route with multiple
227
238
228
239
## API
229
240
230
- Most of the API work for this GEP is TBD at this point , but there are two
241
+ The API for OCG support will be defined in future GEPs , but there are a two
231
242
important points to note:
232
243
233
- First, Gateway API has never defined a Mesh resource because, to date, it's
234
- never been clear what would go into it. This may be the first configuration
235
- item that causes us to need a Mesh resource.
244
+ 1 . Gateway API has never defined a Mesh resource because, to date, it's never
245
+ been clear what would go into it. With the conformance work in progress and
246
+ with OCG support desired, we clearly will need a Mesh resource. The Mesh
247
+ resource is defined in [ GEP-3949] ( ../gep-3949/index.md ) .
236
248
237
- Second, since the API should affect only Gateway API resources, it is not a
238
- good candidate for policy attachment. It is likely to be much more reasonable
239
- to simply provide whatever extra configuration we need inline in the Gateway
240
- or Mesh resources.
249
+ 2 . Since the API should affect only Gateway API resources, it is not a good
250
+ candidate for policy attachment. It is likely to be much more reasonable to
251
+ simply provide whatever extra configuration we need inline in the Gateway
252
+ or Mesh resources.
241
253
242
254
## Graduation Criteria
243
255
244
256
In addition to the [ general graduation
245
- criteria] ( ../concepts/versioning.md#graduation-criteria ) , this GEP must also
246
- guarantee that ** all four** of the problems listed above need resolutions, and
247
- must have implementation from at least two different Gateways and two
248
- different meshes.
249
-
250
- ### Gateway for Ingress (North/South)
251
-
252
- ### Gateway For Mesh (East/West)
253
-
254
- ## Conformance Details
255
-
256
- #### Feature Names
257
-
258
- This GEP will use the feature name ` MeshOffClusterGateway ` , under the
259
- assumption that we will indeed need a Mesh resource.
260
-
261
- ### Conformance tests
262
-
263
- ## Alternatives
264
-
265
- ## References
257
+ criteria] ( ../concepts/versioning.md#graduation-criteria ) , before any GEP
258
+ defining an API for OCG support graduates to Standard it MUST also demonstrate
259
+ a resolution to ** all four** of the problems listed, and it MUST have
260
+ implementation from at least two different Gateways and two different meshes.
0 commit comments