Skip to content

Commit f443940

Browse files
committed
Switch to Memorandum rather than Provisional. Link to GEP-3949 for the Mesh resource, and define that the API will be different GEPs.
Signed-off-by: Flynn <[email protected]>
1 parent 0ad281e commit f443940

File tree

2 files changed

+31
-32
lines changed

2 files changed

+31
-32
lines changed

geps/gep-3792/index.md

Lines changed: 25 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,17 @@
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]
1926
and [Ian] want to be able to use these out-of-cluster proxies effectively and
2027
safely, 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
231242
important 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

244256
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.

geps/gep-3792/metadata.yaml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,14 @@ relationships:
2020
extendedBy: {}
2121
# seeAlso indicates other GEPs that are relevant in some way without being
2222
# covered by an existing relationship.
23-
seeAlso: {}
23+
seeAlso:
24+
- number: 3949
25+
name: Mesh Resource
26+
description: Defines the Mesh resource for managing service mesh configurations.
2427
# references is a list of hyperlinks to relevant external references.
2528
# It's intended to be used for storing GitHub discussions, Google docs, etc.
26-
references: {}
29+
references:
30+
- https://www.rfc-editor.org/rfc/rfc8174
2731
# featureNames is a list of the feature names introduced by the GEP, if there
2832
# are any. This will allow us to track which feature was introduced by which GEP.
2933
# This is the value added to supportedFeatures and the conformance tests, in string form.

0 commit comments

Comments
 (0)