Prerequisites and System Requirements
The Autonomous Operator supports several popular Kubernetes environments and cloud-native utilities.
To install the Couchbase Autonomous Operator, all you need is a Kubernetes or OpenShift cluster running one of the compatible versions listed below.
| For all supported software versions listed on this page, maintenance/patch releases (x.x.X) inherit the same support level, unless noted otherwise. |
Couchbase Compatibility
Couchbase compatibility falls under these 3 categories:
-
Unsupported: This combination is not tested and is not within the scope of technical support if you have purchased a support agreement.
-
Compatible: This combination has been tested previously and should be compatible. Our technical support organization does not recommend this combination. You may run the Operator Self-Certification Lifecycle tooling to verify the Operator will work on a compatible platform. We therefore highly encourage the use of a supported platform version.
-
Supported: This combination is subject to ongoing quality assurance and is fully supported by our technical support organization.
This release supports the deployment of the following Couchbase software:
| Software | Version |
|---|---|
Couchbase Server Enterprise Edition |
7.0 - 7.2* |
*: Couchbase Server 7.6 is supported with Operator 2.6; however, new features in 7.6 are only supported on Operator 2.7.0
The following diagram depicts Couchbase Server compatibility with the Operator for this, and previous releases, and can be used to calculate upgrade paths:
Couchbase Backup and Restore Compatibility
This release supports the following container images for managed backup and restore of Couchbase clusters:
| Container Image | Backup Utility | Backup From and Restore To |
|---|---|---|
Couchbase Server 7.0—7.2 |
The following diagram depicts Operator Backup image compatibility with all supported Couchbase Server versions, you should consider this when upgrading Couchbase Server:
Couchbase Fluent Bit Compatibility
This release supports the following versions of the Couchbase Fluent Bit image for log forwarding:
| Couchbase Operator Version | Supported Couchbase Fluent Bit Versions |
|---|---|
2.4.0 |
1.1.0 - 1.1.3, 1.2.0 - 1.2.7 |
2.5.0 |
1.2.0 - 1.2.7 |
2.6.0 |
1.2.0 - 1.2.7 |
2.7.0 |
1.2.0 - 1.2.8 |
Couchbase Exporter Compatibility
deprecated
This release is compatible with all versions of the Couchbase Exporter image. The Couchbase Exporter images are all compatible with all versions of Couchbase Server that are supported by this release.
|
With the release of Couchbase Server 7.0.0, Prometheus endpoints are built into Couchbase Server and as such, the exporter image is no longer required to expose metrics. |
Kubernetes Compatibility
This release supports the following Kubernetes platforms:
| Platform | Version |
|---|---|
Open Source Kubernetes |
1.26 - 1.31 |
Red Hat OpenShift Container Platform |
4.13 - 4.16 |
The following diagrams depict Couchbase Operator compatibility with Kubernetes and OpenShift platforms, and can be used to calculate upgrade paths:
|
Where an Operator release is marked as supported, this means it has been fully tested for functionality on that platform version. Couchbase Support will actively recreate and diagnose issues. Where relevant, fixes will be made to the affected product and patch releases made. Where an Operator release is marked as compatible however, this means it has been assessed by the development team to be technically feasible, and may have had rudimentary compatibility testing. You may run the Operator Self-Certification Lifecycle tooling to verify the Operator will work on a compatible platform. Support will be provided on a best-effort basis, and any issues may not result in fixes and patch releases. We therefore highly encourage the use of a supported platform version. |
Persistent Volume Compatibility
Persistent volumes are mandatory for production deployments. Review the Autonomous Operator best practices for more information about cluster supportability requirements.
Hardware Requirements
It is highly recommended that your Couchbase clusters are deployed with some form of compute and memory resource request in order to ensure fair scheduling of workloads and to ensure resources are available to meet basic service levels.
CPU and Memory Requirements
You can set all resource allocations yourself explicitly, however for new users to the platform we recommend using auto resource allocation. Auto resource allocation will require:
-
2 CPUs per Couchbase pod by default.
-
512MiB of memory per pod for each of the Data, Index, Search, and Eventing Services that are enabled. 1GiB of memory per pod if the the Analytics Service is enabled. An additional 25% memory overhead on top of the memory requirements for each service. For a typical development cluster where all services are enabled, this would equal 3.75GiB.
You can read more about pod scheduling in the best practices documentation.
Architecture requirements
The Autonomous Operator supports both ARM and AMD64 Kubernetes clusters. The architecture of each node must be uniform across the cluster as the use of mixed architecture nodes is not supported.
| The official Couchbase docker repository contains multi-arch images which do not require explicit references to architecture tags when being pulled and deployed. However, when pulling from a private repository, or performing intermediate processing on a machine with a different architecture than the deployed cluster, the use of explicit tags may be required to ensure the correct images are deployed. |
RBAC and Networking Requirements
Preparing the Kubernetes cluster to run the Operator may require setting up proper RBAC and network settings in your Kubernetes cluster. Before moving forward, review the following documentation:
Next Steps
As you’re setting up your Kubernetes environment, make sure that you’re following the recommended best practices.
Once your Kubernetes environment is set up, you can move on to installing the admission controller and the Operator.