mirror of
https://github.com/TECHNOFAB11/zfs-localpv.git
synced 2025-12-12 06:20:11 +01:00
This commits support snapshot and clone commands via CSI driver. User can create snap and clone using the following steps.
Note:
- Snapshot is created via reconciliation CR
- Cloned volume will be on the same zpool where the snapshot is taken
- Cloned volume will have same properties as source volume.
-----------------------------------
Create a Snapshotclass
```
kind: VolumeSnapshotClass
apiVersion: snapshot.storage.k8s.io/v1beta1
metadata:
name: zfspv-snapclass
annotations:
snapshot.storage.kubernetes.io/is-default-class: "true"
driver: zfs.csi.openebs.io
deletionPolicy: Delete
```
Once snapshotclass is created, we can use this class to create a Snapshot
```
apiVersion: snapshot.storage.k8s.io/v1beta1
kind: VolumeSnapshot
metadata:
name: zfspv-snap
spec:
volumeSnapshotClassName: zfspv-snapclass
source:
persistentVolumeClaimName: csi-zfspv
```
```
$ kubectl get volumesnapshot
NAME AGE
zfspv-snap 7m52s
```
```
$ kubectl get volumesnapshot -o yaml
apiVersion: v1
items:
- apiVersion: snapshot.storage.k8s.io/v1beta1
kind: VolumeSnapshot
metadata:
annotations:
kubectl.kubernetes.io/last-applied-configuration: |
{"apiVersion":"snapshot.storage.k8s.io/v1beta1","kind":"VolumeSnapshot","metadata":{"annotations":{},"name":"zfspv-snap","namespace":"default"},"spec":{"source":{"persistentVolumeClaimName":"csi-zfspv"},"volumeSnapshotClassName":"zfspv-snapclass"}}
creationTimestamp: "2020-01-30T10:31:24Z"
finalizers:
- snapshot.storage.kubernetes.io/volumesnapshot-as-source-protection
- snapshot.storage.kubernetes.io/volumesnapshot-bound-protection
generation: 1
name: zfspv-snap
namespace: default
resourceVersion: "30040"
selfLink: /apis/snapshot.storage.k8s.io/v1beta1/namespaces/default/volumesnapshots/zfspv-snap
uid: 1a5cf166-c599-4f58-9f3c-f1148be47fca
spec:
source:
persistentVolumeClaimName: csi-zfspv
volumeSnapshotClassName: zfspv-snapclass
status:
boundVolumeSnapshotContentName: snapcontent-1a5cf166-c599-4f58-9f3c-f1148be47fca
creationTime: "2020-01-30T10:31:24Z"
readyToUse: true
restoreSize: "0"
kind: List
metadata:
resourceVersion: ""
selfLink: ""
```
Openebs resource for the created snapshot
```
$ kubectl get snap -n openebs -o yaml
apiVersion: v1
items:
- apiVersion: openebs.io/v1alpha1
kind: ZFSSnapshot
metadata:
creationTimestamp: "2020-01-30T10:31:24Z"
finalizers:
- zfs.openebs.io/finalizer
generation: 2
labels:
kubernetes.io/nodename: pawan-2
openebs.io/persistent-volume: pvc-18cab7c3-ec5e-4264-8507-e6f7df4c789a
name: snapshot-1a5cf166-c599-4f58-9f3c-f1148be47fca
namespace: openebs
resourceVersion: "30035"
selfLink: /apis/openebs.io/v1alpha1/namespaces/openebs/zfssnapshots/snapshot-1a5cf166-c599-4f58-9f3c-f1148be47fca
uid: e29d571c-42b5-4fb7-9110-e1cfc9b96641
spec:
capacity: "4294967296"
fsType: zfs
ownerNodeID: pawan-2
poolName: zfspv-pool
status: Ready
volumeType: DATASET
kind: List
metadata:
resourceVersion: ""
selfLink: ""
```
Create a clone volume
We can provide a datasource as snapshot name to create a clone volume
```yaml
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
name: zfspv-clone
spec:
storageClassName: openebs-zfspv
dataSource:
name: zfspv-snap
kind: VolumeSnapshot
apiGroup: snapshot.storage.k8s.io
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 4Gi
```
It will create a ZFS clone volume from the mentioned snapshot and create the PV on the same node where original volume is there.
Here, As resize is not supported yet, the clone PVC size should match the size of the snapshot.
Also, all the properties from the storageclass will not be considered for the clone case, it will take the properties from the snapshot and create the clone volume. One thing to note here is that, the storageclass in clone PVC should have the same poolname as that of the original volume as across the pool, clone is not supported.
Signed-off-by: Pawan <pawan@mayadata.io>
232 lines
5.4 KiB
Go
232 lines
5.4 KiB
Go
/*
|
|
Copyright 2019 The OpenEBS Authors
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
package volbuilder
|
|
|
|
import (
|
|
apis "github.com/openebs/zfs-localpv/pkg/apis/openebs.io/core/v1alpha1"
|
|
"github.com/openebs/zfs-localpv/pkg/common/errors"
|
|
)
|
|
|
|
// Builder is the builder object for ZFSVolume
|
|
type Builder struct {
|
|
volume *ZFSVolume
|
|
errs []error
|
|
}
|
|
|
|
// NewBuilder returns new instance of Builder
|
|
func NewBuilder() *Builder {
|
|
return &Builder{
|
|
volume: &ZFSVolume{
|
|
Object: &apis.ZFSVolume{},
|
|
},
|
|
}
|
|
}
|
|
|
|
// BuildFrom returns new instance of Builder
|
|
// from the provided api instance
|
|
func BuildFrom(volume *apis.ZFSVolume) *Builder {
|
|
if volume == nil {
|
|
b := NewBuilder()
|
|
b.errs = append(
|
|
b.errs,
|
|
errors.New("failed to build volume object: nil volume"),
|
|
)
|
|
return b
|
|
}
|
|
return &Builder{
|
|
volume: &ZFSVolume{
|
|
Object: volume,
|
|
},
|
|
}
|
|
}
|
|
|
|
// WithNamespace sets the namespace of ZFSVolume
|
|
func (b *Builder) WithNamespace(namespace string) *Builder {
|
|
if namespace == "" {
|
|
b.errs = append(
|
|
b.errs,
|
|
errors.New(
|
|
"failed to build zfs volume object: missing namespace",
|
|
),
|
|
)
|
|
return b
|
|
}
|
|
b.volume.Object.Namespace = namespace
|
|
return b
|
|
}
|
|
|
|
// WithName sets the name of ZFSVolume
|
|
func (b *Builder) WithName(name string) *Builder {
|
|
if name == "" {
|
|
b.errs = append(
|
|
b.errs,
|
|
errors.New(
|
|
"failed to build zfs volume object: missing name",
|
|
),
|
|
)
|
|
return b
|
|
}
|
|
b.volume.Object.Name = name
|
|
return b
|
|
}
|
|
|
|
// WithCapacity sets the Capacity of zfs volume by converting string
|
|
// capacity into Quantity
|
|
func (b *Builder) WithCapacity(capacity string) *Builder {
|
|
if capacity == "" {
|
|
b.errs = append(
|
|
b.errs,
|
|
errors.New(
|
|
"failed to build zfs volume object: missing capacity",
|
|
),
|
|
)
|
|
return b
|
|
}
|
|
b.volume.Object.Spec.Capacity = capacity
|
|
return b
|
|
}
|
|
|
|
// WithEncryption sets the encryption on ZFSVolume
|
|
func (b *Builder) WithEncryption(encr string) *Builder {
|
|
b.volume.Object.Spec.Encryption = encr
|
|
return b
|
|
}
|
|
|
|
// WithKeyLocation sets the encryption key location on ZFSVolume
|
|
func (b *Builder) WithKeyLocation(kl string) *Builder {
|
|
b.volume.Object.Spec.KeyLocation = kl
|
|
return b
|
|
}
|
|
|
|
// WithKeyFormat sets the encryption key format on ZFSVolume
|
|
func (b *Builder) WithKeyFormat(kf string) *Builder {
|
|
b.volume.Object.Spec.KeyFormat = kf
|
|
return b
|
|
}
|
|
|
|
// WithCompression sets compression of ZFSVolume
|
|
func (b *Builder) WithCompression(compression string) *Builder {
|
|
b.volume.Object.Spec.Compression = compression
|
|
return b
|
|
}
|
|
|
|
// WithDedup sets dedup property of ZFSVolume
|
|
func (b *Builder) WithDedup(dedup string) *Builder {
|
|
b.volume.Object.Spec.Dedup = dedup
|
|
return b
|
|
}
|
|
|
|
// WithThinProv sets if ZFSVolume needs to be thin provisioned
|
|
func (b *Builder) WithThinProv(thinprov string) *Builder {
|
|
b.volume.Object.Spec.ThinProvision = thinprov
|
|
return b
|
|
}
|
|
|
|
// WithOwnerNode sets owner node for the ZFSVolume where the volume should be provisioned
|
|
func (b *Builder) WithOwnerNode(host string) *Builder {
|
|
b.volume.Object.Spec.OwnerNodeID = host
|
|
return b
|
|
}
|
|
|
|
// WithRecordSize sets the recordsize of ZFSVolume
|
|
func (b *Builder) WithRecordSize(rs string) *Builder {
|
|
b.volume.Object.Spec.RecordSize = rs
|
|
return b
|
|
}
|
|
|
|
// WithVolBlockSize sets the volblocksize of ZFSVolume
|
|
func (b *Builder) WithVolBlockSize(bs string) *Builder {
|
|
b.volume.Object.Spec.VolBlockSize = bs
|
|
return b
|
|
}
|
|
|
|
// WithVolumeType sets if ZFSVolume needs to be thin provisioned
|
|
func (b *Builder) WithVolumeType(vtype string) *Builder {
|
|
b.volume.Object.Spec.VolumeType = vtype
|
|
return b
|
|
}
|
|
|
|
// WithFsType sets filesystem for the ZFSVolume
|
|
func (b *Builder) WithFsType(fstype string) *Builder {
|
|
b.volume.Object.Spec.FsType = fstype
|
|
return b
|
|
}
|
|
|
|
// WithSnapshot sets Snapshot name for creating clone volume
|
|
func (b *Builder) WithSnapshot(snap string) *Builder {
|
|
b.volume.Object.Spec.SnapName = snap
|
|
return b
|
|
}
|
|
|
|
func (b *Builder) WithPoolName(pool string) *Builder {
|
|
if pool == "" {
|
|
b.errs = append(
|
|
b.errs,
|
|
errors.New(
|
|
"failed to build zfs volume object: missing pool name",
|
|
),
|
|
)
|
|
return b
|
|
}
|
|
b.volume.Object.Spec.PoolName = pool
|
|
return b
|
|
}
|
|
|
|
func (b *Builder) WithNodename(name string) *Builder {
|
|
if name == "" {
|
|
b.errs = append(
|
|
b.errs,
|
|
errors.New(
|
|
"failed to build zfs volume object: missing node name",
|
|
),
|
|
)
|
|
return b
|
|
}
|
|
b.volume.Object.Spec.OwnerNodeID = name
|
|
return b
|
|
}
|
|
|
|
// WithLabels merges existing labels if any
|
|
// with the ones that are provided here
|
|
func (b *Builder) WithLabels(labels map[string]string) *Builder {
|
|
if len(labels) == 0 {
|
|
return b
|
|
}
|
|
|
|
if b.volume.Object.Labels == nil {
|
|
b.volume.Object.Labels = map[string]string{}
|
|
}
|
|
|
|
for key, value := range labels {
|
|
b.volume.Object.Labels[key] = value
|
|
}
|
|
return b
|
|
}
|
|
|
|
func (b *Builder) WithFinalizer(finalizer []string) *Builder {
|
|
b.volume.Object.Finalizers = append(b.volume.Object.Finalizers, finalizer...)
|
|
return b
|
|
}
|
|
|
|
// Build returns ZFSVolume API object
|
|
func (b *Builder) Build() (*apis.ZFSVolume, error) {
|
|
if len(b.errs) > 0 {
|
|
return nil, errors.Errorf("%+v", b.errs)
|
|
}
|
|
|
|
return b.volume.Object, nil
|
|
}
|