vSphere Container Storage Interface ドライバの使用

このドキュメントでは、GKE on VMware で vSphere Container Storage Interface（CSI）ドライバを使用する方法について説明します。

概要

vSphere CSI ドライバは、GKE on VMware に自動的にデプロイされます。他の CSI ドライバの使用の詳細については、CSI ドライバのインストールをご覧ください。

vSphere の要件

vSphere CSI ドライバを使用するには、次の対象が必要です。

Linux ベースのサポートされている vCenter Server のバージョン
サポートされている ESXI のバージョン

ボリューム拡張

オフラインボリュームの拡張では、vCenter Server と ESXi の両方がバージョン 7.0 Update 1 以降である必要があります。
オンラインボリュームの拡張では、vCenter Server と ESXi の両方がバージョン 7.0 Update 2 以降である必要があります。

ボリュームスナップショット

ボリュームスナップショットでは、vCenter Server と ESXi の両方がバージョン 7.0 Update 3 以降である必要があります。

Cns. 検索可能

vCenter ユーザーアカウントには、ルート vCenter オブジェクトに対する Cns.Searchable 権限が必要です。

アカウントが CSI の前提条件を満たしているか不明な場合は、CSI ワークロードをデプロイする前に gkectl diagnose cluster を実行します。

ドライバがインストールされていることを確認する

ユーザークラスタに vSphere CSI ドライバをインストールすると、standard-rwo という StorageClass が作成されます。

StorageClass オブジェクトを一覧表示します。

kubectl --kubeconfig CLUSTER_KUBECONFIG get storageclass

CLUSTER_KUBECONFIG は、ユーザークラスタ kubeconfig ファイルのパスに置き換えます。

出力に standard-rwo が表示されていることを確認します。次に例を示します。

standard                 kubernetes.io/vsphere-volume  Delete   Immediate     false      33m
standard-rwo (default)   csi.vsphere.vmware.com    Delete   Immediate     true       32m

vSphere CSI ドライバがインストールされていることを確認します。

kubectl --kubeconfig CLUSTER_KUBECONFIG get csinode \
    -o="custom-columns=NAME:metadata.name,DRIVERS:spec.drivers[].name"

次の例ように、ドライバがすべてのクラスタノードで使用可能になっていることが出力に示されるはずです。例:

NAME     DRIVERS
node-0   csi.vsphere.vmware.com
node-1   csi.vsphere.vmware.com
node-2   csi.vsphere.vmware.com

ボリュームのプロビジョニング

vSphere CSI ドライバでボリュームをプロビジョニングするには、PersistentVolumeClaim の storageClassName フィールドを standard-rwo に設定します。

デフォルトのストレージクラスの設定

standard-rwo をデフォルトのストレージクラスとして設定するには、デフォルトのストレージクラスをご覧ください。

スナップショットを使用してボリュームを復元する

スナップショットからボリュームを復元するをご覧ください。

StorageClass の追加作成

追加の vSphere CSI StorageClass は、datastoreurl パラメータまたは storagepolicyname パラメータを使用してクラスタに作成できます。

次の例では、storagepolicyname パラメータを使用しています。

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: gold
parameters:
  csi.storage.k8s.io/fstype: ext4
  storagepolicyname: "Gold Policy"
provisioner: csi.vsphere.vmware.com

datastoreurl パラメータに対する正確な値を確認するには、次のコマンドを実行します。

govc datastore.info DATASTORE_NAME

DATASTORE_NAME は、vSphere データストアの名前に置き換えます。

datastoreurl には、出力の URL の値を使用します。出力例を以下に示します。

Name:        DATASTORE_NAME
  Path:      /DATACENTER_NAME/datastore/DATASTORE_NAME
  Type:      VMFS
  URL:       ds:///vmfs/volumes/5d864fa0-7f2184d4-8eb4-3cfdfe0ce9a0/
  Capacity:  20479.8 GB
  Free:      10066.9 GB

ボリュームのクリーンアップ

ユーザークラスタを削除しても、vSphere CSI ドライバによってプロビジョニングされたボリュームは削除されません。すべての PVC と StatefulSet を削除した後、クラスタを削除する必要があります。ボリュームを削除するには、次のコマンドを実行します。

kubectl delete statefulsets,persistentvolumeclaims --namespace=MY_NAMESPACE --all

MY_NAMESPACE は、Kubernetes Namespace に置き換えます。

ボリュームを削除せずにユーザークラスタを削除した場合は、vSphere のユーザーインターフェースでボリュームを見つけることができます。

データストアを選択します。
[Monitor] > [Cloud Native Storage] > [Container Volumes] に移動します。
各ボリュームの [Details] セクションに、Kubernetes クラスタ名が表示されます。

vSphere CSI ドライバの無効化

vSphere CSI のサポートを削除するには、ユーザークラスタ構成に次の行を追加します。

# (Optional) Storage specification for the cluster storage:
# To disable the vSphere CSI driver, set this to true. The value is set to false by default and
# the vSphere CSI driver is enabled by default on vSphere version >= 6.7U3.
  vSphereCSIDisabled: true