generated from kubernetes/kubernetes-template-project
-
Notifications
You must be signed in to change notification settings - Fork 532
GEP-713 enhancements #3609
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
guicassolato
wants to merge
31
commits into
kubernetes-sigs:main
Choose a base branch
from
guicassolato:geps/713-enhancements
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
GEP-713 enhancements #3609
Changes from all commits
Commits
Show all changes
31 commits
Select commit
Hold shift + click to select a range
8103bdd
GEP-713 resurrected
guicassolato a5b2831
update metadata files
guicassolato e521384
not forcing annotations on objects not owned by the implementation
guicassolato d64847c
conflict resolution section rewritten to clarify that the merge strat…
guicassolato 80d8212
Metaresource spelled as a single word
guicassolato 316eab7
addressing comments
guicassolato b55801c
fixing escaping of arrows and gt/lw characters
guicassolato 0219a67
clarifying metaresource statuses' MUST vs SHOULD and example of targe…
guicassolato 2c82ef0
targeting strategy -> targeting method, to avoid overloading of the t…
guicassolato 9de81f1
fix target object status MUST versus SHOULD
guicassolato 6de2c66
diagrams to illustrate the abstract process for calculating effective…
guicassolato c8285d5
golang examples of target refs
guicassolato 2cea406
fix broken anchors
guicassolato a627524
diagrams for the end-to-end examples
guicassolato 981b71c
sentence rephrased for improved readability
guicassolato 9d24b4b
addressing a few comments by candita and robscott
guicassolato b6e34f0
typos
guicassolato 9d4d572
Get GEP-713 back to Memorandum
guicassolato 1b83da5
Reorg (take 1)
guicassolato 4b92726
Reorg (take 2)
guicassolato 90226e6
minor fixes
guicassolato f1a30e0
fix: typo in 'sectionName'
guicassolato 748d3c0
minor fixes (2)
guicassolato f077442
fix: typos
guicassolato de6fa8e
sentence about different kinds possibly implying different targetting…
guicassolato 8889cbc
small enhancements to description of' Hierarchy of target kinds' and …
guicassolato dd26421
Clarifying enhancements to the definitions of merge strategy and rela…
guicassolato 637350e
added motivation to define 'classes of metaresources'
guicassolato 9325ebf
Preferring 'Policy' over 'Metaresource' when prescribing rules/schema…
guicassolato d265123
Label selectors as a mechanism to target removed from the spec
guicassolato 04ec82a
More thorough definitions for the spec'ed merge strategies
guicassolato File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -2,17 +2,17 @@ apiVersion: internal.gateway.networking.k8s.io/v1alpha1 | |||||
kind: GEPDetails | ||||||
number: 2648 | ||||||
name: Direct Policy Attachment | ||||||
status: Provisional | ||||||
status: Declined | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
# Any authors who contribute to the GEP in any way should be listed here using | ||||||
# their GitHub handle. | ||||||
authors: | ||||||
- youngnick | ||||||
- robscott | ||||||
relationships: | ||||||
extends: | ||||||
obsoletedBy: | ||||||
- name: Metaresources and Policy Attachment | ||||||
number: 713 | ||||||
description: Split out Direct Policy Attachment into its own GEP | ||||||
description: Merged back into the original spec for Metaresources and Policy Attachment where it's presented as a well-defined class of metaresource | ||||||
# references is a list of hyperlinks to relevant external references. | ||||||
# It's intended to be used for storing GitHub discussions, Google docs, etc. | ||||||
references: | ||||||
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -1,24 +1,22 @@ | ||||||
# GEP-2649: Inherited Policy Attachment | ||||||
|
||||||
* Issue: [#2649](https://github.com/kubernetes-sigs/gateway-api/issues/2649) | ||||||
* Status: Experimental | ||||||
* Status: Declined | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
||||||
(See [status definitions](../overview.md#gep-states).) | ||||||
|
||||||
## TLDR | ||||||
|
||||||
!!! warning | ||||||
This GEP has been merged back into [GEP-713](https://gateway-api.sigs.k8s.io/geps/gep-713/) | ||||||
and now it's now obsolete. Please refer the original specification of Metaresources | ||||||
and Policy Attachment for the current state of the pattern. | ||||||
|
||||||
Describe and specify a design pattern for a class of metaresource that can | ||||||
affect specific settings across a multiple target objects. | ||||||
|
||||||
This is a design for a _pattern_, not an API field or new object. | ||||||
|
||||||
!!! danger | ||||||
This GEP is in the process of being updated. | ||||||
Please see the discussion at https://github.com/kubernetes-sigs/gateway-api/discussions/2927 | ||||||
and expect further changes. | ||||||
Some options under discussion there may make the distinction between Direct | ||||||
and Inherited Policies moot, which would require a rework. | ||||||
|
||||||
## Goals | ||||||
|
||||||
* Specify what common properties all Inherited Policies MUST have | ||||||
|
@@ -224,7 +222,7 @@ proposal](https://github.com/kubernetes-sigs/gateway-api/issues/611). | |||||
|
||||||
### Policy Attachment for Ingress | ||||||
When talking about Direct Attached Policy attaching to Gateway resources for | ||||||
ingress use cases (as discussed in GEP-2648), the flow is relatively | ||||||
ingress use cases (as discussed in GEP-2648), the flow is relatively | ||||||
straightforward. A policy can reference the resource it wants to apply to, and | ||||||
only affects that resource. | ||||||
|
||||||
|
@@ -245,7 +243,7 @@ namespaces. | |||||
 | ||||||
|
||||||
In this example, the Gateway has a TimeoutPolicy attached, which affects the | ||||||
HTTPRoute in the App namespace. That HTTPRoute also has the Direct Attached | ||||||
HTTPRoute in the App namespace. That HTTPRoute also has the Direct Attached | ||||||
RetryPolicy attached, which affects the HTTPRoute itself, and one of the backends | ||||||
has a HealthCheckPolicy attached to the Service, which is also a Direct Attached | ||||||
Policy. | ||||||
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -2,15 +2,15 @@ apiVersion: internal.gateway.networking.k8s.io/v1alpha1 | |||||
kind: GEPDetails | ||||||
number: 2649 | ||||||
name: Inherited Policy Attachment | ||||||
status: Provisional | ||||||
status: Declined | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
authors: | ||||||
- youngnick | ||||||
- robscott | ||||||
relationships: | ||||||
extends: | ||||||
obsoletedBy: | ||||||
- name: Metaresources and Policy Attachment | ||||||
number: 713 | ||||||
description: Split out Inherited Policy Attachment | ||||||
description: Merged back into the original spec for Metaresources and Policy Attachment where it's presented as a well-defined class of metaresource | ||||||
# references is a list of hyperlinks to relevant external references. | ||||||
# It's intended to be used for storing GitHub discussions, Google docs, etc. | ||||||
references: | ||||||
|
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think
Declined
was suggested before. OK withReplaced
instead, @youngnick?