第27章 ストレージ API

CSIStorageCapacity は、1 回の CSIGetCapacity 呼び出しの結果を保存します。特定の StorageClass について、これは特定のトポロジーセグメントで使用可能な容量を表します。これは、新しい PersistentVolumes をインスタンス化する場所を検討するときに使用できます。

たとえば、これは次のように表すことができます。- StorageClass "standard" の "1234GiB" は "topology.kubernetes.io/zone=us-east1" で利用可能 - StorageClass "localssd" の "10GiB" は "kubernetes.io/hostname=knode-abc123" で利用可能

次の 3 つのケースはすべて、特定の組み合わせで使用可能な容量がないことを意味します。- 適切なトポロジーとストレージクラス名を持つオブジェクトが存在しない - そのようなオブジェクトは存在するが、容量は設定されていない - そのようなオブジェクトは存在するが、容量はゼロである

これらのオブジェクトの作成者は、どちらのアプローチがより適切かを判断できます。

これらは、CSI ドライバーが CSIDriverSpec.StorageCapacity による容量認識スケジューリングを選択するときに、kube-scheduler によって消費されます。スケジューラーは、保留中のボリュームで要求されたサイズと MaximumVolumeSize を比較して、不適切なノードを除外します。MaximumVolumeSize が設定されていない場合は、正確性の低い容量との比較に戻ります。これも設定されていない場合、スケジューラーは容量が不十分であると判断し、他のノードを試行します。

StorageClass は、PersistentVolumes を動的にプロビジョニングできるストレージのクラスのパラメーターを記述します。

StorageClasses は namespace ではありません。etcd に従ったストレージクラスの名前は ObjectMeta.Name にあります。

VolumeAttachment は、指定されたボリュームを指定されたノードにアタッチまたはデタッチする意図をキャプチャーします。

VolumeAttachment オブジェクトには namespace がありません。