Skip to content
Original file line number Diff line number Diff line change
Expand Up @@ -56,24 +56,34 @@ For more information, see [L2 reachability for pods and services without BGP](..

### Enhancements

* **Enable Calico Ingress Gateway during Helm installation:**
You can now enable Calico Ingress Gateway when you install $[prodname] with Helm, by setting `gatewayAPI.enabled: true` in your `values.yaml`.
* You can now enable Calico Ingress Gateway when you install $[prodname] with Helm, by setting `gatewayAPI.enabled: true` in your `values.yaml`.
For more information, see the [Helm installation reference](../reference/installation/helm_customization.mdx).
- New installs default to v3 CRD mode: `projectcalico.org/v3` resources are served directly by CRDs, with no aggregation API server. Existing and upgraded clusters are unaffected. To install with the aggregation API server instead, apply the v1 CRDs before installing the operator. v3 CRD mode requires Kubernetes 1.32 or later. See [Native v3 CRDs](../operations/native-v3-crds.mdx).

### Deprecated and removed features

- $[prodname] is moving the `projectcalico.org/v3` API from the aggregated API server to native Kubernetes CRDs. Both mechanisms will be supported until native v3 CRDs are compatible with all supported platforms, after which the aggregated API server will be removed.
* $[prodname] is moving the `projectcalico.org/v3` API from the aggregated API server to native Kubernetes CRDs.
Both mechanisms will be supported until native v3 CRDs are compatible with all supported platforms, after which the aggregated API server will be removed.

## Technology Preview features
{/* ## Technology Preview features */}

## Upgrade notes
{/* ### Known issues */}

{/* Add breaking changes and required upgrade steps here, one subsection per feature. */}
## Upgrading

Before upgrading to Calico Enterprise 3.24, review [Upgrade notes](#upgrade-notes), [Deprecated and removed features](#deprecated-and-removed-features), and [Known issues](#known-issues).

### Upgrade from a previous minor

### Calico Ingress Gateway
Calico Enterprise 3.24 supports a direct upgrade from versions 3.23 and 3.22.
To upgrade from an earlier version, plan an intermediate upgrade.

:::warning[Breaking change]
For upgrade instructions, see [Upgrade Calico Enterprise](../getting-started/upgrading/upgrading-enterprise/index.mdx).

### Upgrade notes

{/* Add breaking changes and required upgrade steps here, one subsection per feature. */}

### Breaking changes for Calico Ingress Gateway

Calico Ingress Gateway now runs each gateway's proxy in the same namespace as its `Gateway`, and the controller moves to `calico-system`.
On upgrade, existing proxies move out of the `tigera-gateway` namespace into each Gateway's namespace, so anything pinned to `tigera-gateway` — network policy, monitoring, RBAC, and external DNS — must move with them.
Expand All @@ -85,13 +95,11 @@ Migrate in this order:
2. Upgrade $[prodname].
3. After the upgrade, re-point monitoring, RBAC, and external DNS from `tigera-gateway` to each Gateway's namespace. If you used merged gateways, plan for one load balancer, DNS record, and certificate per gateway.

:::

## Release details

### Calico Enterprise 3.24.0-1.0 (early preview)

January xx, 2024
July 30, 2025

Calico Enterprise 3.24.0-1.0 is now available as an early preview release.
This release is for previewing and testing purposes only.
Expand Down
7 changes: 6 additions & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -462,14 +462,19 @@ export default async function createAsyncConfig() {
path: 'calico-enterprise',
routeBasePath: 'calico-enterprise',
editCurrentVersion: true,
onlyIncludeVersions: [...nextVersion, '3.23-2', '3.22-2', '3.21-2'],
onlyIncludeVersions: [...nextVersion, '3.24-1', '3.23-2', '3.22-2', '3.21-2'],
lastVersion: '3.23-2',
versions: {
current: {
label: 'Next',
path: 'next',
banner: 'unreleased',
},
'3.24-1': {
label: '3.24 (early preview)',
path: '3.24',
banner: 'unreleased',
},
'3.23-2': {
label: '3.23 (latest)',
path: 'latest',
Expand Down