Skip to content

feat: promote native sidecars to GA and enable by default#15267

Merged
alpeb merged 1 commit into
mainfrom
alpeb/native-sidecar-default
May 12, 2026
Merged

feat: promote native sidecars to GA and enable by default#15267
alpeb merged 1 commit into
mainfrom
alpeb/native-sidecar-default

Conversation

@alpeb
Copy link
Copy Markdown
Member

@alpeb alpeb commented May 11, 2026

Advances native sidecars support from beta to GA, and makes them the default injection mode for the proxy.

This requires Kubernetes v1.29 or later, which is below our current minimum supported version (v1.31). The cluster must also have the SidecarContainers feature gate enabled, which is the default in all recent Kubernetes versions.

You can verify the feature gate is enabled with:

$ kubectl get --raw /metrics | grep feature.*SidecarContainers
kubernetes_feature_enabled{name="SidecarContainers",stage=""} 1

Changes:

  • proxy.nativeSidecar now defaults to true
  • The config.beta.linkerd.io/proxy-enable-native-sidecar annotation is deprecated in favor of config.linkerd.io/proxy-enable-native-sidecar

Advances [native sidecars](https://kubernetes.io/docs/concepts/workloads/pods/sidecar-containers/)
support from beta to GA, and makes them the default injection mode for
the proxy.

This requires Kubernetes v1.29 or later, which is below our current
minimum supported version (v1.31). The cluster must also have the
`SidecarContainers` feature gate enabled, which is the default in all
recent Kubernetes versions.

You can verify the feature gate is enabled with:
```
$ kubectl get --raw /metrics | grep feature.*SidecarContainers
kubernetes_feature_enabled{name="SidecarContainers",stage=""} 1
```

Changes:
- `proxy.nativeSidecar` now defaults to `true`
- The `config.beta.linkerd.io/proxy-enable-native-sidecar` annotation is
deprecated in favor of `config.linkerd.io/proxy-enable-native-sidecar`
@alpeb alpeb requested a review from a team as a code owner May 11, 2026 21:37
@alpeb alpeb merged commit 009a25f into main May 12, 2026
93 of 99 checks passed
@alpeb alpeb deleted the alpeb/native-sidecar-default branch May 12, 2026 21:41
alpeb added a commit that referenced this pull request May 14, 2026
Now that native sidecars are enabled by default since #15267, repurpose
the `deep-native-sidecar` test into `deep-non-native-sidecar`, so that it
runs the deep suite using the now non-default non-native-sidecar mode.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants