ローカル NVMe で Azure Container Storage (プレビュー) を使用する

[アーティクル]
06/28/2024

Azure Container Storage は、コンテナー用にネイティブに構築されたクラウドベースのボリューム管理、デプロイ、オーケストレーションサービスです。この記事では、Kubernetes ワークロードのバックエンドストレージとしてローカル NVMe と一緒にエフェメラルディスクを使用するように Azure Container Storage を構成する方法について説明します。最後に、ローカル NVMe をストレージとして使用するポッドが得られます。

エフェメラルディスクとは

アプリケーションでミリ秒未満のストレージ待ち時間が必要で、データの持続性が必要ない場合は、Azure Container Storage でエフェメラルディスクを使用してパフォーマンス要件を満たすことができます。エフェメラルとは、ディスクが AKS クラスターをホストするローカル仮想マシン (VM) にデプロイされ、Azure ストレージサービスに保存されないことを意味します。 VM を停止または割り当て解除すると、これらのディスク上のデータは失われます。

使用できるエフェメラルディスクには、NVMe と一時 SSD の 2 種類があります。 NVMe は、ストレージと CPU 間の高速データ転送用に設計されています。アプリケーションで一時 SSD よりも高い IOPS とスループットが必要な場合、またはワークロードでレプリケーションが必要な場合は、NVMe を選択します。一時 SSD では、レプリケーションは現在サポートされていません。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
この記事では、最新バージョン (2.35.0 以降) の Azure CLI が必要です。「Azure CLI のインストール方法」を参照してください。 Azure Cloud Shell の Bash 環境を使用している場合は、最新バージョンが既にインストールされています。 Azure Cloud Shell ではなくローカルでコマンドを実行する場合は、必ず管理特権で実行してください。詳細については、「Azure Cloud Shell の概要」を参照してください。
Kubernetes コマンドラインクライアント kubectl が必要です。 Azure Cloud Shell を使用している場合は既にインストールされています。または、az aks install-cli コマンドを実行してローカルにインストールできます。
Azure Container Storage をまだインストールしていない場合は、Azure Kubernetes Service での Azure Container Storage の使用に関する記事の手順に従ってください。
ターゲットリージョンが Azure Container Storage リージョンでサポート対象になっているかどうかを確認します。

ローカル NVMe をサポートする VM の種類を選択する

エフェメラルディスクは、特定の種類の VM でのみ使用できます。ローカル NVMe を使用する予定の場合は、standard_l8s_v3 などの、ストレージ最適化 VM が必要です。

次のコマンドを実行すると、ノードプールで使用される VM の種類を取得できます。

az aks nodepool list --resource-group <resource group> --cluster-name <cluster name> --query "[].{PoolName:name, VmSize:vmSize}" -o table

出力の例を次に示します。

PoolName    VmSize
----------  ---------------
nodepool1   standard_l8s_v3

各 VM に少なくとも 4 つの仮想 CPU (vCPU) があり、各ノードプールに少なくとも 3 つのノードがあることをお勧めします。

汎用エフェメラルボリュームを作成してアタッチする

次の手順に従って汎用エフェメラルボリュームを作成してアタッチします。

1.ストレージプールを作成する

まず、YAML マニフェストファイルで定義することによって、Kubernetes クラスターのストレージの論理グループであるストレージプールを作成します。

az aks create または az aks update コマンドを使って Azure Container Storage を有効にした場合は、記憶域プールが既に存在している可能性があります。 kubectl get sp -n acstor を使って記憶域プールの一覧を取得します。使いたい記憶域プールが既に使用可能な場合は、このセクションをスキップして、「使用可能なストレージクラスを表示する」に進むことができます。

ローカル NVMe を使用してストレージプールを作成するには、次の手順に従います。

任意のテキストエディターを使用して、code acstor-storagepool.yaml などの YAML マニフェストファイルを作成します。

次のコードを貼り付けて、ファイルを保存します。ストレージプールの name の値は何でもかまいません。

apiVersion: containerstorage.azure.com/v1
kind: StoragePool
metadata:
  name: ephemeraldisk-nvme
  namespace: acstor
spec:
  poolType:
    ephemeralDisk: {}

YAML マニフェストファイルを適用してストレージプールを作成します。
```
kubectl apply -f acstor-storagepool.yaml 
```
ストレージプールの作成が完了すると、次のようなメッセージが表示されます。
```
storagepool.containerstorage.azure.com/ephemeraldisk-nvme created
```
このコマンドを実行して、ストレージプールの状態を確認することもできます。 <storage-pool-name> はストレージプールの name の値に置き換えます。この例では、値は ephemeraldisk-nvme になります。
```
kubectl describe sp <storage-pool-name> -n acstor
```

ストレージプールが作成されると、Azure Container Storage により、名前付け規則 acstor-<storage-pool-name> を使用してストレージクラスが自動的に作成されます。

2.使用可能なストレージクラスを表示する

ストレージプールを使用する準備ができたら、ストレージクラスを選択して、ボリュームの作成とデプロイ時にストレージが動的に作成される方式を定義する必要があります。

kubectl get sc を実行して、使用可能なストレージクラスを表示します。 acstor-<storage-pool-name> というストレージクラスがあることを確認します。

$ kubectl get sc | grep "^acstor-"
acstor-azuredisk-internal   disk.csi.azure.com               Retain          WaitForFirstConsumer   true                   65m
acstor-ephemeraldisk-nvme        containerstorage.csi.azure.com   Delete          WaitForFirstConsumer   true                   2m27s

重要

internal が付いているストレージクラスは使用しないでください。これは、Azure Container Storage の動作に必要な内部ストレージクラスです。

3.汎用エフェメラルボリュームを使用してポッドをデプロイする

Fio (フレキシブル I/O テスター) を使用して、汎用エフェメラルボリュームを使用する、ベンチマークおよびワークロードシミュレーション用のポッドを作成します。

任意のテキストエディターを使用して、code acstor-pod.yaml などの YAML マニフェストファイルを作成します。

次のコードを貼り付けて、ファイルを保存します。

kind: Pod
apiVersion: v1
metadata:
  name: fiopod
spec:
  nodeSelector:
    acstor.azure.com/io-engine: acstor
  containers:
    - name: fio
      image: nixery.dev/shell/fio
      args:
        - sleep
        - "1000000"
      volumeMounts:
        - mountPath: "/volume"
          name: ephemeralvolume
  volumes:
    - name: ephemeralvolume
      ephemeral:
        volumeClaimTemplate:
          metadata:
            labels:
              type: my-ephemeral-volume
          spec:
            accessModes: [ "ReadWriteOnce" ]
            storageClassName: acstor-ephemeraldisk-nvme # replace with the name of your storage class if different
            resources:
              requests:
                storage: 1Gi

ボリュームのストレージサイズを変更する際には、そのサイズが単一ノードのエフェメラルディスクの利用可能な容量より小さいことを確認します。「ノードエフェメラルディスク容量を確認する」を参照してください。

YAML マニフェストファイルを適用してポッドをデプロイします。
```
kubectl apply -f acstor-pod.yaml
```
次のような出力が表示されます。
```
pod/fiopod created
```
ポッドが実行されていること、およびエフェメラルボリューム要求がポッドに正常にバインドされていることを確認します。
```
kubectl describe pod fiopod
kubectl describe pvc fiopod-ephemeralvolume
```

fio テストをチェックして、その現在の状態を確認します。

kubectl exec -it fiopod -- fio --name=benchtest --size=800m --filename=/volume/test --direct=1 --rw=randrw --ioengine=libaio --bs=4k --iodepth=16 --numjobs=8 --time_based --runtime=60

ローカル NVMe をストレージとして使用するポッドをデプロイし、それを Kubernetes ワークロードに使用できるようになりました。

ボリュームとストレージプールを管理する

このセクションでは、単一ノードで利用可能なエフェメラルディスクの容量を確認する方法と、ストレージプールを拡張または削除する方法を学習します。

ノードエフェメラルディスク容量を確認する

エフェメラルボリュームは、単一ノードに割り当てられます。エフェメラルボリュームのサイズを構成する際には、そのサイズを単一ノードのエフェメラルディスクの利用可能な容量より小さくする必要があります。

次のコマンドを実行して、単一ノードのエフェメラルディスクの利用可能な容量を確認します。

$ kubectl get diskpool -n acstor
NAME                                CAPACITY      AVAILABLE     USED        RESERVED    READY   AGE
ephemeraldisk-nvme-diskpool-jaxwb   75660001280   75031990272   628011008   560902144   True    21h
ephemeraldisk-nvme-diskpool-wzixx   75660001280   75031990272   628011008   560902144   True    21h
ephemeraldisk-nvme-diskpool-xbtlj   75660001280   75031990272   628011008   560902144   True    21h

この例では、単一ノードのエフェメラルディスクの利用可能な容量は、75031990272 バイトまたは 69 GiB です。

ストレージプールを拡張する

ローカル NVMe によってサポートされるストレージプールを拡張すると、ダウンタイムなしで迅速にスケールアップできます。ストレージプールの縮小は現在サポートされていません。

エフェメラルディスクによってサポートされるストレージプールは AKS クラスターノード (VM) 上のローカルストレージリソースを使用するため、ストレージプールを拡張するには、クラスターに別のノードを追加する必要があります。ストレージプールを拡張するには、次の手順に従います。

次のコマンドを実行して、AKS クラスターにノードを追加します。 <cluster-name>、<nodepool name>、および <resource-group-name> を独自の値に置き換えます。ノードプールの名前を取得するには、kubectl get nodes を実行します。
```
az aks nodepool add --cluster-name <cluster name> --name <nodepool name> --resource-group <resource group> --node-vm-size Standard_L8s_v3 --node-count 1 --labels acstor.azure.com/io-engine=acstor
```
kubectl get nodes を実行すると、ノードがクラスターに追加されたことがわかります。
kubectl get sp -A を実行すると、ストレージプールの容量が増えたことがわかります。

ストレージプールを削除する

ストレージプールを削除する場合は、次のコマンドを実行します。 <storage-pool-name> はストレージプール名に置き換えます。

kubectl delete sp -n acstor <storage-pool-name>

こちらもご覧ください

Azure Container Storage とは

次の方法で共有

ローカル NVMe で Azure Container Storage (プレビュー) を使用する

エフェメラルディスクとは

前提条件

ローカル NVMe をサポートする VM の種類を選択する

汎用エフェメラルボリュームを作成してアタッチする

1.ストレージプールを作成する

2.使用可能なストレージクラスを表示する

3.汎用エフェメラルボリュームを使用してポッドをデプロイする

ボリュームとストレージプールを管理する

ノードエフェメラルディスク容量を確認する

ストレージプールを拡張する

ストレージプールを削除する

こちらもご覧ください

フィードバック

フィードバック

その他のリソース

次の方法で共有

ローカル NVMe で Azure Container Storage (プレビュー) を使用する

エフェメラル ディスクとは

前提条件

ローカル NVMe をサポートする VM の種類を選択する

汎用エフェメラル ボリュームを作成してアタッチする

1.ストレージ プールを作成する

2.使用可能なストレージ クラスを表示する

3.汎用エフェメラル ボリュームを使用してポッドをデプロイする

ボリュームとストレージ プールを管理する

ノード エフェメラル ディスク容量を確認する

ストレージ プールを拡張する

ストレージ プールを削除する

こちらもご覧ください

フィードバック

フィードバック

その他のリソース

エフェメラルディスクとは

汎用エフェメラルボリュームを作成してアタッチする

1.ストレージプールを作成する

2.使用可能なストレージクラスを表示する

3.汎用エフェメラルボリュームを使用してポッドをデプロイする

ボリュームとストレージプールを管理する

ノードエフェメラルディスク容量を確認する

ストレージプールを拡張する

ストレージプールを削除する