Skip to content

Commit 9522bd0

Browse files
committed
docs: add v0.6.0 changelog entry
1 parent 6a8738a commit 9522bd0

File tree

1 file changed

+113
-0
lines changed

1 file changed

+113
-0
lines changed

CHANGELOG.md

+113
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,119 @@
1919
- [v0.1.0-rc2](#v010-rc2)
2020
- [v0.1.0-rc1](#v010-rc1)
2121

22+
# v0.6.0
23+
24+
## Major Changes
25+
26+
### ReferenceGrant moves to `v1beta1`, ReferencePolicy removed
27+
28+
With more implementations now supporting ReferenceGrant (and more conformance coverage of the resource), we've moved ReferenceGrant to `v1beta1` in this release. **Note** that moving to beta also moves the object to the Standard channel (it was Experimental previously).
29+
30+
We've also removed the already-deprecated ReferencePolicy resource, so please move over to the shiny new ReferenceGrant, which has all the same features.
31+
32+
- Promotes ReferenceGrant to the v1beta1 API and the standard release channel
33+
(#1455, @nathancoleman)
34+
- ReferencePolicy has been removed from the API in favor of ReferenceGrant.
35+
(#1406, @robscott)
36+
37+
### Introduce GRPCRoute
38+
39+
The `GRPCRoute` resource has been introduced in order to simplify the routing of GRPC requests.
40+
Its design is described in [GEP-1016](https://gateway-api.sigs.k8s.io/geps/gep-1016/).
41+
As it is a new resource, it is introduced in the experimental channel.
42+
43+
Thanks to @gnossen for pushing this ahead.
44+
45+
- Introduce GRPCRoute resource. (#1115, @gnossen)
46+
47+
### Status updates
48+
49+
As described in [GEP-1364](https://gateway-api.sigs.k8s.io/geps/gep-1364/), status conditions have been updated within the Gateway resource to make it more consistent with the rest of the API. These changes, along with some other status changes, are detailed below.
50+
51+
Gateway:
52+
53+
* New `Accepted` and `Programmed` conditions introduced.
54+
* `Scheduled` condition deprecated.
55+
* Core Conditions now `Accepted` and `Programmed`.
56+
* Moves to Extended: `Ready`.
57+
58+
Gateway Listener:
59+
60+
* New `Accepted` and `Programmed` conditions introduced.
61+
* `Detached` condition deprecated.
62+
* Core Conditions now `Accepted`, `Programmed`, `ResolvedRefs`, and `Conflicted`.
63+
* Moves to Extended: `Ready`.
64+
65+
All Resources:
66+
67+
* The `Accepted` Condition now has a `Pending` reason, which is the default until
68+
the condition is updated by a controller.
69+
70+
Route resources:
71+
72+
* The `Accepted` Condition now has a `NoMatchingParent` reason, to be set on routes
73+
when no matching parent can be found.
74+
75+
The purpose of these changes is to make the status flows more consistent across objects, and to provide a clear pattern for new objects as we evolve the API.
76+
77+
> **Note**: This change will require updates for implementations to be able to pass conformance tests. Implementations may choose to publish both new and old conditions, or only new conditions.
78+
79+
- Adds `Accepted` and deprecates `Detached` Listener conditions and reasons (#1446, @mikemorris)
80+
- Adds `Accepted` and deprecates `Scheduled` Gateway conditions and reasons (#1447, @mikemorris)
81+
- Adds `Pending` reason for use with all `Accepted` conditions throughout the API (#1453, @youngnick)
82+
- Adds `Programmed` Gateway and Listener conditions, moves `Ready` to extended
83+
conformance (#1499, @LCaparelli)
84+
- Add `RouteReasonNoMatchingParent` reason for `Accepted` condition. (#1516, @pmalek)
85+
86+
## Other Changes by type
87+
88+
### Deprecations
89+
90+
- GatewayClass, Gateway, and HTTPRoute are now only supported with the v1beta1
91+
version of the API. The v1alpha2 API versions of these resources will be fully
92+
removed in a future release. Additionally, v1alpha2 is marked as deprecated
93+
everywhere. (#1348 and #1405, @robscott)
94+
95+
### API Changes
96+
97+
- A new field `responseHeaderModifier` is added to `.spec.rules.filters`, which
98+
allows for modification of HTTP response headers (#1373, @aryan9600)
99+
- Display the Programmed condition instead of the Ready condition in the output
100+
- HTTPRoute: Validating webhook now ensures that Exact and Prefix path match
101+
values can now only include valid path values per RFC-3986. (RegularExpression
102+
path matches are not affected by this change). (#1599, @robscott)
103+
- `RegularExpression` type selectors have been clarified to all be
104+
`ImplementationSpecific` conformance. (#1604, @youngnick)
105+
106+
### Documentation
107+
108+
- Clarify that BackendObjectReference's Port field specifies a service port, not
109+
a target port, for Kubernetes Service backends. (#1332, @Miciah)
110+
- HTTPRequestHeaderFilter and HTTPResponseHeaderFilter forbid configuring
111+
multiple actions for the same header. (#1497, @rainest)
112+
- Changes "custom" conformance level to "implementation-specific" (#1436,
113+
@LCaparelli)
114+
- Clarification that changes to ReferenceGrants MUST be reconciled (#1429,
115+
@robscott)
116+
117+
### Conformance Tests
118+
119+
- ExemptFeatures have been merged into SupportedFeatures providing implementations
120+
a uniform way to specify the features they support.
121+
(#1507, @robscott) (#1394, @gyohuangxin)
122+
- To be conformant with the API, if there is no ReferenceGrant that grants a
123+
listener to reference a secret in another namespace, the
124+
ListenerConditionReason for the condition ResolvedRefs must be set to
125+
RefNotPermitted instead of InvalidCertificateRef. (#1305, @mlavacca)
126+
- A new test has been added to cover HTTP Redirects (#1556, @LiorLieberman)
127+
- Fix Gateway reference in HTTPRouteInvalidParentRefNotMatchingListenerPort
128+
(#1591, @sayboras)
129+
130+
### Developer Notes
131+
132+
- Deprecated `v1alpha2` Go types are now aliases to their `v1beta1` versions
133+
(#1390, @howardjohn)
134+
22135
# v0.6.0-rc2
23136

24137
We expect this to be our final release candidate before launching v0.6.0. This

0 commit comments

Comments
 (0)