OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

Kubernetes operator for OceanBase

V2.3.4Community 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

Document Feedback
  1. Documentation Center
  2. Kubernetes operator for OceanBase
  3. V2.3.4

Upgrade a cluster

Last Updated:2026-09-04 08:21:43

Prerequisites
Procedure
Modify the tag setting in spec

This topic describes how to upgrade an OceanBase cluster that is deployed by using ob-operator.

Prerequisites

Before you upgrade a cluster, make sure that the cluster is in the Running state.

Procedure

Modify the tag setting in spec

  1. Modify the configuration file of the OceanBase cluster. For more information about the complete configuration file, see Create a cluster. Change the value of the spec.observer.image parameter to the target image.

    # Before modification
    spec:
      observer:
        image: oceanbase/oceanbase-cloud-native:4.2.0.0-101000032023091319
    
    # After modification
    spec:
      observer:
        image: oceanbase/oceanbase-cloud-native:4.2.1.1-101000062023110109
    
  2. Run the following command for the modification to take effect:

    kubectl apply -f obcluster.yaml
    
  3. Query the status of custom resources in the OceanBase cluster to check whether the operation succeeds. Run the following command to query the status of custom resources in the OceanBase cluster. If the cluster is in the Running state and the value of the image parameter is the target image, the cluster is upgraded.

kubectl get obclusters.oceanbase.oceanbase.com test -n oceanbase -o yaml

# desired output, only displays status here
status:
  image: oceanbase/oceanbase-cloud-native:4.2.1.1-101000062023110109
  obzones:
  - status: running
    zone: obcluster-1-zone1
  - status: running
    zone: obcluster-1-zone2
  - status: running
    zone: obcluster-1-zone3
  parameters: []
  status: running

Previous topic

Delete OBServer nodes from zones
Last

Next topic

Manage parameters
Next
on this page
Prerequisites
Procedure
Modify the tag setting in spec