Skip to content

Commit 26e03ed

Browse files
authored
delay migrating to XDS Name Scheme V2 by default (#7170)
* delay migrating to XDS Name Scheme V2 by default The cost of migrating envoy patch policies to the new naming scheme is higher than the impact of staying on the V1 scheme Signed-off-by: Arko Dasgupta <[email protected]> * update to v1.10 Signed-off-by: Arko Dasgupta <[email protected]>
1 parent a9fa022 commit 26e03ed

File tree

3 files changed

+6
-6
lines changed

3 files changed

+6
-6
lines changed

site/content/en/latest/tasks/extensibility/envoy-patch-policy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -104,9 +104,9 @@ Because [EnvoyPatchPolicy][] relies on specific xDS resource names, it’s impor
104104
| | V2 (HTTPS) | `https-<Port>` | `https-443` |
105105

106106

107-
This change is gated by the XDSNameSchemeV2 runtime flag. The flag is disabled by default in v1.5 and will be enabled by default starting in v1.6.
107+
This change is gated by the XDSNameSchemeV2 runtime flag. The flag is disabled by default in v1.5 and will be enabled by default starting in v1.10.
108108

109-
We recommend users begin migrating their [EnvoyPatchPolicy][] resources to use the version 2 naming scheme before upgrading to v1.6.
109+
We recommend users begin migrating their [EnvoyPatchPolicy][] resources to use the version 2 naming scheme before upgrading to v1.10.
110110

111111
To opt in to the new naming scheme early, add the`XDSNameSchemeV2` runtime flag to the `runtimeFlags.enabled` field in your [EnvoyGateway][] configuration.
112112

site/content/en/news/releases/v1.5.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Envoy Gateway v1.5.0 introduces powerful enhancements, resolves critical issues,
2727
- **Endpoint Removal Behavior**: Endpoints absent from service discovery are removed even if their active health checks succeed.
2828
- **xDS Listener Naming**: Listeners are now named based on listening port and protocol instead of Gateway and section names.
2929
- This affects existing `EnvoyPatchPolicies` and `ExtensionManagers`.
30-
- Controlled by the `XDSNameSchemeV2` runtime flag (disabled in v1.5, enabled in v1.6).
30+
- Controlled by the `XDSNameSchemeV2` runtime flag (disabled by default in v1.5, enabled in v1.10).
3131
- See the [migration guide](../../v1.5/tasks/extensibility/envoy-patch-policy#xds-name-scheme-v2) to prepare.
3232
- **Metrics Label Change**: Removed `xds-translator` and `xds-server` values from the `runner` label in `watchable_subscribe_total`; use `xds` instead.
3333
- **ALS Access Loggers**: ALS now has HTTP/2 enabled on the cluster by default.
@@ -134,4 +134,4 @@ We encourage all users to upgrade to v1.5.0 to take advantage of the new feature
134134
[Release Notes]: ./notes/v1.5.0.md
135135
[docs]: https://gateway.envoyproxy.io
136136
[matrix]: https://gateway.envoyproxy.io/news/releases/matrix/
137-
[Install]: https://gateway.envoyproxy.io/docs/tasks/quickstart/
137+
[Install]: https://gateway.envoyproxy.io/docs/tasks/quickstart/

site/content/en/v1.5/tasks/extensibility/envoy-patch-policy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -104,9 +104,9 @@ Because [EnvoyPatchPolicy][] relies on specific xDS resource names, it’s impor
104104
| | V2 (HTTPS) | `https-<Port>` | `https-443` |
105105

106106

107-
This change is gated by the XDSNameSchemeV2 runtime flag. The flag is disabled by default in v1.5 and will be enabled by default starting in v1.6.
107+
This change is gated by the XDSNameSchemeV2 runtime flag. The flag is disabled by default in v1.5 and will be enabled by default starting in v1.10.
108108

109-
We recommend users begin migrating their [EnvoyPatchPolicy][] resources to use the version 2 naming scheme before upgrading to v1.6.
109+
We recommend users begin migrating their [EnvoyPatchPolicy][] resources to use the version 2 naming scheme before upgrading to v1.10.
110110

111111
To opt in to the new naming scheme early, add the`XDSNameSchemeV2` runtime flag to the `runtimeFlags.enabled` field in your [EnvoyGateway][] configuration.
112112

0 commit comments

Comments
 (0)