ボリューム スナップショットを作成する

このドキュメントでは、コンテナ アプリケーションの特定の時点でのストレージ ボリュームのコピー（スナップショット）を作成する方法について説明します。ボリューム スナップショットを使用すると、ボリュームを以前の状態に戻したり、新しいボリュームをプロビジョニングしたりできます。

このドキュメントは、組織のアプリケーション ワークロードの作成を担当するアプリケーション オペレーター グループのデベロッパーを対象としています。詳細については、GDC エアギャップ ドキュメントの対象ユーザーをご覧ください。

始める前に

このドキュメントのタスクを完了するには、必要な権限をリクエストして環境を準備する必要があります。

IAM ロールをリクエストする

ボリューム スナップショットの作成に必要な権限を取得するには、特定のロールが必要です。必要なロールは、組織スコープの共有クラスタとプロジェクト スコープの標準クラスタのどちらで作業しているかによって異なります。詳細については、Kubernetes クラスタ構成をご覧ください。

共有クラスタロール

共有クラスタでボリューム スナップショットを作成、削除、編集、表示するには、プロジェクト IAM 管理者に Namespace 管理者（namespace-admin）ロールの付与を依頼してください。このロールはプロジェクトの名前空間にバインドされます。

標準クラスタロール

標準クラスタでボリューム スナップショットを作成、削除、編集、表示するには、プロジェクト IAM 管理者に クラスタ デベロッパー（cluster-developer）ロールの付与を依頼してください。このロールはプロジェクトの名前空間にバインドされます。

環境を準備する

API を使用して Kubernetes クラスタに対してコマンドを実行するには、次のリソースがあることを確認してください。

  • Kubernetes クラスタ名を確認するか、プラットフォーム管理者グループのメンバーにクラスタ名を確認します。

  • Kubernetes クラスタの kubeconfig ファイルにログインして生成します。

  • これらの手順では、Kubernetes クラスタの kubeconfig パスを使用して KUBERNETES_CLUSTER_KUBECONFIG を置き換えます。

ボリューム スナップショットを作成する

PersistentVolumeClaim オブジェクトのスナップショットを取得するには、VolumeSnapshot オブジェクトを作成します。システムではデータの整合性は保証されません。スナップショットを取得する前に、アプリケーションを一時停止してデータをフラッシュします。

  1. VolumeSnapshot カスタム リソースを作成します。

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshot
metadata:
  name: VOLUME_SNAPSHOT_NAME
spec:
  source:
    persistentVolumeClaimName: PVC_NAME
EOF

    次のように置き換えます。

    • KUBERNETES_CLUSTER_KUBECONFIG: クラスタの kubeconfig ファイル。

    • NAMESPACE: ボリューム スナップショットを作成する Namespace。共有クラスタの場合、これはプロジェクト Namespace である必要があります。Standard クラスタの場合は、任意の Namespace を指定できます。

    • VOLUME_SNAPSHOT_NAME: VolumeSnapshot オブジェクト名。

    • PVC_NAME: スナップショットを作成する PVC の名前。

  2. .status.readyToUse フィールドが true になると、スナップショット オペレーションは完了します。次のコマンドを使用して、ステータスを確認できます。

      kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG get volumesnapshot \
    -o custom-columns='NAME:.metadata.name,READY:.status.readyToUse'

  3. データソースとして指定されたボリューム スナップショットで PVC マニフェストを更新します。

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: PVC_NAME
spec:
  dataSource:
    name: VOLUME_SNAPSHOT_NAME
    kind: VolumeSnapshot
    apiGroup: snapshot.storage.k8s.io
  storageClassName: standard-rwo
  accessModes:
    - ReadWriteOnce
resources:
  requests:
    storage: 10Gi
EOF

    次のように置き換えます。

    • KUBERNETES_CLUSTER_KUBECONFIG: クラスタの kubeconfig ファイル。

    • NAMESPACE: PVC リソースが存在する Namespace。共有クラスタの場合、これはプロジェクト Namespace である必要があります。Standard クラスタの場合は、任意の Namespace を指定できます。

    • PVC_NAME: スナップショットを作成する PVC の名前。

    • VOLUME_SNAPSHOT_NAME: ボリューム スナップショットの名前。

次のステップ