Skip to content

Commit

Permalink
docs: add docs for volumegroupreplication CR
Browse files Browse the repository at this point in the history
add docs for volumegroupreplication and volumegroupreplicationclass
CRs.

Signed-off-by: Nikhil-Ladha <nikhilladha1999@gmail.com>
  • Loading branch information
Nikhil-Ladha committed Jul 29, 2024
1 parent ca14f79 commit 4fd2e6a
Show file tree
Hide file tree
Showing 2 changed files with 62 additions and 0 deletions.
38 changes: 38 additions & 0 deletions docs/volumegroupreplication.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# VolumeGroupReplication

VolumeGroupReplication is a namespaced resource that contains references to storage object to be grouped and replicated, VolumeGroupReplicationClass corresponding to the driver providing replication, VolumeGroupContent and VolumeReplication CRs.

`volumeGroupReplicationClassName` is the name of the class providing group replication.

`volumeReplicationClassName` is the name of the class providing the replication for volumeReplication CR.

`volumeReplicationName` is the name of the volumeReplication CR created by this volumeGroupReplication CR

`volumeGroupReplicationContentName` is the name of the volumeGroupReplicationConten CR created by this volumeGroupReplication CR.

`replicationState` is the state of the volume being referenced. Possible values are `primary`, `secondary` and `resync`.

+ `primary` denotes that the volume is primary
+ `secondary` denotes that the volume is secondary
+ `resync` denotes that the volume needs to be resynced

`source` contains the source of the volumeGroupReplication i.e, the selectors to match the PVC/PVs to be replicated.

+ `selector` is a label selector to filter the pvcs that are to be included in the group replication


``` yaml
apiVersion: replication.storage.openshift.io/v1alpha1
kind: VolumeGroupReplication
metadata:
name: volumegroupreplication-sample
namespace: default
spec:
volumeReplicationClassName: volumereplicationclass-sample
volumeGroupReplicationClassName: volumegroupreplicationclass-sample
replicationState: primary
source:
selector:
matchLabels:
group: replication
```
24 changes: 24 additions & 0 deletions docs/volumegroupreplicationclass.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# VolumeGroupReplicationClass

`VolumeGroupReplicationClass` is a cluster scoped resource that contains driver related configuration parameters for volume group replication.

`provisioner` is name of the storage provisioner.

`parameters` contains key-value pairs that are passed down to the driver. Users can add their own key-value pairs. Keys with `replication.storage.openshift.io/` prefix are reserved by operator and not passed down to the driver.

## Reserved parameter keys

+ `replication.storage.openshift.io/group-replication-secret-name`
+ `replication.storage.openshift.io/group-replication-secret-namespace`

``` yaml
apiVersion: replication.storage.openshift.io/v1alpha1
kind: VolumeGroupReplicationClass
metadata:
name: volumegroupreplicationclass-sample
spec:
provisioner: example.provisioner.io
parameters:
replication.storage.openshift.io/group-replication-secret-name: secret-name
replication.storage.openshift.io/group-replication-secret-namespace: secret-namespace
```

0 comments on commit 4fd2e6a

Please sign in to comment.