KubeBlocks
BlogsEnterprise
⌘K
​
Blogs
Data Guard · Operator-Based

KubeBlocks Oracle Operator for Kubernetes

Run Oracle Data Guard on Kubernetes with operator-managed topology, failover orchestration, RMAN backup and restore, and Day-2 operations — scaling, switchover, and parameter tuning through KubeBlocks.

Enterprise Edition Only — The Oracle addon is not available in the open-source KubeBlocks distribution. A KubeBlocks Enterprise license is required to deploy and manage Oracle clusters. Get Enterprise →

Enterprise (On-Prem DBaaS) →
DG

HA Topology

FSFO

Failover Model

RMAN

Backup Engine

Deploy Oracle in 2 steps

1

Install KubeBlocks and Oracle addon

Contact us to get access → kubeblocks.com/contact

2

Create an Oracle Data Guard cluster

apiVersion: apps.kubeblocks.io/v1
kind: Cluster
metadata:
  name: oracle-cluster
  namespace: demo
spec:
  clusterDef: oracle
  topology: oracle
  terminationPolicy: Delete
  componentSpecs:
    - name: oracle
      componentDef: oracle-12c
      serviceVersion: "12.2.0"
      replicas: 2
      volumeClaimTemplates:
        - name: data
          spec:
            accessModes:
              - ReadWriteOnce
            resources:
              requests:
                storage: 20Gi
    - name: observer
      componentDef: oracle-observer-12c
      replicas: 1

Trusted by Engineering Teams at Scale

BONC CloudBONC Cloud
China Mobile CloudChina Mobile Cloud
China Telecom CloudChina Telecom Cloud
TencentTencent
XiaomiXiaomi
Ping AnPing An
VIP.comVIP.com
KwaiKwai
Tiger BrokersTiger Brokers
CITIC SecuritiesCITIC Securities
SealOSSealOS
FastGPTFastGPT
KubeSphereKubeSphere
MomentaMomenta
360360
TilaaTilaa
OlaresOlares
Changan AutomobileChangan Automobile
State GridState Grid
BONC CloudBONC Cloud
China Mobile CloudChina Mobile Cloud
China Telecom CloudChina Telecom Cloud
TencentTencent
XiaomiXiaomi
Ping AnPing An
VIP.comVIP.com
KwaiKwai
Tiger BrokersTiger Brokers
CITIC SecuritiesCITIC Securities
SealOSSealOS
FastGPTFastGPT
KubeSphereKubeSphere
MomentaMomenta
360360
TilaaTilaa
OlaresOlares
Changan AutomobileChangan Automobile
State GridState Grid
Oracle Topology

Data Guard first. Failover kept operator-native.

The current Oracle addon scope is centered on Oracle Data Guard. KubeBlocks manages the Oracle and observer components together so failover, role tracking, and Day-2 workflows stay inside one control plane.

The current Oracle addon topology centers on one Data Guard cluster with Oracle database instances and separate observer components under KubeBlocks management. Oracle carries the primary and standby roles; observers watch cluster state and participate in Fast-Start Failover decisions so role transitions and Day-2 actions — failover, scaling, backup, and parameter changes — are all handled through KubeBlocks APIs.

Oracle Data Guard with one primary and multiple standby instances under KubeBlocks management

Observer components coordinate failover behavior for the DG topology

Role-aware management keeps primary and standby operational flows explicit

Fast-Start Failover support promotes a standby when the primary becomes unavailable

Primary/standby behavior is surfaced through KubeBlocks abstractions instead of hand-managed scripts

`oracle-rman` handles full backup and restore workflows through KubeBlocks APIs

Access & Operations
Application Traffic
Business traffic stays on the current primary Oracle instance managed by KubeBlocks.
Primary Path
Operator Workflows
Switchover, failover, reconfiguring, and restore are driven through KubeBlocks operations.
Control Plane
role tracking and failover orchestration through Data Guard + observers
Oracle Data Guard · 1 Primary + 2 Standbys
oracle-0Primary
Read/Write database role
Current production node
oracle-1Standby
Data Guard standby role
Promotion target during failover
oracle-2Standby
Data Guard standby role
Additional protection replica
⬡Oracle Data Guard + FSFOObserver components monitor role state and help trigger automatic standby promotion when the primary becomes unavailable.
Observer & Backup
observer-0 / observer-1
Independent observer components watch the DG cluster and participate in failover decisions.
Observers
oracle-rman
Current visible backup path is RMAN-based full backup and restore integrated with KubeBlocks workflows.
Backup
Oracle Data Guard cluster
Primary role
Standby / Observer / Backup
Day-2 Operations

Backup, restore, switchover, and scaling — all via Kubernetes-native APIs.

Manage the full Oracle lifecycle with standard KubeBlocks operations: on-demand backup and restore, manual or automatic failover, vertical scaling, and live parameter tuning.

High Availability

Data Guard Roles

KubeBlocks tracks primary and standby roles for operational workflows.

Fast-Start Failover

Supports automatic standby promotion when the primary becomes unavailable.

Observer Coordination

Observer components participate in DG failover coordination.

Switchover / Failover

Role transitions are exposed as KubeBlocks-managed operational actions.

Day-2 Operations

Cluster Creation

Creates Oracle and observer components through one cluster workflow.

Vertical Scaling

Adjust CPU and memory allocation for Oracle components.

Volume Expansion

Expand persistent volumes for Oracle data storage.

Parameter Changes

Apply Oracle parameter changes through KubeBlocks configuration workflows.

RMAN Backup / Restore

Use `oracle-rman` for full backup and restore through KubeBlocks APIs.

Capabilities

Built for Oracle on Kubernetes

KubeBlocks automates the hardest parts of running Oracle Data Guard on Kubernetes — failover orchestration, Day-2 operations, and RMAN backup.

🛡️
Oracle Data Guard FSFO Automatic Failover
KubeBlocks manages observer components alongside Oracle instances. When the primary becomes unavailable, Fast-Start Failover promotes a standby and updates the operational role state — no manual scripts required.
FSFO Enabled
T+0s — Normal
Healthy
oracle-0
Primary
oracle-1
Standby
observer-0
Observer
T+1s — Failure
Node Down
oracle-0
Failed
oracle-1
Standby
observer-0
Detecting
T+10s — Promote
Promoting
oracle-0
Unreachable
oracle-1
Promoting…
observer-0
Coordinating
T+30s — Recovered
Healthy
oracle-0
Rejoining
oracle-1
Primary ★
observer-0
Observer
FSFO
Failover Mode
0
Manual Steps
DG
HA Technology
No manual intervention. Observer components coordinate FSFO; standby promotion and role state updates are handled via KubeBlocks APIs — no hand-managed scripts.
From the Blog

Go deeper on Oracle on Kubernetes

KubeBlocks x Oracle: Operator-Based DG Deployment and Management Guide

KubeBlocks x Oracle: Operator-Based DG Deployment and Management Guide

A deep dive into Oracle Data Guard on Kubernetes, including topology design, failover handling, RMAN backup, and addon implementation details.

Oracle Data Guard on Kubernetes. Operator-managed.

Deploy Oracle Data Guard on Kubernetes with automated failover, RMAN backup and restore, and full Day-2 lifecycle management — powered by KubeBlocks.

Requires KubeBlocks Enterprise License

Get Enterprise →

© 2026 KUBEBLOCKS INC