Merge pull request #753 from PureStorage-OpenConnect/mysql-demo

mysql consistent snap demo

Author: andrewh1978

assets/mysql/README.md

@@ -0,0 +1,91 @@
+## run a mysql application consistent snapshot demo
+
+#### 0. have px cluster up & running
+
+#### 1. apply mysql namespace & application
+
+```
+kubectl apply -f /assets/mysql/mysql.yml
+```
+
+#### 2. check for mysql pod readiness
+
+```
+kubectl wait --for=condition=ready pod -l app=mysql -n mysql
+```
+
+#### 3. apply demo data
+
+```
+POD=$(kubectl get pods -n mysql -l app=mysql -ojson | jq -r '.items[0].metadata.name')
+```
+
+```
+kubectl exec $POD -n mysql -it -- /bin/mysql -u mysql -psupermysql < /assets/mysql/sample-data.sql
+```
+
+#### 4. check for data within DB
+
+```
+kubectl exec $POD -n mysql -it -- /bin/mysql -u mysql -psupermysql pxdemo -e 'SELECT * FROM users'
+```
+
+#### 5. apply pre/post rules
+
+```
+kubectl apply -f /assets/mysql/px-mysql-pre-rule.yml
+
+kubectl apply -f /assets/mysql/px-mysql-post-rule.yml
+```
+
+#### 6. run snapshot
+
+```
+kubectl apply -f /assets/mysql/snapshot.yml
+```
+
+#### 7. validate snapshot
+
+```
+kubectl get volumesnapshot.volumesnapshot.external-storage.k8s.io/mysql-snap -n mysql -oyaml
+```
+
+(optionally follow stork pod logs)
+
+#### 8. delete table
+
+```
+kubectl exec $POD -n mysql -it -- /bin/mysql -u mysql -psupermysql pxdemo -e 'DROP TABLE users; SHOW TABLES'
+```
+
+#### 9. run snapshot restore
+
+```
+kubectl apply -f /assets/mysql/restore-snap.yml
+```
+
+check status
+
+```
+kubectl get volumesnapshotrestore.stork.libopenstorage.org/mysql-snap-inrestore -n mysql -o yaml
+```
+
+(wait for status successful)
+
+#### 10. validate data restore
+
+check for mysql pod readiness
+
+```
+kubectl wait --for=condition=ready pod -l app=mysql -n mysql
+```
+
+update pod name variable
+
+```
+POD=$(kubectl get pods -n mysql -l app=mysql -ojson | jq -r '.items[0].metadata.name')
+```
+
+```
+kubectl exec $POD -n mysql -it -- /bin/mysql -u mysql -psupermysql pxdemo -e 'SELECT * FROM users'
+```

assets/mysql/mysql.yml

@@ -1,7 +1,13 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: mysql
+---
 kind: PersistentVolumeClaim
 apiVersion: v1
 metadata:
    name: px-mysql-pvc
+   namespace: mysql
 spec:
    storageClassName: px-csi-db
    accessModes:
@@ -14,6 +20,7 @@ apiVersion: apps/v1
 kind: Deployment
 metadata:
   name: mysql
+  namespace: mysql
 spec:
   selector:
     matchLabels:
@@ -32,7 +39,7 @@ spec:
       schedulerName: stork
       containers:
       - name: mysql
-        image: mysql:5.7.33
+        image: mysql:9.2.0
         imagePullPolicy: "IfNotPresent"
         ports:
         - containerPort: 5432

assets/mysql/px-mysql-post-rule.yml

@@ -0,0 +1,11 @@
+apiVersion: stork.libopenstorage.org/v1alpha1
+kind: Rule
+metadata:
+  name: px-mysql-postsnap-rule
+  namespace: mysql
+rules:
+  - podSelector:
+      app: mysql
+    actions:
+    - type: command
+      value: mysql --user=root --password=$MYSQL_ROOT_PASSWORD -Bse 'FLUSH LOGS; UNLOCK TABLES;'

assets/mysql/px-mysql-pre-rule.yml

@@ -0,0 +1,13 @@
+apiVersion: stork.libopenstorage.org/v1alpha1
+kind: Rule
+metadata:
+  name: px-mysql-presnap-rule
+  namespace: mysql
+rules:
+  - podSelector:
+      app: mysql
+    actions:
+    - type: command
+      background: true
+      # this command will flush tables with read lock
+      value: mysql --system-command=ON --user=root --password=$MYSQL_ROOT_PASSWORD -Bse 'FLUSH TABLES WITH READ LOCK; SYSTEM ${WAIT_CMD};'

assets/mysql/restore-snap.yml

@@ -0,0 +1,9 @@
+#replace existing pv with snapshot
+apiVersion: stork.libopenstorage.org/v1alpha1
+kind: VolumeSnapshotRestore
+metadata:
+  name: mysql-snap-inrestore
+  namespace: mysql
+spec:
+  sourceName: mysql-snap
+  sourceNamespace: mysql

assets/mysql/sample-data.sql

@@ -0,0 +1,10 @@
+USE pxdemo;
+CREATE TABLE users (
+    id INT AUTO_INCREMENT PRIMARY KEY,
+    first_name VARCHAR(50),
+    last_name VARCHAR(50)
+);
+INSERT INTO users (first_name, last_name) VALUES 
+('Alice', 'Anderson'),
+('Bob', 'Barker'),
+('Charlie', 'Chaplin');

assets/mysql/snapshot.yml

@@ -0,0 +1,10 @@
+apiVersion: volumesnapshot.external-storage.k8s.io/v1
+kind: VolumeSnapshot
+metadata:
+  name: mysql-snap
+  namespace: mysql
+  annotations:
+    stork.rule/pre-snapshot: px-mysql-presnap-rule
+    stork.rule/post-snapshot: px-mysql-postsnap-rule
+spec:
+  persistentVolumeClaimName: px-mysql-pvc