Skip to content

Commit 46d18e2

Browse files
ctauchensabagsclauderene-dekker
authored
DOCS-2965: Publish Calico Enterprise 3.23.1 (#2814)
Co-authored-by: Saba <saba@tigera.io> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Rene Dekker <rene@tigera.io>
1 parent a51cfb7 commit 46d18e2

11 files changed

Lines changed: 382 additions & 78 deletions

File tree

calico-enterprise/getting-started/compatibility.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ The following list shows the platforms supported in this release. If you're work
1818
- [OpenShift](#openshift)
1919
- [RKE](#rke)
2020
- [RKE2](#rke2)
21+
- [VKS](#vks)
2122
- [TKG](#tkg)
2223
- [Charmed Kubernetes](#charmed-kubernetes)
2324

@@ -55,19 +56,17 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
5556

5657
| $[prodname] version | kOps and Kubernetes versions | $[prodname] support |
5758
| -------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |
58-
| 3.23 | 1.33 - 1.34 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
59+
| 3.23 | 1.33 - 1.35 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
5960
| 3.22 | 1.31 - 1.34 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
6061
| 3.21 | 1.31 - 1.32 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
61-
| 3.20 | 1.29 - 1.30 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
6262

6363
## Kubernetes-kubeadm
6464

6565
| $[prodname] version | Kubernetes/kubeadm versions | $[prodname] support |
6666
| -------------------- | --------------------------- | ------------------------------------ |
67-
| 3.23 | 1.33 - 1.36 | $[prodname] CNI with network policy |
67+
| 3.23 | 1.34 - 1.36 | $[prodname] CNI with network policy |
6868
| 3.22 | 1.31 - 1.35 | $[prodname] CNI with network policy |
6969
| 3.21 | 1.31 - 1.33 | $[prodname] CNI with network policy |
70-
| 3.20 | 1.29 - 1.31 | $[prodname] CNI with network policy |
7170

7271
## MKE 4k
7372

@@ -84,16 +83,14 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
8483
| 3.22 | MKE 3.9 | $[prodname] CNI with network policy | 1.34 |
8584
| 3.22 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
8685
| 3.21 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
87-
| 3.20 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
8886

8987
## OpenShift
9088

9189
| $[prodname] version | OpenShift versions for Kubernetes | $[prodname] support |
9290
| -------------------- | --------------------------------- | ------------------------------------ |
93-
| 3.23 | 4.19 - 4.21 | $[prodname] CNI with network policy |
91+
| 3.23 | 4.19 - 4.22 | $[prodname] CNI with network policy |
9492
| 3.22 | 4.17 - 4.20 | $[prodname] CNI with network policy |
9593
| 3.21 | 4.16 - 4.18 | $[prodname] CNI with network policy |
96-
| 3.20 | 4.15 - 4.17 | $[prodname] CNI with network policy |
9794

9895
## RKE
9996

@@ -102,16 +99,20 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
10299
| 3.23 | 1.8 | $[prodname] CNI with network policy | 1.32 |
103100
| 3.22 | 1.8 | $[prodname] CNI with network policy | 1.32 |
104101
| 3.21 | 1.8 | $[prodname] CNI with network policy | 1.32 |
105-
| 3.20 | 1.7 | $[prodname] CNI with network policy | 1.31 |
106102

107103
## RKE2
108104

109105
| $[prodname] version | $[prodname] support | Kubernetes versions |
110106
| -------------------- | ------------------------------------ | ------------------- |
111-
| 3.23 | $[prodname] CNI with network policy | 1.33 - 1.35 |
107+
| 3.23 | $[prodname] CNI with network policy | 1.34 - 1.36 |
112108
| 3.22 | $[prodname] CNI with network policy | 1.31 - 1.34 |
113109
| 3.21 | $[prodname] CNI with network policy | 1.31 - 1.33 |
114-
| 3.20 | $[prodname] CNI with network policy | 1.29 - 1.31 |
110+
111+
## VKS
112+
113+
| $[prodname] version | VKS version | $[prodname] support | Kubernetes versions |
114+
| -------------------- | ----------- | ------------------------------------ | ------------------- |
115+
| 3.23 | VKS 3.7 | $[prodname] CNI with network policy | 1.36 |
115116

116117
## TKG
117118

@@ -120,7 +121,6 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
120121
| 3.23 | 2.4 | $[prodname] CNI with network policy | 1.27 |
121122
| 3.22 | 2.4 | $[prodname] CNI with network policy | 1.27 |
122123
| 3.21 | 2.4 | $[prodname] CNI with network policy | 1.27 |
123-
| 3.20 | 2.4 | $[prodname] CNI with network policy | 1.27 |
124124

125125
## Charmed Kubernetes
126126

calico-enterprise/reference/resources/network.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ Exactly one field must be set.
116116
### Status
117117

118118
`Network.status.conditions` reports the observed state of the resource as a
119-
list of standard Kubernetes [conditions](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/condition/).
119+
list of standard Kubernetes [conditions](https://kubernetes.io/docs/reference/kubernetes-api/definitions/condition-v1-meta/).
120120

121121
## Attaching pods to a Network
122122

calico-enterprise_versioned_docs/version-3.22-2/variables.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ const variables = {
77
prodnamedash: 'calico-enterprise',
88
version: 'v3.22',
99
openSourceVersion: releases[0].calico.minor_version.slice(1),
10-
baseUrl: '/calico-enterprise/latest',
10+
baseUrl: '/calico-enterprise/3.22',
1111
filesUrl: 'https://downloads.tigera.io/ee/v3.22.6',
1212
rpmsUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5),
1313
tutorialFilesURL: 'https://docs.tigera.io/files',

calico-enterprise_versioned_docs/version-3.23-2/getting-started/compatibility.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ The following list shows the platforms supported in this release. If you're work
1818
- [OpenShift](#openshift)
1919
- [RKE](#rke)
2020
- [RKE2](#rke2)
21+
- [VKS](#vks)
2122
- [TKG](#tkg)
2223
- [Charmed Kubernetes](#charmed-kubernetes)
2324

@@ -55,19 +56,17 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
5556

5657
| $[prodname] version | kOps and Kubernetes versions | $[prodname] support |
5758
| -------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |
58-
| 3.23 | 1.33 - 1.34 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
59+
| 3.23 | 1.33 - 1.35 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
5960
| 3.22 | 1.31 - 1.34 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
6061
| 3.21 | 1.31 - 1.32 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
61-
| 3.20 | 1.29 - 1.30 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
6262

6363
## Kubernetes-kubeadm
6464

6565
| $[prodname] version | Kubernetes/kubeadm versions | $[prodname] support |
6666
| -------------------- | --------------------------- | ------------------------------------ |
67-
| 3.23 | 1.33 - 1.36 | $[prodname] CNI with network policy |
67+
| 3.23 | 1.34 - 1.36 | $[prodname] CNI with network policy |
6868
| 3.22 | 1.31 - 1.35 | $[prodname] CNI with network policy |
6969
| 3.21 | 1.31 - 1.33 | $[prodname] CNI with network policy |
70-
| 3.20 | 1.29 - 1.31 | $[prodname] CNI with network policy |
7170

7271
## MKE 4k
7372

@@ -84,16 +83,14 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
8483
| 3.22 | MKE 3.9 | $[prodname] CNI with network policy | 1.34 |
8584
| 3.22 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
8685
| 3.21 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
87-
| 3.20 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
8886

8987
## OpenShift
9088

9189
| $[prodname] version | OpenShift versions for Kubernetes | $[prodname] support |
9290
| -------------------- | --------------------------------- | ------------------------------------ |
93-
| 3.23 | 4.19 - 4.21 | $[prodname] CNI with network policy |
91+
| 3.23 | 4.19 - 4.22 | $[prodname] CNI with network policy |
9492
| 3.22 | 4.17 - 4.20 | $[prodname] CNI with network policy |
9593
| 3.21 | 4.16 - 4.18 | $[prodname] CNI with network policy |
96-
| 3.20 | 4.15 - 4.17 | $[prodname] CNI with network policy |
9794

9895
## RKE
9996

@@ -102,16 +99,20 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
10299
| 3.23 | 1.8 | $[prodname] CNI with network policy | 1.32 |
103100
| 3.22 | 1.8 | $[prodname] CNI with network policy | 1.32 |
104101
| 3.21 | 1.8 | $[prodname] CNI with network policy | 1.32 |
105-
| 3.20 | 1.7 | $[prodname] CNI with network policy | 1.31 |
106102

107103
## RKE2
108104

109105
| $[prodname] version | $[prodname] support | Kubernetes versions |
110106
| -------------------- | ------------------------------------ | ------------------- |
111-
| 3.23 | $[prodname] CNI with network policy | 1.33 - 1.35 |
107+
| 3.23 | $[prodname] CNI with network policy | 1.34 - 1.36 |
112108
| 3.22 | $[prodname] CNI with network policy | 1.31 - 1.34 |
113109
| 3.21 | $[prodname] CNI with network policy | 1.31 - 1.33 |
114-
| 3.20 | $[prodname] CNI with network policy | 1.29 - 1.31 |
110+
111+
## VKS
112+
113+
| $[prodname] version | VKS version | $[prodname] support | Kubernetes versions |
114+
| -------------------- | ----------- | ------------------------------------ | ------------------- |
115+
| 3.23 | VKS 3.7 | $[prodname] CNI with network policy | 1.36 |
115116

116117
## TKG
117118

@@ -120,7 +121,6 @@ Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm
120121
| 3.23 | 2.4 | $[prodname] CNI with network policy | 1.27 |
121122
| 3.22 | 2.4 | $[prodname] CNI with network policy | 1.27 |
122123
| 3.21 | 2.4 | $[prodname] CNI with network policy | 1.27 |
123-
| 3.20 | 2.4 | $[prodname] CNI with network policy | 1.27 |
124124

125125
## Charmed Kubernetes
126126

calico-enterprise_versioned_docs/version-3.23-2/reference/resources/network.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ Exactly one field must be set.
116116
### Status
117117

118118
`Network.status.conditions` reports the observed state of the resource as a
119-
list of standard Kubernetes [conditions](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/condition/).
119+
list of standard Kubernetes [conditions](https://kubernetes.io/docs/reference/kubernetes-api/definitions/condition-v1-meta/).
120120

121121
## Attaching pods to a Network
122122

calico-enterprise_versioned_docs/version-3.23-2/release-notes/index.mdx

Lines changed: 38 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,6 @@ title: Release notes
55

66
# Calico Enterprise 3.23 release notes
77

8-
:::info[early preview release]
9-
10-
Calico Enterprise 3.23 can be used for previewing and testing purposes only.
11-
It is not supported for use in production.
12-
13-
:::
14-
158
Learn about the new features, bug fixes, and other updates in this release of $[prodname].
169

1710
This version of Calico Enterprise is based on [Calico Open Source $[openSourceVersion]](https://docs.tigera.io/calico/$[openSourceVersion]/release-notes).
@@ -114,47 +107,33 @@ For more information, see [Add Maglev load balancing to a service](../networking
114107

115108
{/* End 3.23.0-1.0 features */}
116109

117-
### Enhancements
110+
{/* Start 3.23.1 features */}
118111

119-
* Improved the deterministic selection logic for flow and L7 logs when multiple NetworkSets have overlapping CIDRs.
120-
Logs and Service Graph now prioritize namespace-specific matches over GlobalNetworkSets and other namespace matches to ensure more accurate identity attribution.
121-
* User experience improvements to the Flow Summary card.
112+
### Install on VMware Kubernetes Service (VKS)
122113

123-
## Technology preview features
114+
You can now install $[prodname] on VMware Kubernetes Service (VKS). You deploy it as a Supervisor Service to your guest clusters, and can add Windows nodes if you need them.
115+
Air-gapped installs also work, including relocating the bundle and images to a local registry.
124116

125-
The following features are available as technology previews. Tech preview features are for evaluation and feedback only and are **not supported for production use**. Behavior, APIs, and configuration may change before a feature reaches general availability.
117+
For more information, see [VMware Kubernetes Service (VKS)](#).
126118

127-
{/* TODO: verify these rows against the 3.21 and 3.22 release notes and any TP additions in 3.23.0-1.0. */}
119+
{/* End 3.23.1 features */}
128120

129-
| Feature | 3.21 | 3.22 | 3.23 |
130-
|---|---|---|---|
131-
| [Istio Ambient Mode](../compliance/istio/about-istio-ambient.mdx) || TP | TP |
132-
| [Built-in observability dashboards](../observability/dashboards.mdx) || TP | TP |
133-
| [Calico Ingress Gateway](../networking/ingress-gateway/about-calico-ingress-gateway.mdx) | TP | GA | GA |
134-
| [KubeVirt live migration](../networking/kubevirt/index.mdx) ||| TP |
135-
| [Multi-VRF networking](../networking/configuring/multi-vrf.mdx) ||| TP |
136-
| [Native v3 CRDs](../operations/native-v3-crds.mdx) ||| TP |
121+
### Enhancements
137122

138-
Legend: **TP** = technology preview · **GA** = generally available · **** = not yet introduced.
123+
* Improved the deterministic selection logic for flow and L7 logs when multiple NetworkSets have overlapping CIDRs.
124+
Logs and Service Graph now prioritize namespace-specific matches over GlobalNetworkSets and other namespace matches to ensure more accurate identity attribution.
125+
* User experience improvements to the Flow Summary card.
139126

140127
## Deprecated and removed features
141128

142-
* Support for RHEL 8 and Windows 1809 is deprecated and scheduled for removal in an upcoming release.
129+
* Support for RHEL 8 and Windows 1809 has been removed in this release.
143130
* Support for the x86-64 v2 chip architecture is deprecated and scheduled for removal in an upcoming release.
144131
* Application-layer policy and L7 observability features based on Envoy as a daemonset are deprecated and scheduled for removal in an upcoming release. These are being replaced with similar functionality using Istio Ambient Mode.
145132

146-
| Feature | 3.21 | 3.22 | 3.23 |
147-
|---|---|---|---|
148-
| RHEL 8 and Windows 1809 support | GA | GA | Deprecated |
149-
| x86-64 v2 chip architecture | GA | GA | Deprecated |
150-
| Envoy daemonset (application-layer policy, L7 observability) | GA | GA | Deprecated |
151-
152-
Legend: **GA** = generally available · **Deprecated** = scheduled for removal · **Removed** = no longer present · **** = not yet introduced.
153-
154133
## Known issues
155134

156135
* In clusters using the eBPF data plane with strict reverse path forwarding (RPF) enabled, link-local discovery packets may be incorrectly dropped. This can interfere with neighbor discovery and local network communication. A fix is planned for an upcoming release.
157-
* The combination of the eBPF data plane on EKS with Bottlerocket is currently not working; the issue is under investigation.
136+
* The eBPF data plane on EKS with Kubernetes 1.36 is currently not working, including in combination with Bottlerocket; the issue is under investigation.
158137
* On ARM64 with the eBPF data plane, the DNS parser can fail to load, which can result in timeouts.
159138

160139
## Upgrading
@@ -218,3 +197,29 @@ This release is for previewing and testing purposes only. It is not supported fo
218197
* In clusters using the eBPF data plane with strict reverse path forwarding (RPF) enabled, link-local discovery packets may be incorrectly dropped. This can interfere with neighbor discovery and local network communication.
219198
* The combination of the eBPF data plane on EKS with Bottlerocket is currently not working; the issue is under investigation.
220199
* On ARM64 with the eBPF data plane, the DNS parser can fail to load, which can result in timeouts.
200+
201+
### Calico Enterprise 3.23.1 general availability release
202+
203+
July 6, 2026
204+
205+
Calico Enterprise 3.23.1 is now available as a general availability release.
206+
207+
This release is supported for use in production.
208+
209+
{/* TODO (fill after): add #### Breaking changes, #### Bug fixes, #### Known issues — omit any subsection with no items. */}
210+
211+
#### Bug fixes
212+
213+
* Fixed an issue where non-cluster hosts could inherit an unsupported data plane mode from the cluster's global FelixConfiguration. The eBPF data plane is now disabled on all non-cluster host packages, and RHEL 8 hosts are forced to use the iptables data plane (its 4.18 kernel does not reliably support nftables). RHEL 9, Debian, and Ubuntu continue to inherit the cluster's data plane choice.
214+
* Fixed an issue where DNS-policy trusted servers (including `k8s-service:` references such as the default `kube-dns`) were resolved only once at startup and never refreshed. They are now kept up to date as the backing Service changes.
215+
* Fixed a bug where Felix could permanently lose its DNS-policy NFQUEUE listener after a transient queue reconnect, causing domain-based policy to stop being enforced until Felix restarted.
216+
217+
#### Known issues
218+
219+
* On clusters using the eBPF data plane, a `HostEndpoint` policy can block UDP return traffic for pod-originated egress that uses NAT-outgoing (SNAT). TCP and ICMP traffic is unaffected. A fix is planned for an upcoming patch release.
220+
* If the cluster's Kubernetes service account issuer changes (for example, during platform maintenance), $[prodname] components that validate bearer tokens keep using the previous issuer until restarted and reject service account tokens with `bearer token was not issued by a trusted issuer`. Manager UI observability pages (Service Graph, dashboard traffic stats, process info, L7 logs), license details, and log ingestion can fail while `tigerastatuses` still report Available. As a workaround, restart the token-validating components (`tigera-linseed`, `calico-apiserver`, `tigera-manager`, and `compliance-server`) so they re-read the current issuer, then re-create any long-lived Manager login tokens minted before the change. A fix is planned for an upcoming patch release.
221+
222+
223+
#### Upgrading
224+
225+
To update an existing installation of Calico Enterprise 3.23, see [Install a patch release](../getting-started/manifest-archive.mdx).

0 commit comments

Comments
 (0)