Azure マネージドディスクで Azure Container Storage (プレビュー) を使用する

[アーティクル]
03/25/2024

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

前提条件

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 Container Storage のインストールについての手順を実行します。

Note

Azure Managed Disks で Azure Container Storage を使用するには、汎用 VM (クラスターノード用に standard_d4s_v5 など) を少なくとも 3 つ用意し、それぞれに仮想 CPU (vCPU) を 4 つ以上を割り当てたノードプールを AKS クラスターに用意する必要があります。

リージョン別の提供状況

Azure Container Storage は、次の Azure リージョンのサブセットでのみ使用できます。

(アフリカ) 南アフリカ北部
(アジア太平洋) オーストラリア東部
(アジア太平洋) 東アジア
(アジア太平洋) 東日本
(アジア太平洋) 韓国中部
(アジア太平洋) 東南アジア
(アジア太平洋) インド中部
(ヨーロッパ) フランス中部
(ヨーロッパ) 北ヨーロッパ
(ヨーロッパ) 西ヨーロッパ
(ヨーロッパ) 英国南部
(ヨーロッパ) スウェーデン中部
(ヨーロッパ) スイス北部
(中東) アラブ首長国連邦北部
(北米) 米国東部
(北米)米国東部 2
(北米) 米国西部
(北米)米国西部 2
(北米) 米国西部 3
(北米) 米国中部
(北米) 米国中北部
(北米) 米国中南部
(北米) 米国中西部
(北米) カナダ中部
(北米) カナダ東部
(南アメリカ) ブラジル南部

記憶域プールを作成する

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

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

重要

Microsoft マネージドキーを使うのではなく、独自のキーを使ってボリュームを暗号化する場合は、このセクションの手順を使って記憶域プールを作成しないでください。代わりに、「カスタマーマネージドキーを使ってサーバー側の暗号化を有効にする」に進み、その手順を実行してください。

次の手順に従って、Azure ディスク用のストレージプールを作成します。

任意のテキストエディターを使用して、code acstor-storagepool.yaml などの YAML マニフェストファイルを作成します。
次のコードを貼り付けます。ストレージプールの name の値は何でもかまいません。 skuName には、パフォーマンスと冗長性のレベルを指定します。使用できる値は、Premium_LRS、Standard_LRS、StandardSSD_LRS、UltraSSD_LRS、Premium_ZRS、PremiumV2_LRS、StandardSSD_ZRS です。 記憶域には、プールの記憶域容量を Gi または Ti で指定します。ファイルを保存します。
```
apiVersion: containerstorage.azure.com/v1
kind: StoragePool
metadata:
  name: azuredisk
  namespace: acstor
spec:
  poolType:
    azureDisk:
      skuName: Premium_LRS
  resources:
    requests:
      storage: 1Ti
```
YAML マニフェストファイルを適用してストレージプールを作成します。
```
kubectl apply -f acstor-storagepool.yaml 
```
ストレージプールの作成が完了すると、次のようなメッセージが表示されます。
```
storagepool.containerstorage.azure.com/azuredisk created
```
このコマンドを実行して、ストレージプールの状態を確認することもできます。 <storage-pool-name> はストレージプールの name の値に置き換えます。この例では、値を azuredisk.とします。
```
kubectl describe sp <storage-pool-name> -n acstor
```

ストレージプールが作成されると、Azure Container Storage により、名前付け規則 acstor-<storage-pool-name> を使用してストレージクラスが自動的に作成されます。これで、使用できるストレージクラスを表示し、永続ボリューム要求を作成できるようになりました。

事前にプロビジョニングされたストレージプールを作成する

既にプロビジョニングされている Azure マネージドディスクがある場合は、それらのディスクを使って事前にプロビジョニングされたストレージプールを作成できます。ディスクは既にプロビジョニングされているため、ストレージプールの作成時に skuName やストレージ容量を指定する必要はありません。

Azure ディスク用に事前にプロビジョニングされたストレージプールを作成するには、次の手順に従います。

Azure portal にサインインします。
使うディスクごとに、Azure マネージドディスクに移動し、[設定]>[プロパティ] を選びます。 [リソース ID] の下の文字列全体をコピーし、テキストファイルに配置します。
任意のテキストエディターを使用して、code acstor-storagepool.yaml などの YAML マニフェストファイルを作成します。
次のコードを貼り付けます。ストレージプールの name の値は何でもかまいません。 <resource-id> を各マネージドディスクのリソース ID に置き換えます。ファイルを保存します。
```
apiVersion: containerstorage.azure.com/v1
kind: StoragePool
metadata:
  name: sp-preprovisioned
  namespace: acstor
spec:
  poolType:
    azureDisk:
      disks:
        - reference <resource-id1>
        - reference <resource-id2>
```
YAML マニフェストファイルを適用してストレージプールを作成します。
```
kubectl apply -f acstor-storagepool.yaml 
```
ストレージプールの作成が完了すると、次のようなメッセージが表示されます。
```
storagepool.containerstorage.azure.com/sp-preprovisioned created
```
このコマンドを実行して、ストレージプールの状態を確認することもできます。 <storage-pool-name> はストレージプールの name の値に置き換えます。この例の場合、値は sp-preprovisioned になります。
```
kubectl describe sp <storage-pool-name> -n acstor
```

カスタマーマネージドキーを使ってサーバー側の暗号化を有効にする

既に記憶域プールを作成している場合、または既定の Microsoft マネージド暗号化キーを使う場合は、このセクションをスキップして、「使用可能なストレージクラスを表示する」に進みます。

Azure Storage アカウント内のすべてのデータは保存時に暗号化されます。規定では、データは Microsoft のマネージドキーで暗号化されます。暗号化キーをより詳細に制御するには、カスタマーマネージドキー (CMK) を指定して、Azure Disk 記憶域プールから作成する永続ボリュームを暗号化できます。

独自のキーを使うには、Azure キーコンテナーとキーが必要です。キーコンテナーの消去保護を有効にする必要があります。また、Azure RBAC アクセス許可モデルを使う必要があります。詳細については、Linux 上のカスタマーマネージドキーに関する記事を参照してください。

記憶域プールを作成するときは、CMK パラメーターを定義する必要があります。必要な CMK 暗号化パラメーターは次のとおりです。

keyVersion には、使うキーのバージョンを指定します
keyName はキーの名前です
keyVaultUri は、Azure Key Vault の Uniform Resource Identifier です (たとえば https://user.vault.azure.net)
Identity には、コンテナーにアクセスできるマネージド ID を指定します (たとえば /subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/MC_user-acstor-westus2-rg_user-acstor-westus2_westus2/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-acstor-westus2-agentpool)

独自の暗号化キーを使って記憶域プールを作成するには、以下の手順を実行します。この記憶域プールから作成されるすべての永続ボリュームは、同じキーを使って暗号化されます。

任意のテキストエディターを使用して、code acstor-storagepool-cmk.yaml などの YAML マニフェストファイルを作成します。
次のコードを貼り付け、必要なパラメーターを指定してファイルを保存します。ストレージプールの name の値は何でもかまいません。 skuName には、パフォーマンスと冗長性のレベルを指定します。使用できる値は、Premium_LRS、Standard_LRS、StandardSSD_LRS、UltraSSD_LRS、Premium_ZRS、PremiumV2_LRS、StandardSSD_ZRS です。 記憶域には、プールの記憶域容量を Gi または Ti で指定します。 CMK 暗号化パラメーターは必ず指定してください。
```
apiVersion: containerstorage.azure.com/v1
kind: StoragePool
metadata:
  name: azuredisk
  namespace: acstor
spec:
  poolType:
    azureDisk:
      skuName: Premium_LRS
      encryption: {
        keyVersion: "<key-version>",
        keyName: "<key-name>",
        keyVaultUri: "<key-vault-uri>",
        identity: "<identity>"
      }
  resources:
    requests:
      storage: 1Ti
```
YAML マニフェストファイルを適用してストレージプールを作成します。
```
kubectl apply -f acstor-storagepool-cmk.yaml 
```
ストレージプールの作成が完了すると、次のようなメッセージが表示されます。
```
storagepool.containerstorage.azure.com/azuredisk created
```
このコマンドを実行して、ストレージプールの状態を確認することもできます。 <storage-pool-name> はストレージプールの name の値に置き換えます。この例では、値を azuredisk.とします。
```
kubectl describe sp <storage-pool-name> -n acstor
```

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

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

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

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

重要

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

永続ボリューム要求の作成

永続ボリューム要求 (PVC) を使用して、ストレージクラスに基づいてストレージを自動的にプロビジョニングします。新しいストレージクラスを使用して PVC を作成するには、次の手順に従います。

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

次のコードを貼り付けて、ファイルを保存します。 PVC name の値はどのような値にもすることができます。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: azurediskpvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: acstor-azuredisk # replace with the name of your storage class if different
  resources:
    requests:
      storage: 100Gi

YAML マニフェストファイルを適用して PVC を作成します。
```
kubectl apply -f acstor-pvc.yaml
```
次のような出力が表示されます。
```
persistentvolumeclaim/azurediskpvc created
```
次のコマンドを実行して、PVC の状態を確認できます。
```
kubectl describe pvc azurediskpvc
```

PVC が作成されると、ポッドで使用できるようになります。

ポッドをデプロイして永続ボリュームをアタッチする

Fio (フレキシブル I/O テスター) を使用してベンチマークおよびワークロードシミュレーション用にポッドを作成し、永続ボリュームのマウントパスを指定します。 claimName には、永続ボリューム要求の作成時に使用した name の値を使用します。

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

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

kind: Pod
apiVersion: v1
metadata:
  name: fiopod
spec:
  nodeSelector:
    acstor.azure.com/io-engine: acstor
  volumes:
    - name: azurediskpv
      persistentVolumeClaim:
        claimName: azurediskpvc
  containers:
    - name: fio
      image: nixery.dev/shell/fio
      args:
        - sleep
        - "1000000"
      volumeMounts:
        - mountPath: "/volume"
          name: azurediskpv

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

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

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

永続ボリュームをデタッチして再アタッチする

永続ボリュームをデタッチするには、永続ボリュームがアタッチされているポッドを削除します。 <pod-name> はポッドの名前 (fiopod など) に置き換えます。

kubectl delete pods <pod-name>

永続ボリュームを再アタッチするには、「ポッドをデプロイして永続ボリュームをアタッチする」の説明に従って、YAML マニフェストファイル内の永続ボリューム要求名を参照するだけです。

永続ボリューム要求がバインドされている永続ボリュームを確認するには、kubectl get pvc <persistent-volume-claim-name> を実行します。

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

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

Note

ストレージプールを拡張すると、Azure Container Storage と Azure Disks のコストが増加する可能性があります。 Azure Container Storage の価格ページを参照してください。

Azure Disks の既存のストレージプールを拡張するには、以下の手順に従います。

テキストエディターを使って、ストレージプールの作成に使った YAML マニフェストファイル (たとえば code acstor-storagepool.yaml) を開きます。
YAML マニフェストファイル内の指定された storage エントリを目的の値に置き換えます。この値は、ストレージプールの現在の容量より大きい必要があります。たとえば、spec が storage: 1Ti に設定されている場合は、それを storage: 2Ti に変更します。事前にプロビジョニングされたストレージプールを作成した場合、ストレージプールは事前にプロビジョニングされた Azure ディスクから容量サイズを継承するため、storage エントリは存在しません。 YAML に storage エントリが表示されない場合は、必要なストレージ容量を指定する次のコードを追加し、マニフェストファイルを保存します。
```
spec:
  resources:
    requests:
      storage: 2Ti
```
YAML マニフェストファイルを適用してストレージプールを拡張します。
```
kubectl apply -f acstor-storagepool.yaml 
```
このコマンドを実行して、ストレージプールの状態を確認します。 <storage-pool-name> はストレージプールの name の値に置き換えます。
```
kubectl describe sp <storage-pool-name> -n acstor
```
"ストレージプールが拡張中です" のようなメッセージが表示されます。数分後にコマンドを再度実行すると、メッセージは表示されなくなります。
kubectl get sp -A を実行すると、ストレージプールに新しいサイズが反映されます。

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

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

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

こちらもご覧ください

Azure Container Storage とは

Share via

Azure マネージドディスクで Azure Container Storage (プレビュー) を使用する

前提条件

リージョン別の提供状況

記憶域プールを作成する

事前にプロビジョニングされたストレージプールを作成する

カスタマーマネージドキーを使ってサーバー側の暗号化を有効にする

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

永続ボリューム要求の作成

ポッドをデプロイして永続ボリュームをアタッチする

永続ボリュームをデタッチして再アタッチする

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

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

こちらもご覧ください

その他のリソース

Share via

Azure マネージド ディスクで Azure Container Storage (プレビュー) を使用する

前提条件

リージョン別の提供状況

記憶域プールを作成する

事前にプロビジョニングされたストレージ プールを作成する

カスタマー マネージド キーを使ってサーバー側の暗号化を有効にする

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

永続ボリューム要求の作成

ポッドをデプロイして永続ボリュームをアタッチする

永続ボリュームをデタッチして再アタッチする

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

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

こちらもご覧ください

その他のリソース

Azure マネージドディスクで Azure Container Storage (プレビュー) を使用する

事前にプロビジョニングされたストレージプールを作成する

カスタマーマネージドキーを使ってサーバー側の暗号化を有効にする

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

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

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