Skip to content

Commit 9be01f7

Browse files
stuggiclaude
stuggi
and
claude
committed
[b/r] Add demo slide content and asciinema recording script
Slide content covering overview, architecture, and automation. Demo script with step-by-step commands and fast-forward notes for a 10-15 minute asciinema recording. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent ee259a3 commit 9be01f7

2 files changed

Lines changed: 225 additions & 0 deletions

File tree

‎docs/dev/backup-restore/demo/demo-script.md‎

Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
# RHOSO Backup & Restore - Demo Script
2+
3+
## Prerequisites
4+
- OpenStack control plane deployed and healthy
5+
- asciinema installed (`pip install asciinema`)
6+
7+
## Recording
8+
9+
```bash
10+
asciinema rec demo-backup-restore.cast -t "RHOSO Backup & Restore Demo"
11+
```
12+
13+
## Demo Flow
14+
15+
### 1. Show the environment (~1 min)
16+
17+
```bash
18+
# Show the healthy control plane
19+
oc get openstackcontrolplane -n openstack
20+
21+
# Show the OpenStackBackupConfig (auto-created by the operator)
22+
oc get openstackbackupconfig -n openstack
23+
24+
# Show labeled resources
25+
oc get secret -n openstack -l backup.openstack.org/restore=true --no-headers | wc -l
26+
oc get configmap -n openstack -l backup.openstack.org/restore=true --no-headers | wc -l
27+
28+
# Show labeled PVCs
29+
oc get pvc -n openstack -l backup.openstack.org/backup=true
30+
```
31+
32+
### 2. Install dependencies - MinIO & OADP (~2 min, FAST-FORWARD)
33+
34+
```bash
35+
cd docs/dev/backup-restore/role
36+
37+
# Install MinIO and OADP
38+
ansible-playbook cifmw_backup_restore_test.yaml \
39+
-e backup=false -e cleanup=false -e restore=false
40+
41+
# Show MinIO is running
42+
oc get pods -n minio
43+
oc get routes -n minio
44+
45+
# Show OADP is running
46+
oc get pods -n openshift-adp
47+
oc get backupstoragelocation -n openshift-adp
48+
```
49+
50+
### 3. Create backup (~3 min, FAST-FORWARD PVC backup wait)
51+
52+
```bash
53+
# Run backup
54+
ansible-playbook cifmw_backup_restore_test.yaml \
55+
-e install_deps=false -e cleanup=false -e restore=false
56+
57+
# Show the GaleraBackup CRs were created
58+
oc get galerabackup -n openstack
59+
60+
# Show the OADP backups
61+
oc get backup -n openshift-adp
62+
63+
# Note the backup timestamp for restore
64+
# e.g., 20260325-101234
65+
```
66+
67+
### 4. Simulate disaster - Cleanup (~1 min, FAST-FORWARD)
68+
69+
```bash
70+
# Delete the control plane (simulates disaster)
71+
ansible-playbook cifmw_backup_restore_test.yaml \
72+
-e install_deps=false -e backup=false -e restore=false
73+
74+
# Show everything is gone
75+
oc get openstackcontrolplane -n openstack
76+
oc get pods -n openstack
77+
oc get secret -n openstack | wc -l
78+
```
79+
80+
### 5. Restore (~5 min, FAST-FORWARD waits)
81+
82+
```bash
83+
# Restore from backup
84+
ansible-playbook cifmw_backup_restore_test.yaml \
85+
-e install_deps=false -e backup=false -e cleanup=false \
86+
-e backup_timestamp=<TIMESTAMP>
87+
88+
# --- FAST-FORWARD: PVC restore ---
89+
# --- FAST-FORWARD: Wait for infrastructure (infra-only annotation) ---
90+
# --- FAST-FORWARD: Wait for control plane ready ---
91+
# --- FAST-FORWARD: EDPM deployment ---
92+
```
93+
94+
### 6. Verify restored environment (~1 min)
95+
96+
```bash
97+
# Show control plane is back
98+
oc get openstackcontrolplane -n openstack
99+
100+
# Show pods are running
101+
oc get pods -n openstack | head -20
102+
103+
# Show databases are restored
104+
oc get galera -n openstack
105+
106+
# Show secrets are back
107+
oc get secret osp-secret -n openstack
108+
109+
# Verify an OpenStack endpoint
110+
oc exec -t openstackclient -- openstack endpoint list | head -10
111+
```
112+
113+
## Post-recording
114+
115+
```bash
116+
# Stop recording
117+
exit
118+
119+
# Play back (can use --speed for fast-forward sections)
120+
asciinema play demo-backup-restore.cast
121+
122+
# Upload (optional)
123+
asciinema upload demo-backup-restore.cast
124+
```
125+
126+
## Fast-forward tips
127+
128+
- Use `asciinema play --speed=10` for fast-forward sections during playback
129+
- Alternatively, edit the .cast file to compress wait times:
130+
- The .cast format is JSON lines with timestamps
131+
- Reduce large time gaps between lines to speed up boring sections
132+
- Or use `agg` to convert to GIF with speed adjustments
133+
134+
---

‎docs/dev/backup-restore/demo/slides.md‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
# RHOSO Backup & Restore - Slide Content
2+
3+
## Slide 1: Overview - What & Why
4+
5+
**Title: RHOSO Control Plane Backup & Restore**
6+
7+
- Full backup and restore of the OpenStack control plane on OpenShift
8+
- Covers: databases (Galera), Kubernetes resources (CRs, Secrets, ConfigMaps), persistent volumes
9+
- Uses OADP (OpenShift API for Data Protection) / Velero as the backup engine
10+
- CSI volume snapshots for PVC data (Galera dumps, other persistent data)
11+
- Goal: recover from catastrophic control plane failure or migrate between clusters
12+
13+
**Key points:**
14+
- Non-disruptive backup (no downtime during backup)
15+
- Ordered restore (dependencies respected: secrets -> infrastructure -> control plane)
16+
- Data plane nodes are untouched during backup/restore
17+
18+
---
19+
20+
## Slide 2: Architecture - How It Works
21+
22+
**Title: Architecture**
23+
24+
```
25+
+-------------------+ +-----------------+ +------------------+
26+
| OpenStackBackup- | | OADP / Velero | | S3 Storage |
27+
| Config Controller | | | | (MinIO/ODF/S3) |
28+
+--------+----------+ +--------+--------+ +--------+---------+
29+
| | |
30+
Labels resources Creates backups Stores backup
31+
for backup/restore (2 Backup CRs): data & CSI
32+
(secrets, configmaps, 1. PVCs (CSI snapshots) volume snapshots
33+
NADs, issuers) 2. Resources (CRs, etc.)
34+
| |
35+
+--------+----------+ +--------+--------+
36+
| GaleraBackup CRs | | Ordered Restore |
37+
| (mariadb-operator) | | (5 phases): |
38+
+-------------------+ | 00: PVCs |
39+
Defines backup config | 10: Secrets |
40+
(CronJobs); Jobs |
41+
before OADP backup | 20: Infra CRs |
42+
| 30: CtlPlane |
43+
| 40: BackupCfg |
44+
| 55: DB Restore |
45+
| 60: DataPlane |
46+
+-----------------+
47+
```
48+
49+
**Labeling responsibilities:**
50+
- **Operators** (e.g. glance-operator, mariadb-operator): label their own PVCs for backup at creation time
51+
- **BackupConfig controller**: labels user-provided resources (secrets, configmaps, NADs, issuers) that have no ownerReferences
52+
53+
**Backup flow:**
54+
1. GaleraBackup CRs define backup config; ad-hoc Jobs are triggered from the resulting CronJobs
55+
2. OADP Backup #1: CSI snapshots of labeled PVCs (includes fresh DB dumps)
56+
3. OADP Backup #2: All labeled Kubernetes resources
57+
58+
**Restore flow:**
59+
1. Ordered Velero Restores (PVCs -> Secrets -> Infrastructure -> ControlPlane)
60+
2. GaleraRestore CRs restore databases from dumps
61+
3. RabbitMQ credential restore (original credentials from backup)
62+
4. DataPlane restore and EDPM re-deployment
63+
64+
---
65+
66+
## Slide 3: Automation & CI Integration
67+
68+
**Title: Ansible Automation**
69+
70+
- Three independent Ansible roles:
71+
- `deploy_minio` - S3 storage backend (dev/test)
72+
- `openshift_adp` - OADP operator installation
73+
- `cifmw_backup_restore` - Backup/restore/cleanup lifecycle
74+
75+
- Single test playbook runs full end-to-end:
76+
```
77+
ansible-playbook cifmw_backup_restore_test.yaml
78+
```
79+
80+
- Each step independently controllable:
81+
```
82+
-e install_deps=false -e backup=false -e cleanup=false -e restore=true
83+
```
84+
85+
- Dynamic discovery: Galera instances and RabbitMQ clusters read from OpenStackControlPlane CR
86+
87+
- BackupConfig controller integrated into openstack-operator:
88+
- Auto-created with OpenStackControlPlane
89+
- Labels managed automatically, user can override via annotations
90+
91+
---

0 commit comments

Comments
 (0)