Prerequisite

CSI snapshot support is available for Kubernetes versions >= 1.17.

It is the responsibility of the Kubernetes distribution to deploy the snapshot controller as well as the related custom resource definitions.

For more information, see CSI Volume Snapshots.

Add a Default VolumeSnapshotClass

Ensure the availability of the Snapshot Beta CRDs. Afterwards create a default VolumeSnapshotClass.

  1. kind: VolumeSnapshotClass
  2. apiVersion: snapshot.storage.k8s.io/v1beta1
  3. metadata:
  4.   name: longhorn
  5. driver: driver.longhorn.io
  6. deletionPolicy: Delete

If You are Updating from a Previous Longhorn Version in an Air Gap Environment

  1. Update the csi-provisioner image to longhornio/csi-provisioner:v1.6.0.
  2. Add thecsi-snapshotter image for longhornio/csi-snapshotter:v2.1.1.

If your Kubernetes Distribution Does Not Bundle the Snapshot Controller

You may manually install these components by executing the following steps.

Note that the snapshot controller YAML files mentioned below deploy into the default namespace.

Prerequisite

For general use, update the snapshot controller YAMLs with an appropriate namespace prior to installing.

For example, on a vanilla Kubernetes cluster, update the namespace from default to kube-system prior to issuing the kubectl create command.

Install the Snapshot Beta CRDs:

  1. Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/release-4.0/client/config/crd
  2. Run kubectl create -f client/config/crd.
  3. Do this once per cluster.

Install the Common Snapshot Controller:

  1. Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/release-4.0/deploy/kubernetes/snapshot-controller
  2. Update the namespace to an appropriate value for your environment (e.g. kube-system)
  3. Run kubectl create -f deploy/kubernetes/snapshot-controller.
  4. Do this once per cluster.

See the Usage section from the kubernetes external-snapshotter git repo for additional information.