Volume Snapshots

Many storage systems provide the ability to create a snapshot of a persistent volume. A snapshot represents a point-in-time copy of a volume. It can be used either to provision a new volume (pre-populated with the snapshot data) or to restore the existing volume to a previous state (represented by the snapshot). For more information, see the Kubernetes documentation.

This tutorial demonstrates how to create and use a volume snapshot.

Prerequisites

  • You need to create a workspace, a project and an account (project-regular). The account must be invited to the project with the role of operator. For more information, see Create Workspaces, Projects, Accounts and Roles.

  • Kubernetes version 1.17+.

  • Your underlying storage plugin supports snapshots.

  • You have an available volume so that you can create a snapshot for it. For more information, see Volumes.

Create a Volume Snapshot

  1. Log in to the web console of KubeSphere as project-regular. On the Volumes page of your project, select a volume that you want to create a snapshot for.

  2. On the detail page, select Create Snapshot from the More drop-down list.

  3. In the dialog that appears, set a name for the snapshot which serves as a unique identifier. Click OK to finish.

  4. Newly-created snapshots will appear on the Volume Snapshots list.

Use a Snapshot to Create a Volume

There are two ways for you to use a snapshot to create a volume.

Create a volume from the snapshot detail page

  1. Log in to the web console of KubeSphere as project-regular. On a snapshot’s detail page, click Apply to use the snapshot. Generally, the steps are the same as creating a volume directly.

    apply-volume

  2. In the dialog that appears, set a name for the volume. Click Next to continue.

    Note

    The resource you create is a PersistentVolumeClaim (PVC).
  3. On the Volume Settings tab, select an access mode and click Next.

  4. On the Advanced Settings tab, add metadata for the volume such as labels and annotations. Click Create to finish.

  5. You can see the volume created appear on the Volumes page.

Create a volume from the Volumes page

  1. Log in to the web console of KubeSphere as project-regular. On the Volumes page of a project, click Create.

  2. In the dialog that appears, set a name for the volume. Click Next to continue.

  3. On the Volume Settings tab, select Create a volume by VolumeSnapshot under the Method section. Select a snapshot and an access mode, and click Next to continue.

  4. On the Advanced Settings tab, add metadata for the volume such as labels and annotations. Click Create to finish creating the volume.

  5. You can see the volume created appear on the Volumes page.


Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.