11# GEP-3792: Out-of-Cluster Gateways
22
33* Issue: [ #3792 ] ( https://github.com/kubernetes-sigs/gateway-api/issues/3792 )
4- * Status: Provisional
4+ * Status: Memorandum
55
66(See [ status definitions] ( ../overview.md#gep-states ) .)
77
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+
815## User Story
916
1017** [ 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]
1926and [ Ian] want to be able to use these out-of-cluster proxies effectively and
2027safely, though they recognize that this may require additional configuration.
2128
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+
2233[ Chihiro ] : https://gateway-api.sigs.k8s.io/concepts/roles-and-personas/#chihiro
2334[ Ian ] : https://gateway-api.sigs.k8s.io/concepts/roles-and-personas/#ian
2435[ 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
227238
228239## API
229240
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
231242important points to note:
232243
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 ) .
236248
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.
241253
242254## Graduation Criteria
243255
244256In 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