Choose compatible Kubernetes operator and database cluster versions

Select a documentation version:

Each version of the AlloyDB Omni Kubernetes operator is compatible with specific database clusters. A database cluster consists of two components:

  • AlloyDB Omni database: The database that you use with the AlloyDB Omni Kubernetes operator. The recommended AlloyDB Omni database version is 18.3.0.

  • Control plane agents: Each database cluster uses multiple control plane agents, and every control plane agent in a database cluster uses the same version. Use the controlPlaneAgentsVersion parameter in the manifest file to specify the version of the control plane agents. The recommended control plane agent version is 1.8.2.

To learn how to upgrade the AlloyDB Omni Kubernetes operator, see Upgrade your AlloyDB Omni Kubernetes operator. The update process includes specifying versions of the database and control plane agents in your manifest file.

AlloyDB Omni Kubernetes operator version compatibility table

The following table lists the supported AlloyDB Omni Kubernetes operator versions and their compatible and recommended database cluster versions:

AlloyDB Omni Kubernetes operator version Database cluster components
Database version Control plane agent versions
1.8.2 (recommended) 18.3.0 1.8.0, 1.8.1, 1.8.2 (recommended)
17.9.0 1.8.0, 1.8.1, 1.8.2 (recommended)
16.13.0 1.8.0, 1.8.1, 1.8.2 (recommended)
15.17.0 1.8.0, 1.8.1, 1.8.2 (recommended)
18.1.0 1.7.0, 1.7.1
17.7.0 1.7.0, 1.7.1
16.11.0 1.7.0, 1.7.1
15.15.0 1.7.0, 1.7.1
17.5.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
16.9.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
15.13.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
1.8.1 18.3.0 1.8.0, 1.8.1
17.9.0 1.8.0, 1.8.1
16.13.0 1.8.0, 1.8.1
15.17.0 1.8.0, 1.8.1
18.1.0 1.7.0, 1.7.1
17.7.0 1.7.0, 1.7.1
16.11.0 1.7.0, 1.7.1
15.15.0 1.7.0, 1.7.1
17.5.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
16.9.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
15.13.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
1.8.0 18.3.0 1.8.0
17.9.0 1.8.0
16.13.0 1.8.0
15.17.0 1.8.0
18.1.0 1.7.0, 1.7.1
17.7.0 1.7.0, 1.7.1
16.11.0 1.7.0, 1.7.1
15.15.0 1.7.0, 1.7.1
17.5.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
16.9.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
15.13.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
1.7.1 18.1.0 1.7.0, 1.7.1
17.7.0 1.7.0, 1.7.1
16.11.0 1.7.0, 1.7.1
15.15.0 1.7.0, 1.7.1
17.5.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
16.9.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
15.13.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
1.7.0 18.1.0 1.7.0
17.7.0 1.7.0
16.11.0 1.7.0
15.15.0 1.7.0
17.5.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
16.9.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
15.13.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
1.6.3 17.5.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
16.9.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
15.13.0 1.6.0, 1.6.1, 1.6.2, 1.6.3
1.6.2 17.5.0 1.6.0, 1.6.1, 1.6.2
16.9.0 1.6.0, 1.6.1, 1.6.2
15.13.0 1.6.0, 1.6.1, 1.6.2
1.6.1 17.5.0 1.6.0, 1.6.1
16.9.0 1.6.0, 1.6.1
15.13.0 1.6.0, 1.6.1
1.6.0 17.5.0 1.6.0
16.9.0 1.6.0
15.13.0 1.6.0