Azure ディスク CSI ドライバー
IBM Cloud Satellite® 用の Azure Disk CSI ドライバは、コンテナ・オーケストレーション・ツールが Azure Disk ボリュームのライフサイクルを管理できるように、CSI 仕様を実装している。
Azure ディスクCSIドライバの利用可能な機能の概要については、「 機能 」を参照してください。
現在、Satellite 用の Azure ディスク CSI ドライバー・テンプレートは、クラスターのバージョン 4.7 以降で使用できます。
ロケーションのクラスタにストレージテンプレートをデプロイする前に、コンソールで [Enable cluster admin access for Satellite Config] オプションを選択するか、クラスタを作成するときに[ --enable-config-admin ]オプションを含めて、 Satellite Configを設定していることを確認してください。
Satellite Configが変更内容を上書きするため、ストレージクラスをカスタマイズすることはできません。
Satellite ストレージサービスをリソースグループにスコープすることはできません。 ただし、ロケーションやクラスタなどの他のリソースをリソースグループにスコープする場合は、 アカウント内のすべてのリソースに Satellite リーダーとリンク管理者ロールを追加する必要があります。
Azure ディスクを使用するための前提条件
お使いのロケーションにストレージ構成を作成し、 Satellite クラスタ用の Azure ディスクストレージを設定します。 ストレージ構成をクラスターに割り当てると、選択したストレージ・プロバイダーのストレージ・ドライバーがクラスターにインストールされます。
「 Azure 」ディスク CSI ドライバーのストレージテンプレートを使用するには、以下のタスクを実行してください。
-
ロケーション・テンプレートを使用するか、手動で Satellite に Azure ホストを追加して、Azure ロケーションを作成します。 手動でホストを割り当てることにした場合は、ストレージ構成を作成する前に、 ワーカー・ノードにラベルを付ける必要があります。
-
Azure のコンピュート・ホストで実行される Satellite クラスターを作成します。 クラスターの作成時に 「 Satellite のクラスター管理アクセスを有効にする」 オプションを選択していることを確認します。 クラスターの作成時に Satellite の管理者 (管理者) アクセス権限を有効にしない場合、ストレージをデプロイする前に、クラスターを再作成し、管理者アクセス権限を有効にする必要があります。
オプション: Azure ディスクのワーカー・ノードにラベルを付ける
以下の手順を実行して、Azure ディスク CSI ドライバー・テンプレートのワーカー・ノードに必要なラベルを追加します。
Azure のホストをロケーションに手動で割り当て、コンソールで「 Schematics 」テンプレートを使用しなかった場合は、ストレージ構成を作成する前に ワーカーノードにラベルを付ける 必要があります。
-
Azure ワーカー・ノードをリストし、各ノードの
nameをメモします。oc get nodes -
各ノードの詳細を取得して、ノードが含まれている
zoneをメモします。 例:eastus-1。oc get nodes <node-name> -o yaml | grep zone -
ワーカー・ノードに、先ほど取得した
zone値を使用してラベルを付けます。<node-name>と<zone>を、ワーカー・ノードのノード名とゾーンに置き換えます。 例えば、ワーカー・ノードがゾーンeastus-1にある場合、次のコマンドを使用して、eastus-1ゾーン内のワーカー・ノードに、ラベルとしてeastus-1を追加します。oc label node <node-name> topology.kubernetes.io/zone- oc label node <node-name> topology.kubernetes.io/zone=<zone> --overwrite -
各ワーカーノードについて、前の手順を繰り返します
-
Azure アカウントにサインイン して、必須パラメーターを取得します。 パラメーターについて詳しくは、 クラスター構成 を参照してください。
コンソールでの構成の作成と割り当て
-
[ロケーション]コンソールから、ストレージ構成を作成するロケーションを選択します。
-
ストレージ > ストレージ構成の作成を選択します。
-
構成の名前を入力します。
-
ストレージの種類を選択してください。
-
バージョンを選択し、「 次へ 」をクリックしてください
-
選択した 「ストレージ・タイプ」 がカスタム・パラメーターを受け入れる場合は、 「パラメーター」 タブでそれらのパラメーターを入力します。
-
選択した ストレージ・タイプ にシークレットが必要な場合は、 「シークレット (Secrets)」 タブに入力します。
-
ストレージ・クラスタブで、構成によってデプロイされたストレージ・クラスを確認するか、カスタム・ストレージ・クラスを作成します。
-
サービスへの割り当てタブで、構成の割り当て先となるサービスを選択します。
-
完了をクリックして、ストレージ構成を割り当てます。
CLI での構成の作成
-
使用するテンプレート・バージョンの パラメーター・リファレンス を確認します。
-
IBM Cloud CLI にログインします。
ibmcloud login -
Satellite ロケーションをリストして、
Managed from列をメモします。ibmcloud sat location ls -
Satellite ロケーションの
Managed fromリージョンをターゲットにします。 例えば、wdcの場合は、us-eastをターゲットにします。 詳しくは、Satellite リージョンを参照してください。ibmcloud target -r us-east -
default以外のリソース・グループを使用する場合は、そのリソース・グループをターゲットにします。ibmcloud target -g RESOURCE_GROUP -
使用するテンプレート・バージョンについて、以下のいずれかのコマンド例をコピーします。 コマンドについて詳しくは、 コマンド・リファレンス の
ibmcloud sat storage config createを参照してください。バージョン 1.30.3 のコンフィギュレーションを作成するコマンド例。
ibmcloud sat storage config create --location LOCATION --name NAME --template-name azuredisk-csi-driver --template-version 1.30.3 --param "tenantId=TENANTID" --param "subscriptionId=SUBSCRIPTIONID" --param "aadClientId=AADCLIENTID" --param "location=LOCATION" --param "aadClientSecret=AADCLIENTSECRET" --param "resourceGroup=RESOURCEGROUP" --param "vmType=VMTYPE" --param "securityGroupName=SECURITYGROUPNAME" --param "vnetName=VNETNAME" --param "useWorkloadIdentity=USEWORKLOADIDENTITY" --param "workloadIdentityClientId=WORKLOADIDENTITYCLIENTID" --param "workloadIdentityTenantId=WORKLOADIDENTITYTENANTID" --param "enableOtelTracing=ENABLEOTELTRACING" --param "otelServiceName=OTELSERVICENAME" --param "otelExporterEndpoint=OTELEXPORTERENDPOINT" --param "useHostNetwork=USEHOSTNETWORK" -
使用する設定に基づいて、コマンドをカスタマイズします。
-
設定を作成するには、コマンドを実行してください。
-
設定が作成されたことを確認してください。
ibmcloud sat storage config get --config CONFIG
API での構成の作成
-
API キーを生成してから、リフレッシュ・トークンを要求します。 詳しくは、API キーを使用した IBM Cloud IAM トークンの生成を参照してください。
-
使用するテンプレート・バージョンの パラメーター・リファレンス を確認します。
-
以下のいずれかの要求例をコピーし、使用する変数を置き換えます。
バージョン 1.30.3 のコンフィギュレーションを作成するリクエスト例。
curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"azuredisk-csi-driver\", \"storage-template-version\": \"1.30.3\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"LOCATION\", { \"entry.name\": \"RESOURCEGROUP\", { \"entry.name\": \"VMTYPE\", { \"entry.name\": \"SECURITYGROUPNAME\", { \"entry.name\": \"VNETNAME\", { \"entry.name\": \"USEWORKLOADIDENTITY\", { \"entry.name\": \"ENABLEOTELTRACING\", { \"entry.name\": \"OTELSERVICENAME\", { \"entry.name\": \"OTELEXPORTERENDPOINT\", { \"entry.name\": \"USEHOSTNETWORK\",\"user-secret-parameters\": { \"entry.name\": \"TENANTID\",{ \"entry.name\": \"SUBSCRIPTIONID\",{ \"entry.name\": \"AADCLIENTID\",{ \"entry.name\": \"AADCLIENTSECRET\",{ \"entry.name\": \"WORKLOADIDENTITYCLIENTID\",{ \"entry.name\": \"WORKLOADIDENTITYTENANTID\",}
コマンドラインインターフェース(CLI)での課題の作成
-
ストレージ構成をリストアップし、クラスタに割り当てる予定のストレージ構成をメモしておいてください。
ibmcloud sat storage config ls -
ストレージを割り当てたいクラスタ、クラスタグループ、またはサービスのIDを取得します。
クラスターが Satellite Config に登録されていることを確認したり、グループを作成したりするには、Satellite Config で使用するためのクラスターのセットアップを参照してください。
クラスター・グループをリストするコマンドの例。
ibmcloud sat group lsクラスターをリストするコマンドの例。
ibmcloud oc cluster ls --provider satelliteSatellite サービスをリストするコマンドの例。
ibmcloud sat service ls --location LOCATION -
以前に取得したクラスター、グループ、またはサービスにストレージ構成を割り当てます。 詳しくは、
ibmcloud sat storage assignment createコマンドを参照してください。クラスター・グループに構成を割り当てるコマンドの例。
ibmcloud sat storage assignment create --group GROUP --config CONFIG --name NAMEクラスターに構成を割り当てるコマンドの例。
ibmcloud sat storage assignment create --cluster CLUSTER --config CONFIG --name NAMEサービス・クラスターに構成を割り当てるコマンドの例。
ibmcloud sat storage assignment create --service-cluster-id CLUSTER --config CONFIG --name NAME -
割り当てが作成されたことを確認します。
ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)
アプリケーション・プログラミング・インターフェース(API)でのストレージ割り当ての作成
-
以下のいずれかの要求例をコピーします。
構成をクラスターに割り当てる要求の例。
curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignmentByCluster" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"CLUSTER-ID\", \"controller\": \"LOCATION-ID\", \"name\": \"ASSIGNMENT-NAME\"}"クラスター・グループに構成を割り当てる要求の例。
curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"string\", \"groups\": [ \"CLUSTER-GROUP\" ], \"name\": \"ASSIGNMENT-NAME\"}" -
変数を自分の詳細に置き換え、要求を実行します。
-
割り当てをリストして、割り当てが作成されたことを確認します。
curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
コンソールでのストレージ割り当ての更新
Satellite コンソール を使用して、割り当てに最新のパッチ更新を適用できます。
-
Satellite コンソールの 「ロケーション」 ページで、ロケーションを選択します。
-
「ストレージ」 タブをクリックして、構成を表示します。
-
更新したい設定をクリックしてください。
-
「情報」 (i) アイコンをクリックして、最新のリビジョンまたはパッチを適用します。
-
オプション: ストレージ割り当ての自動パッチ更新を有効にします。 自動パッチ更新を有効にすると、割り当てに常に最新のセキュリティー・フィックスが適用されます。
自動パッチ更新を有効にした場合でも、メジャー更新を手動で適用する必要があります。
CLI での割り当ての手動アップグレード
最新のストレージ・テンプレート・リビジョンを使用するように割り当てをアップグレードします。
-
Satellite ストレージ割り当てをリストし、アップグレードする Satellite 割り当てを書き留めます。
ibmcloud sat storage assignment ls -
Satellite ストレージ・テンプレートをリストして、使用可能な最新バージョンを確認します。
ibmcloud sat storage template ls -
Satellite 割り当てをアップグレードします。
割り当てをアップグレードするコマンドの例。
ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT
CLI での構成および割り当ての自動パッチ更新の有効化
sat storage assignment autopatch enable CLI を使用して、割り当ての自動パッチ更新を有効にすることができます。 自動パッチ更新を有効にすると、最新のストレージ・テンプレート・リビジョン (パッチ) が自動的に適用されます。 ただし、メジャー更新は手動で適用する必要があります。
-
Satellite ストレージ構成をリストします。 設定IDをメモしておいてください。
ibmcloud sat storage assignment ls -
以下のいずれかのコマンド例を実行して、ご使用の構成とその関連割り当てに対して自動パッチ更新を有効にします。 前の手順で取得した設定IDを入力してください。
割り当ての自動パッチ更新を有効にするコマンドの例。
ibmcloud sat storage assignment autopatch enable --config CONFIG (--all | --assignment ASSIGNMENT-ID [--assignment ASSIGNMENT-ID])指定された構成下のすべてのストレージ割り当てに対して自動パッチ更新を有効にするコマンド例。
ibmcloud sat storage assignment autopatch enable --config CONFIG --all特定の構成下のすべての割り当てに対して自動パッチ更新を無効にするコマンドの例。
ibmcloud sat storage assignment autopatch disable --config CONFIG --all単一の割り当ておよび特定の構成に対して自動パッチ更新を無効にするコマンドの例。
ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID複数の割り当ておよび特定の構成に対する自動パッチ更新を無効にするコマンド例。
ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID --assignment ASSIGNMENT-ID
CLI での構成の手動アップグレード
Satellite のストレージ構成をアップグレードすることで、同じメジャーバージョン内で最新のストレージテンプレートのリビジョンを取得できます。
-
Satellite ストレージ構成をリストし、アップグレードする Satellite 構成を書き留めます。
ibmcloud sat storage config ls -
Satellite 構成をアップグレードします。 更新されるのは構成のみであることに注意してください。 この構成を使用する割り当てをアップグレードする場合は、
--include-assignmentsオプションを指定するか、assignment updateコマンドを使用して各割り当てを手動で更新することができます。構成を最新リビジョンにアップグレードするためのコマンド例。
ibmcloud sat storage config upgrade --config CONFIG [--include-assignments]構成およびそれに関連付けられた割り当てを最新のリビジョンにアップグレードするためのコマンド例。
ibmcloud sat storage config upgrade --config CONFIG --include-assignments
API での構成と割り当てのアップグレード
/v2/storage/satellite/updateAssignment API を使用して、新しいクラスターまたはクラスター・グループで割り当てを更新できます。 改訂の更新を適用するには、 updateConfigVersion を true に設定します。
-
以下の要求例をコピーし、更新するクラスター・グループおよび割り当ての変数を置き換えます。
curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/updateAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"groups\": [ \"CLUSTER-GROUPS\" ], \"name\": \"ASSIGNMENT-NAME\", \"updateConfigVersion\": true, \"uuid\": \"ASSIGNMENT-ID\"}" -
要求を実行します。
-
更新を確認するために割り当ての詳細を取得します。
curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
API での割り当ての自動パッチ更新の有効化
/v2/storage/satellite/setAssignmentAutoupgrade API を使用して、割り当ての自動パッチ更新を有効にすることができます。 自動パッチ更新を有効にすると、最新のストレージ・テンプレート・リビジョン (パッチ) が自動的に適用されます。 ただし、メジャー更新は手動で適用する必要があります。
-
以下の要求例をコピーし、更新するクラスター・グループおよび割り当ての変数を置き換えます。
curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/setAssignmentAutoupgrade" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d { "config": "string", "controller": "string", "autopatch": boolean,"assignment" : { "all": boolean, "uuid": ["string", "string", ...], } } -
要求を実行します。
-
割り当ての詳細を取得して、アップグレードを検証します。
curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
Azure Disk Storage を使用するアプリをデプロイする
Azure ディスク・ドライバーを使用して、クラスター・ワークロードで使用可能な PVC を作成できます。
-
前に作成した Azure Disk Storage クラスを参照する PVC を作成します。
apiVersion: v1 kind: PersistentVolumeClaim metadata: name: pvc-azuredisk spec: accessModes: - ReadWriteOnce resources: requests: storage: 10Gi storageClassName: sat-azure-block-silver -
クラスター内に PVC を作成します。
oc apply -f pvc-azuredisk.yaml -
PVC が作成され、状況が
Boundであることを確認します。oc get pvc -
作成した PVC をマウントするステートフル・セットの YAML 構成ファイルを作成します。
apiVersion: apps/v1 kind: StatefulSet metadata: name: statefulset-azuredisk labels: app: nginx spec: podManagementPolicy: Parallel # default is OrderedReady serviceName: statefulset-azuredisk replicas: 1 template: metadata: labels: app: nginx spec: nodeSelector: "kubernetes.io/os": linux containers: - name: statefulset-azuredisk image: mcr.microsoft.com/oss/nginx/nginx:1.19.5 command: - "/bin/bash" - "-c" - set -euo pipefail; while true; do echo $(date) >> /mnt/azuredisk/outfile; sleep 1; done volumeMounts: - name: persistent-storage mountPath: /mnt/azuredisk updateStrategy: type: RollingUpdate selector: matchLabels: app: nginx volumeClaimTemplates: - metadata: name: persistent-storage annotations: volume.beta.kubernetes.io/storage-class: sat-azure-block-silver spec: accessModes: ["ReadWriteOnce"] resources: requests: storage: 10Gi -
クラスター内にポッドを作成します。
oc apply -f statefulset-azuredisk.yaml -
ポッドがデプロイされたことを確認します。 アプリが「
Running」状態になるまで、数分かかる場合があることにご注意ください。oc get podsNAME READY STATUS RESTARTS AGE statefulset-azuredisk 1/1 Running 0 2m58s -
ポッドにログインして、アプリが Azure ディスクに書き込み可能であることを確認します。
oc exec statefulset-azuredisk -it bash -
outfileファイルの内容を表示して、アプリが永続ストレージにデータを書き込めていることを確認します。cat /mnt/azuredisk/outfile出力例
Fri Jul 16 07:49:39 EDT 2021 Fri Jul 16 07:49:39 EDT 2021 Fri Jul 16 07:49:39 EDT 2021 -
ポッドを終了します。
exit
アプリから Azure Disk Storage を削除する
Azure ディスク構成が不要になった場合は、アプリ、PVC、PV、割り当てをクラスターから削除できます。
-
PVC をリストし、削除する PVC の名前をメモします。
oc get pvc -
PVC をマウントするすべてのポッドを削除します。
- 削除する PVC を現在マウントしているポッドをすべてリストします。 ポッドが返されなければ、現在その PVC を使用しているポッドはありません。
oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>" ``` 出力例 ```sh {: screen} app sat-azure-block-platinum ``` 1. PVC を使用するポッドを削除します。 ポッドがデプロイメントまたはステートフル・セットの一部である場合は、デプロイメントまたはステートフル・セットを削除します。 ```sh {: pre} oc delete pod <pod_name> ``` ```sh {: pre} oc delete deployment <deployment_name> ``` ```sh {: pre} oc delete statefulset <statefulset_name> ``` 1. ポッド、デプロイメント、またはステートフル・セットが削除されたことを確認します。 ```sh {: pre} oc get pods ``` ```sh {: pre} oc get deployments ``` ```sh {: pre} oc get statefulset ``` -
PVC を削除します。 Azure Disk ストレージ・クラスの再利用ポリシーは
Deleteであるため、PVC を削除すると、Azure アカウントの PV とディスクが自動的に削除されます。oc delete pvc <pvc_name> -
PV が自動的に削除されたことを確認します。
oc get pv
クラスターから Azure Disk Storage 構成を削除する
クラスターで Azure Disk Storage を使用する予定がもうない場合は、CLI を使用して、ストレージ構成からクラスターの割り当てを解除できます。
ストレージ構成を削除すると、割り当てられているすべてのクラスターからドライバーがアンインストールされることに注意してください。 PVC、PV、データは削除されません。 ただし、クラスターにドライバーを再インストールするまでは、データにアクセスすることはできません。
コンソールからの Azure Disk ストレージ構成の削除
- Satellite ストレージ・ダッシュボードから、削除するストレージ構成を選択します。
- アクション > 削除を選択します。
- ストレージ構成の名前を入力します。
- **「削除」**を選択します。
CLI からの Azure ディスク・ストレージ構成の削除
-
ストレージ割り当てをリストし、クラスターに使用していた割り当てを見つけます。
ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER) -
割り当てを削除します。 割り当てを削除すると、そのストレージ割り当てに含まれていたすべてのクラスターから、ドライバー・ポッドとストレージ・クラスが削除されます。
ibmcloud sat storage assignment rm --assignment <assignment_ID> -
ドライバーがクラスターから削除されたことを確認します。
- クラスターでストレージ・クラスをリストし、ストレージ・クラスが削除されていることを確認します。
oc get sc ``` 2. `kube-system` 名前空間のポッドをリストし、ストレージ・ドライバー・ポッドが削除されていることを確認します。 ```sh {: pre} oc get pods -n kube-system | grep azure ``` -
オプション: ストレージ構成を削除します。
- ストレージ構成をリストします。
ibmcloud sat storage config ls ``` 2. ストレージ構成を削除します。 ```sh {: pre} ibmcloud sat storage config rm --config <config_name> ```
パラメーターのリファレンス
1.30.3 パラメータ参照
| 表示名 | CLI オプション | タイプ | 説明 | デフォルト値 |
|---|---|---|---|---|
| テナント ID | tenantId |
シークレット | ご使用の構成で使用する Azure テナント ID。 テナント ID は、 Azure ポータルで確認するか、az account tenant list コマンドを実行することで確認できます。 |
該当なし |
| サブスクリプション ID | subscriptionId |
シークレット | Azure サブスクリプション ID。 Azure ポータルで「サブスクリプション」を検索して、サブスクリプションのリストを見つけます。 また、az account subscription list コマンドを実行することで、サブスクリプションIDを確認することもできます。 |
該当なし |
| Azure Active Directory クライアント ID | aadClientId |
シークレット | Azure Active Directory クライアント ID。 クライアント ID は、 Azure ポータルで確認するか、az ad sp list --display-name appDisplayName コマンドを実行することで確認できます。 |
該当なし |
| ロケーション | location |
構成 | ご使用の Azure ホストのロケーション。 仮想マシンの設置場所は、 Azure ポータルで確認するか、az vm list コマンドを実行することで確認できます。 場所の例:「useast」。 |
該当なし |
| Azure Active Directory クライアント秘密鍵 | aadClientSecret |
シークレット | Azure Active Directory クライアント秘密鍵。 クライアントシークレットは、 Azure ポータルの「App registrations 」メニューから確認できます。 |
該当なし |
| リソース・グループ | resourceGroup |
構成 | Azure リソース・グループの名前。 リソースグループの詳細については、「 Azure 」ポータルで確認するか、az group list コマンドを実行して確認できます。 |
該当なし |
| 仮想マシン・タイプ | vmType |
構成 | 仮想マシンのタイプは、 Azure ポータルで確認するか、az vm list コマンドを実行することで確認できます。 タイプの例:「standard」または「VMSS」。 |
該当なし |
| ネットワーク・セキュリティー・グループ名 | securityGroupName |
構成 | セキュリティー・グループの名前。 セキュリティグループの詳細については、「 Azure 」ポータルで確認するか、az network nsg list コマンドを実行して確認できます。 |
該当なし |
| 仮想ネットワーク名 | vnetName |
構成 | 仮想ネットワークの名前です。 仮想ネットワークの名前は、 Azure ポータルで確認するか、az network vnet list コマンドを実行することで確認できます。 |
該当なし |
| ワークロード・アイデンティティの使用 | useWorkloadIdentity |
構成 | Microsoft Entra Workload IDを使用する場合は、「true」を設定します。 有効な場合は、ワークロードのクライアントとテナントIDも指定する必要がある。 | false |
| ワークロードID クライアントID | workloadIdentityClientId |
シークレット | Azure の Active Directory (AAD)アプリケーション、またはユーザーに割り当てられた管理対象IDのクライアントID。 az ad sp list --display-name APPLICATION_NAME --query '[0].appId' -otsv コマンドを実行すると AAD アプリケーションのクライアント ID が、az identity show --name USER_ASSIGNED_IDENTITY_NAME --resource-group IDENTITY_RESOURCE_GROUP --query 'clientId' -otsv コマンドを実行するとユーザーに割り当てられた管理対象 ID のクライアント ID がわかります。 |
該当なし |
| ワークロードID テナントID | workloadIdentityTenantId |
シークレット | Azure の Active Directory (AAD)アプリケーション、またはユーザーに割り当てられた管理対象IDのテナントID。 AAD アプリケーションまたはユーザーに割り当てられた管理対象 ID がクラスターと同じテナントにない場合は、それぞれ AAD アプリケーションまたはユーザーに割り当てられた管理対象 ID の「 tenantID 」を設定してください。 az ad sp list --display-name APPLICATION_NAME --query '[0].appOwnerOrganizationId' -otsv コマンドを実行すると AAD アプリケーションのテナント ID が、az identity show --name USER_ASSIGNED_IDENTITY_NAME --resource-group IDENTITY_RESOURCE_GROUP --query 'tenantId' -otsv コマンドを実行するとユーザーに割り当てられた管理対象 ID のテナント ID がわかります。 |
該当なし |
| OpenTelemetry トレースを有効にする | enableOtelTracing |
構成 | OpenTelemetry のトレースを有効にしたい場合は、この設定を「true」に設定してください。 有効な場合は、 OpenTelemetry サービス名とエクスポータ・エンドポイントも指定する必要がある。 | false |
| OpenTelemetry サービス名 | otelServiceName |
構成 | OpenTelemetry トレース用サービス名 | 該当なし |
| OpenTelemetry エクスポート・エンドポイント | otelExporterEndpoint |
構成 | OpenTelemetry エクスポーターのエンドポイント | 該当なし |
| ホスト・ネットワークを使う | useHostNetwork |
構成 | ホスト・ネットワークを使用したい場合は「true」を設定する。 有効な場合、liveness-probe HTTP のエンドポイントはポート29602のlocalhostに設定される。 | false |
Azure ディスクのストレージ・クラス・リファレンス
| ストレージ・クラス名 | ディスクあたりの IOPS 範囲 | サイズ範囲 | ディスク・タイプ | 再利用ポリシー | ボリューム・バインディング・モード |
|---|---|---|---|---|---|
sat-azure-block-platinum |
1200 から 160000 | 4 GiB から 64 TiB | SSD | の削除 | 即時 |
sat-azure-block-platinum-metro |
1200 から 160000 | 4 GiB から 64 TiB | SSD | の削除 | WaitForFirstConsumer |
sat-azure-block-gold |
120 から 20000 | 32 GiB から 32 TiB | SSD | の削除 | 即時 |
sat-azure-block-gold-metro デフォルト |
120 から 20000 | 32 GiB から 32 TiB | SSD | の削除 | WaitForFirstConsumer |
sat-azure-block-silver |
120 から 6000 | 該当なし | SSD | の削除 | 即時 |
sat-azure-block-silver-metro |
120 から 6000 | 該当なし | SSD | の削除 | WaitForFirstConsumer |
sat-azure-block-bronze |
500 から 2000 | 32 GiB から 32 TiB | HDD | の削除 | 即時 |
sat-azure-block-bronze-metro |
500 から 2000 | 32 GiB から 32 TiB | HDD | の削除 | WaitForFirstConsumer |
Azure ディスク・ストレージのヘルプとサポートの利用
Azure Disk Storageを使用する場合、サポートケースを開く前に、以下のリソースをお試しください。
- Azure Knowledge Centerで FAQ を確認してください。
- 一般的な問題をトラブルシューティングして解決するには、 トラブルシューティング資料 を参照してください。
- 「 ステータス」ページにアクセスして、 IBM Cloud プラットフォームおよびリソースのステータスを確認してください。
- Stack Overflow で、他のユーザーが同じ問題を経験しているかどうかを確認します。 質問には
ibm-cloudとAzure-Diskのタグを付けてください。 - 詳しくは、 Azure サービス・ポータル を検索してください。