kubedb · Bonusree · Oct 15, 2025 · Oct 15, 2025 · Oct 17, 2025 · Oct 20, 2025
diff --git a/docs/examples/mariadb/restart/ops.yaml b/docs/examples/mariadb/restart/ops.yaml
@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: MariaDBOpsRequest
+metadata:
+  name: restart
+  namespace: demo
+spec:
+  type: Restart
+  databaseRef:
+    name: mariadb
+  timeout: 3m
+  apply: Always
diff --git a/docs/examples/mysql/restart/mysql.yaml b/docs/examples/mysql/restart/mysql.yaml
@@ -0,0 +1,18 @@
+apiVersion: kubedb.com/v1
+kind: MySQL
+metadata:
+  name: mysql
+  namespace: demo
+spec:
+  version: "8.2.0"
+  replicas: 3
+  topology:
+    mode: GroupReplication
+  storageType: Durable
+  storage:
+    accessModes:
+      - ReadWriteOnce
+    resources:
+      requests:
+        storage: 1Gi
+  deletionPolicy: WipeOut
diff --git a/docs/examples/mysql/restart/restart.yaml b/docs/examples/mysql/restart/restart.yaml
@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: MySQLOpsRequest
+metadata:
+  name: restart
+  namespace: demo
+spec:
+  type: Restart
+  databaseRef:
+    name: mysql
+  timeout: 3m
+  apply: Always
diff --git a/docs/examples/redis/restart/redis.yaml b/docs/examples/redis/restart/redis.yaml
@@ -0,0 +1,19 @@
+apiVersion: kubedb.com/v1
+kind: Redis
+metadata:
+  name: redis-cluster
+  namespace: demo
+spec:
+  version:  8.2.2
+  mode: Cluster
+  cluster:
+    replicas: 2
+  storageType: Durable
+  storage:
+    resources:
+      requests:
+        storage: 1Gi
+    storageClassName: local-path
+    accessModes:
+      - ReadWriteOnce
+  deletionPolicy: WipeOut
diff --git a/docs/examples/redis/restart/restart.yaml b/docs/examples/redis/restart/restart.yaml
@@ -0,0 +1,10 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: RedisOpsRequest
+metadata:
+  name: restart
+  namespace: demo
+spec:
+  type: Restart
+  databaseRef:
+    name: redis-cluster
+  apply: Always
diff --git a/docs/guides/mariadb/failover/guide.md b/docs/guides/mariadb/failover/guide.md
@@ -30,7 +30,7 @@ load balancing supported through `MariaDB MaxScale Server`.
 
 >note: Writing to a slave replica may result in a binary log (binlog) conflict issue.
 
-- **Galera Cluster (Multi-`Master`):**
+- **Galera Cluster (Multi-Master):**
 In this setup, all nodes act as `Master`, capable of handling both read and write operations. Since there’s
 no single point of failure, the system provides synchronous replication and built-in high availability, 
 but doesn’t use the traditional failover concept, as all pods are equal.

diff --git a/docs/guides/mariadb/restart/_index.md b/docs/guides/mariadb/restart/_index.md
@@ -0,0 +1,11 @@
+---
+title: Restart
+menu:
+  docs_{{ .version }}:
+    identifier: mariadb-restart-details
+    name: Restart
+    parent: guides-mariadb
+    weight: 47
+menu_name: docs_{{ .version }}
+section_menu_id: guides
+---
diff --git a/docs/guides/mariadb/restart/restart.md b/docs/guides/mariadb/restart/restart.md
@@ -0,0 +1,197 @@
+---
+title: Restart MariaDB
+menu:
+  docs_{{ .version }}:
+    identifier: mariadb-restart
+    name: Restart MariaDB
+    parent: mariadb-restart-details
+    weight: 10
+menu_name: docs_{{ .version }}
+section_menu_id: guides
+---
+
+> New to KubeDB? Please start [here](/docs/README.md).
+
+# Restart MariaDB
+
+KubeDB supports restarting the MariaDB database via a `MariaDBOpsRequest`. Restarting is useful if some pods are got stuck in some phase, or they are not working correctly. This tutorial will show you how to use that.
+
+## Before You Begin
+
+- At first, you need to have a Kubernetes cluster, and the kubectl command-line tool must be configured to communicate with your cluster. If you do not already have a cluster, you can create one by using [kind](https://kind.sigs.k8s.io/docs/user/quick-start/).
+
+- Now, install KubeDB cli on your workstation and KubeDB operator in your cluster following the steps [here](/docs/setup/README.md).
+
+- To keep things isolated, this tutorial uses a separate namespace called `demo` throughout this tutorial.
+
+```bash
+  $ kubectl create ns demo
+  namespace/demo created
+```
+
+> Note: YAML files used in this tutorial are stored in [docs/examples/MariaDB](https://github.com/kubedb/docs/tree/{{< param "info.version" >}}/docs/examples/mariadb) folder in GitHub repository [kubedb/docs](https://github.com/kubedb/docs).
+
+## Deploy MariaDB
+
+In this section, we are going to deploy a MariaDB database using KubeDB.
+
+```yaml
+apiVersion: kubedb.com/v1
+kind: MariaDB
+metadata:
+  name: mariadb
+  namespace: demo
+spec:
+  version: "10.5.23"
+  replicas: 3
+  storageType: Durable
+  storage:
+    storageClassName: local-path
+    accessModes:
+      - ReadWriteOnce
+    resources:
+      requests:
+        storage: 1Gi
+  deletionPolicy: WipeOut
+```
+
+Let's create the `MariaDB` CR we have shown above,
+
+```bash
+$ kubectl create -f https://github.com/kubedb/docs/raw/{{< param "info.version" >}}/docs/examples/MariaDB/restart/MariaDB.yaml
+MariaDB.kubedb.com/mariadb created
+```
+
+## Apply Restart opsRequest
+
+```yaml
+apiVersion: ops.kubedb.com/v1alpha1
+kind: MariaDBOpsRequest
+metadata:
+  name: restart
+  namespace: demo
+spec:
+  type: Restart
+  databaseRef:
+    name: mariadb
+  timeout: 3m
+  apply: Always
+```
+
+- `spec.type` specifies the Type of the ops Request
+- `spec.databaseRef` holds the name of the MariaDB database.  The db should be available in the same namespace as the opsRequest
+- The `spec.timeout` field specifies the maximum amount of time the operator will wait for the operation to complete before marking it as failed. 
+- The `spec.apply` field determines whether the operation should always be applied (Always) or only when there are changes (IfReady).
+
+
+> Note: The method of restarting the standalone & cluster mode db is exactly same as above. All you need, is to specify the corresponding Postgres name in `spec.databaseRef.name` section.
+
+Let's create the `PostgresOpsRequest` CR we have shown above,
+
+
+```bash
+$ kubectl create -f https://github.com/kubedb/docs/raw/{{< param "info.version" >}}/docs/examples/mariadb/restart/ops.yaml
+MariaDBopsrequest.ops.kubedb.com/restart created
+```
+
+In `MariaDB`, all pods act as primary, so the Ops-manager operator will restart the pods one by one in sequence.
+> Note: This will not restart the arbiter pod if you have one. Arbiter pod doesn't have any data related to your database. So you can ignore restarting this pod because no restart is necessary for arbiter pod but if you want so, just kubectl delete the arbiter pod (dbName-arbiter-0) in order to restart it.
+
+```shell
+$ kubectl get mariaops -n demo restart 
+NAME      TYPE      STATUS       AGE
+restart   Restart   Successful   3m25s
+
+
+$ kubectl get mariaops -n demo restart -oyaml
+kubectl get mariaops -n demo restart -oyaml
+apiVersion: ops.kubedb.com/v1alpha1
+kind: MariaDBOpsRequest
+metadata:
+  annotations:
+    kubectl.kubernetes.io/last-applied-configuration: |
+      {"apiVersion":"ops.kubedb.com/v1alpha1","kind":"MariaDBOpsRequest","metadata":{"annotations":{},"name":"restart","namespace":"demo"},"spec":{"apply":"Always","databaseRef":{"name":"mariadb"},"timeout":"3m","type":"Restart"}}
+  creationTimestamp: "2025-10-14T12:31:09Z"
+  generation: 1
+  name: restart
+  namespace: demo
+  resourceVersion: "1004302"
+  uid: 4e135330-46c4-41cd-aff6-bf2ddb018911
+spec:
+  apply: Always
+  databaseRef:
+    name: mariadb
+  timeout: 3m
+  type: Restart
+status:
+  conditions:
+  - lastTransitionTime: "2025-10-14T12:31:09Z"
+    message: 'Controller has started to Progress the MariaDBOpsRequest: demo/restart'
+    observedGeneration: 1
+    reason: Running
+    status: "True"
+    type: Running
+  - lastTransitionTime: "2025-10-14T12:31:17Z"
+    message: evict pod; ConditionStatus:True; PodName:mariadb-0
+    observedGeneration: 1
+    status: "True"
+    type: EvictPod--mariadb-0
+  - lastTransitionTime: "2025-10-14T12:31:17Z"
+    message: get pod; ConditionStatus:True; PodName:mariadb-0
+    observedGeneration: 1
+    status: "True"
+    type: GetPod--mariadb-0
+  - lastTransitionTime: "2025-10-14T12:32:27Z"
+    message: evict pod; ConditionStatus:True; PodName:mariadb-1
+    observedGeneration: 1
+    status: "True"
+    type: EvictPod--mariadb-1
+  - lastTransitionTime: "2025-10-14T12:32:27Z"
+    message: get pod; ConditionStatus:True; PodName:mariadb-1
+    observedGeneration: 1
+    status: "True"
+    type: GetPod--mariadb-1
+  - lastTransitionTime: "2025-10-14T12:33:37Z"
+    message: evict pod; ConditionStatus:True; PodName:mariadb-2
+    observedGeneration: 1
+    status: "True"
+    type: EvictPod--mariadb-2
+  - lastTransitionTime: "2025-10-14T12:33:37Z"
+    message: get pod; ConditionStatus:True; PodName:mariadb-2
+    observedGeneration: 1
+    status: "True"
+    type: GetPod--mariadb-2
+  - lastTransitionTime: "2025-10-14T12:34:47Z"
+    message: 'Successfully started MariaDB pods for MariaDBOpsRequest: demo/restart '
+    observedGeneration: 1
+    reason: RestartPodsSucceeded
+    status: "True"
+    type: Restart
+  - lastTransitionTime: "2025-10-14T12:34:47Z"
+    message: Controller has successfully restart the MariaDB replicas
+    observedGeneration: 1
+    reason: Successful
+    status: "True"
+    type: Successful
+  observedGeneration: 1
+  phase: Successful
+
+```
+
+
+## Cleaning up
+
+To clean up the Kubernetes resources created by this tutorial, run:
+
+```bash
+kubectl delete  mariaops -n demo restart
+kubectl delete mariadb -n demo mariadb
+kubectl delete ns demo
+```
+
+## Next Steps
+
+- Learn about [backup and restore](/docs/guides/mariadb/backup/kubestash/overview/index.md) MariaDBQL database using Stash.
+- Learn about initializing [MariaDBQL with Script](/docs/guides/mariadb/initialization/using-script/index.md)
+- Detail concepts of [MariaDB object](/docs/guides/mariadb/concepts/mariadb/index.md).
+- Want to hack on KubeDB? Check our [contribution guidelines](/docs/CONTRIBUTING.md).
diff --git a/docs/guides/mysql/autoscaler/_index.md b/docs/guides/mysql/autoscaler/_index.md
@@ -5,6 +5,6 @@ menu:
     identifier: guides-mysql-autoscaling
     name: Autoscaling
     parent: guides-mysql
-    weight: 47
+    weight: 190
 menu_name: docs_{{ .version }}
 ---
diff --git a/docs/guides/mysql/cli/index.md b/docs/guides/mysql/cli/index.md
@@ -5,7 +5,7 @@ menu:
     identifier: guides-mysql-cli
     name: CLI
     parent: guides-mysql
-    weight: 100
+    weight: 230
 menu_name: docs_{{ .version }}
 section_menu_id: guides
 ---

diff --git a/docs/guides/mysql/clients/index.md b/docs/guides/mysql/clients/index.md
@@ -5,7 +5,7 @@ menu:
     identifier: guides-mysql-clients
     name: Connecting to a MySQL Cluster
     parent: guides-mysql
-    weight: 105
+    weight: 240
 menu_name: docs_{{ .version }}
 section_menu_id: guides
 ---

diff --git a/docs/guides/mysql/clustering/_index.md b/docs/guides/mysql/clustering/_index.md
@@ -5,6 +5,6 @@ menu:
     identifier: guides-mysql-clustering
     name: MySQL Clustering
     parent: guides-mysql
-    weight: 25
+    weight: 30
 menu_name: docs_{{ .version }}
 ---
diff --git a/docs/guides/mysql/configuration/_index.md b/docs/guides/mysql/configuration/_index.md
@@ -5,6 +5,6 @@ menu:
     identifier: guides-mysql-configuration
     name: Custom Configuration
     parent: guides-mysql
-    weight: 30
+    weight: 50
 menu_name: docs_{{ .version }}
 ---
diff --git a/docs/guides/mysql/custom-rbac/index.md b/docs/guides/mysql/custom-rbac/index.md
@@ -5,7 +5,7 @@ menu:
     identifier: guides-mysql-custom-rbac
     name: Custom RBAC
     parent: guides-mysql
-    weight: 31
+    weight: 60
 menu_name: docs_{{ .version }}
 section_menu_id: guides
 ---

diff --git a/docs/guides/mysql/failure-and-disaster-recovery/_index.md b/docs/guides/mysql/failure-and-disaster-recovery/_index.md
@@ -5,6 +5,6 @@ menu:
     identifier: guides-mysql-failure-and-disaster-recovery
     name: Failure and DR Scenarios
     parent: guides-mysql
-    weight: 27
+    weight: 40
 menu_name: docs_{{ .version }}
 ---
diff --git a/docs/guides/mysql/initialization/index.md b/docs/guides/mysql/initialization/index.md
@@ -5,7 +5,7 @@ menu:
     identifier: guides-mysql-initialization
     name: Initialization Using Script
     parent: guides-mysql
-    weight: 41
+    weight: 110
 menu_name: docs_{{ .version }}
 section_menu_id: guides
 ---

diff --git a/docs/guides/mysql/migration/_index.md b/docs/guides/mysql/migration/_index.md
@@ -5,6 +5,6 @@ menu:
     identifier: guides-mysql-migration
     name: Migration
     parent: guides-mysql
-    weight: 43
+    weight: 130
 menu_name: docs_{{ .version }}
 ---
diff --git a/docs/guides/mysql/monitoring/_index.md b/docs/guides/mysql/monitoring/_index.md
@@ -5,6 +5,6 @@ menu:
     identifier: guides-mysql-monitoring
     name: Monitoring
     parent: guides-mysql
-    weight: 50
+    weight: 210
 menu_name: docs_{{ .version }}
 ---
diff --git a/docs/guides/mysql/pitr/_index.md b/docs/guides/mysql/pitr/_index.md
@@ -5,6 +5,6 @@ menu:
     identifier: pitr-mysql
     name: Point-in-time Recovery
     parent: guides-mysql
-    weight: 42
+    weight: 85
 menu_name: docs_{{ .version }}
 ---
diff --git a/docs/guides/mysql/private-registry/index.md b/docs/guides/mysql/private-registry/index.md
@@ -5,7 +5,7 @@ menu:
     identifier: guides-mysql-private-registry
     name: Private Registry
     parent: guides-mysql
-    weight: 35
+    weight: 70
 menu_name: docs_{{ .version }}
 section_menu_id: guides
 ---