Kubernetes Compatibility

Cilium is compatible with multiple Kubernetes API Groups. Some are deprecated or beta, and may only be available in specific versions of Kubernetes.

All Kubernetes versions listed are e2e tested and guaranteed to be compatible with Cilium. Older and newer Kubernetes versions, while not listed, will depend on the forward / backward compatibility offered by Kubernetes.

k8s Version

k8s NetworkPolicy API

CiliumNetworkPolicy

1.26, 1.27, 1.28, 1.29

cilium.io/v2 has a CustomResourceDefinition

As a general rule, Cilium aims to run e2e tests using the latest build from the development branch against currently supported Kubernetes versions defined in Kubernetes Patch Releases page.

Once a release branch gets created from the development branch, Cilium typically does not change the Kubernetes versions it uses to run e2e tests for the entire maintenance period of that particular release.

Additionally, Cilium runs e2e tests against various cloud providers’ managed Kubernetes offerings using multiple Kubernetes versions. See the following links for the current test matrix for each cloud provider:

Cilium CRD schema validation

Cilium uses a CRD for its Network Policies in Kubernetes. This CRD might have changes in its schema validation, which allows it to verify the correctness of a Cilium Clusterwide Network Policy (CCNP) or a Cilium Network Policy (CNP).

The CRD itself has an annotation, io.cilium.k8s.crd.schema.version, with the schema definition version. By default, Cilium automatically updates the CRD, and its validation, with a newer one.

The following table lists all Cilium versions and their expected schema validation version:

Cilium Version

CNP and CCNP Schema Version

v1.13.0-rc0

1.26.0

v1.13.0-rc1

1.26.1

v1.13.0-rc2

1.26.2

v1.13.0-rc3

1.26.3

v1.13.0-rc4

1.26.6

v1.13.0-rc5

1.26.7

v1.13.0

1.26.7

v1.13.1

1.26.7

v1.13.2

1.26.7

v1.13.3

1.26.7

v1.13.4

1.26.7

v1.13.5

1.26.7

v1.13.6

1.26.7

v1.13.7

1.26.7

v1.13.8

1.26.7

v1.13.9

1.26.7

v1.13.10

1.26.7

v1.13.11

1.26.7

v1.13.12

1.26.7

v1.13

1.26.7

v1.14.0-pre.2

1.26.8

v1.14.0-rc.0

1.26.9

v1.14.0-rc.1

1.26.10

v1.14.0-snapshot.0

1.26.7

v1.14.0-snapshot.1

1.26.7

v1.14.0-snapshot.2

1.26.8

v1.14.0-snapshot.3

1.26.9

v1.14.0-snapshot.4

1.26.10

v1.14.0-snapshot.5

1.26.9

v1.14.0-snapshot.6

1.26.10

v1.14.0

1.26.10

v1.14.1

1.26.10

v1.14.2

1.26.11

v1.14.3

1.26.11

v1.14.4

1.26.11

v1.14.5

1.26.11

v1.14.6

1.27.0

v1.14.7

1.27.0

v1.14

1.27.0

v1.15.0-pre.0

1.26.9

v1.15.0-pre.1

1.26.10

v1.15.0-pre.2

1.26.11

v1.15.0-pre.3

1.26.12

v1.15.0-rc.0

1.28.0

v1.15.0-rc.1

1.28.0

v1.15.0

1.28.1

v1.15.1

1.28.1

v1.15

1.28.1

latest / main

1.29.2