OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

Kubernetes operator for OceanBase

V2.3.1Community Edition

  • Overview
  • Quick start
  • Deploy
  • Upgrade
  • User guide
    • Cluster management
      • Manage clusters
      • Create a cluster
      • Zone management
        • Add zones to a cluster
        • Delete zones from a cluster
      • Server management
        • Add OBServer nodes to zones
        • Delete OBServer nodes from zones
      • Upgrade a cluster
      • Manage parameters
      • Update resources
      • Delete a cluster
    • Tenant management
      • Manage tenants
      • Create a tenant
      • Modify tenant
        • Manage resources
        • Manage replicas
        • Modify other parameters
      • Delete a tenant
      • Perform tenant O&M operations
    • High availability
      • High availability
      • Recover from node failure
      • Back up a tenant
      • Restore data from a backup
      • Physical standby tenant
      • Inter K8s cluster management
  • Configure
  • Appendix
    • Deploy OceanBase Database and web app in a Kubernetes cluster
    • FAQ
  • Changelog

Download PDF

Overview Quick start Deploy Upgrade Manage clusters Create a cluster Upgrade a cluster Manage parameters Update resources Delete a cluster Manage tenants Create a tenant Delete a tenant Perform tenant O&M operations High availability Recover from node failure Back up a tenant Restore data from a backup Physical standby tenant Inter K8s cluster management Configure Deploy OceanBase Database and web app in a Kubernetes cluster FAQ Changelog
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. Kubernetes operator for OceanBase
  3. V2.3.1
iconKubernetes operator for OceanBase
V 2.3.1Community Edition
Community Edition
  • V 2.3.1
  • V 2.3.0
  • V 2.2.0
  • V 2.1.2
  • V 2.1.1
  • V 2.1.0

Changelog

Last Updated:2025-11-28 06:07:04  Updated
share
What is on this page
2.3.2 (Release on 2025.06.12)
New Feature
Bugfix
V2.3.1 (Release on 2024.11.28)
New Feature
Bugfix
Enhancement
V2.3.0 (Release on 2024.10.14)
New Features
Bug fixes
Optimization
V2.2.2 (Release on 2024.06.18)
New Features
Bug fixes
V2.2.1 (Released on 2024.05.15)
New features
Bug fixes
Optimization
V2.2.0 (Released on 2024.03.28)
New features
Bug fixes
Optimization
V2.1.2 (Released on 2024.01.24)
New features
Bug fixes
Optimization
V2.1.1 (Released on 2023.12.20)
New features
Bug fixes
Optimization
V2.1.0 (Released on 2023.11.20)
New features
Bug fixes
Optimization
V2.0.0 (Released on 2023.09.26)
New features

folded

share

2.3.2 (Release on 2025.06.12)

New Feature

Support to keep static IP address when using kube-ovn as network plugin

Bugfix

  • Fix connection problem when upgrading single node cluster.
  • Fix monitor password config problem when creating obcluster with obagent in multiple K8s clusters.

V2.3.1 (Release on 2024.11.28)

New Feature

Support tenant variable and parameter management.

Bugfix

  • Fix obagent deployment with service or standalone mode.
  • Fix sql execution failure when adding server to the cluster in certain scenario.

Enhancement

Add image and store config to the output of obcluster resource.

V2.3.0 (Release on 2024.10.14)

New Features

  • Support for scheduling OceanBase cluster across multiple K8s clusters.
  • Support for backing up to Tencent COS, AWS s3 and s3 compatible storage.
  • Support for deleting specific OBServer.
  • Support for optimizing parameters and variables by scenario.
  • Support for setting most of native fields of Pods to OBServer.

Bug fixes

Fixed the issue that it get stuck when a 2-2-2 cluster rolling replace its OBServer pods.

Optimization

Supplement several new types of OBTenantOperation to perform common operations like creating or deleting resource pools, setting unit number and so on.

V2.2.2 (Release on 2024.06.18)

New Features

  • Support for default storage class by leaving storageClass fields empty.
  • Support for pausing reconciling CRD through /pause-reconciling: "true" annotation. Which may become a solution of issue.
  • Support for changing storage class of running OBClusters.
  • New CRD OBClusterOperation for common operations of OBClusters.

Bug fixes

Fixed issue that cluster may get deactivated after being shrunk by half.

V2.2.1 (Released on 2024.05.15)

New features

  • Support for customizing configuration of ob-operator by setting environment variables.
  • Support for attaching backup volume after OceanBase cluster started if static ip is supported.
  • Support for deleting protection of important resources by adding annotation.
  • Support for migrating OceanBase cluster to be managed by ob-operator.

Bug fixes

  • Fixed issue when creating backup tenant across namespace.
  • Fixed issue when recover observer if OceanBase cluster is not accessible.

Optimization

  • Checked log storage volume fit OceanBase's requirement before actually create the cluster.
  • Optimized version check when creating OceanBase cluster in service mode.

V2.2.0 (Released on 2024.03.28)

New features

  • Support for binding static IP address of observer without depending on certain CNI by introducing the service mode of OBCluster.
  • Support for correcting Status of OceanBase related resources using delete, reset, skip and retry operations offered by CRD OBResourceRescue.
  • Support for expanding PVCs dynamically when the OBCluster is running.

Bug fixes

Fixed infinite retry when creating a tenant that requires resource (CPU, Memory etc.) more than available.

Optimization

  • Accelerated reconciliation when sub resource changes.
  • Exposed metrics of controller manager through prometheus standard interface.

V2.1.2 (Released on 2024.01.24)

New features

  • Support for creating OceanBase clusters in standalone mode by adding annotation "oceanbase.oceanbase.com/mode": "standalone".
  • Support for scaling cluster's resources (CPU and Memory) in place in standalone mode.
  • Support for binding single PVC with pods by setting annotation "oceanbase.oceanbase.com/single-pvc": "true".
  • Support for binding a service account with pods by configuring spec.serviceAccount for OBCluster.

Bug fixes

  • Fixed unexpected behavior when ob-operator restarts during observer recovery.
  • Avoided random deletion of OBServer when modifying OBZone replicas.

Optimization

  • Optimized task manager by adding token pool to limit maximum number of concurrent running tasks.
  • Optimized database connection pool by replacing sync.Map with expirable LRU cache.
  • Reduced required user credentials to create OBCluster. Automatically create credentials for user proxyro, monitor and operator if not specified.
  • Reduced required user credentials to create OBTenant. Automatically create credentials for user root and standbyro if not specified.
  • Ensured the deploying image is ready before the OceanBase cluster is actually created.

V2.1.1 (Released on 2023.12.20)

New features

  • Support for adding annotation oceanbase.oceanbase.com/independent-pvc-lifecycle to the OBCluster resource to make PVC remain after the OBCluster resource is deleted.
  • Support for tenant upgrade with the OBTenantOperation resource, which is a feature introduced since OceanBase Database V4.1.
  • Support for setting cluster parameters with optstr in startup command of observer.

Bug fixes

  • Fixed the issue of unrestricted memory consumption in some container runtimes by explicitly setting the memory_limit parameter.
  • Avoided long waits for changes to take effect when parameters are altered after cluster bootstraps by setting these parameters during startup.

Optimization

  • Reduced initial value of datafile_size and use incremental step to scale up when needed.
  • Enhanced resource validation, especially for OBCluster and OBTenant resources.

V2.1.0 (Released on 2023.11.20)

New features

  • Added toleration and affinity options to cluster parameters.
  • Support for restoring tenant and creating standby tenant from backup data.
  • The ARM image is now provided.

Bug fixes

  • Fixed issues that may be caused by concurrent writes to map.
  • Fixed the issue where expired database connections were used during tenant backup.
  • Fixed the issue of SQL syntax compatibility with OceanBase Database 4.2.1.

Optimization

  • Optimized failed task retry with backoff.
  • Added event logging and improved log outputs.

V2.0.0 (Released on 2023.09.26)

New features

  • Support OceanBase Cluster management.
  • Support Oceanbase Tenant management.
  • Support for monitoring OceanBase database with OBAgent.

Previous topic

FAQ
Last
What is on this page
2.3.2 (Release on 2025.06.12)
New Feature
Bugfix
V2.3.1 (Release on 2024.11.28)
New Feature
Bugfix
Enhancement
V2.3.0 (Release on 2024.10.14)
New Features
Bug fixes
Optimization
V2.2.2 (Release on 2024.06.18)
New Features
Bug fixes
V2.2.1 (Released on 2024.05.15)
New features
Bug fixes
Optimization
V2.2.0 (Released on 2024.03.28)
New features
Bug fixes
Optimization
V2.1.2 (Released on 2024.01.24)
New features
Bug fixes
Optimization
V2.1.1 (Released on 2023.12.20)
New features
Bug fixes
Optimization
V2.1.0 (Released on 2023.11.20)
New features
Bug fixes
Optimization
V2.0.0 (Released on 2023.09.26)
New features