NetApp Trident オペレーター

IBM Cloud Satellite® クラスタ向けに NetApp Trident ストレージを設定します。 Satellite ストレージ・テンプレートを使用して、ストレージ構成を作成できます。ストレージ構成をクラスターに割り当てると、選択したストレージ・プロバイダーのストレージ・ドライバーがクラスターにインストールされます。

NetApp ONTAP-NAS テンプレートまたは NetApp ONTAP-SAN テンプレートを使用して構成を作成する前に、NetApp Trident テンプレートをクラスターにデプロイしておく必要があります。

お使いのロケーション内のクラスターにストレージテンプレートをデプロイする前に、コンソールで「 Satellite Config のクラスター管理者アクセスを有効にする 」オプションを選択するか、クラスター作成時に --enable-config-admin オプションを指定して、 Satellite Config を設定してください。

Satellite のストレージサービスをリソースグループにスコープ設定することはできません。ただし、ロケーションやクラスターなどの他のリソースをリソースグループにスコープ設定する場合は、アカウントすべてのリソースに対して、 Satellite の「リーダー」および「リンク管理者」の役割を追加する必要があります。

NetApp Trident の前提条件

Satellite ロケーションを作成します。

コンソールでの構成の作成と割り当て

[ロケーション]コンソールから、ストレージ構成を作成するロケーションを選択します。
ストレージ > ストレージ構成の作成を選択します。
構成の名前を入力します。
ストレージの種類を選択してください。
バージョンを選択し、「次へ」をクリックしてください
選択した 「ストレージ・タイプ」 がカスタム・パラメーターを受け入れる場合は、 「パラメーター」 タブでそれらのパラメーターを入力します。
選択した ストレージ・タイプ にシークレットが必要な場合は、 「シークレット (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 を参照してください。

バージョン 24.02 構成を作成するコマンド例。
```
ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 24.02
```
バージョン 25.06 のコンフィギュレーションを作成するコマンド例。
```
ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 25.06
```
使用する設定に基づいて、コマンドをカスタマイズします。
設定を作成するには、コマンドを実行してください。
設定が作成されたことを確認してください。
```
ibmcloud sat storage config get --config CONFIG
```

API での構成の作成

API キーを生成してから、リフレッシュ・トークンを要求します。詳しくは、API キーを使用した IBM Cloud IAM トークンの生成を参照してください。

以下のいずれかの要求例をコピーし、使用する変数を置き換えます。

バージョン 24.02 構成を作成する要求の例。

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\": \"netapp-trident\", \"storage-template-version\": \"24.02\", \"update-assignments\": true}

バージョン 25.06 のコンフィギュレーションを作成するリクエスト例。

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\": \"netapp-trident\", \"storage-template-version\": \"25.06\", \"update-assignments\": true}

CLI での課題の作成

ストレージ構成を一覧表示し、クラスタに割り当てたいストレージ構成をメモしておいてください。
```
ibmcloud sat storage config ls
```
ストレージを割り当てたいクラスタ、クラスタグループ、またはサービスのIDを取得します。

クラスターが Satellite Config に登録されていることを確認したり、グループを作成したりするには、Satellite Config で使用するためのクラスターのセットアップを参照してください。

クラスター・グループをリストするコマンドの例。
```
ibmcloud sat group ls
```
クラスターをリストするコマンドの例。
```
ibmcloud oc cluster ls --provider satellite
```
Satellite サービスをリストするコマンドの例。
```
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"

コンソールからの NetApp Trident ストレージ割り当ておよび構成の削除

コンソールを使用して、ストレージ割り当ておよびストレージ構成を除去します。

Satellite ストレージ・ダッシュボードから、削除するストレージ構成を選択します。
アクション > 削除を選択します。
ストレージ構成の名前を入力します。
**「削除」**を選択します。

CLI からの NetApp Trident のストレージ割り当ておよびストレージ構成の削除

CLI を使用して、ストレージ割り当ておよびストレージ構成を削除します。

ストレージ割り当てをリストし、クラスターに使用していた割り当てを見つけます。

ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

割り当てを削除します。割り当てを削除すると、そのストレージ割り当てに含まれていたすべてのクラスターから、NetApp Trident のドライバー・ポッドとストレージ・クラスが削除されます。
```
ibmcloud sat storage assignment rm --assignment ASSIGNMENT_ID
```
trident 名前空間のポッドをリストし、NetApp Trident ストレージ・ドライバー・ポッドが削除されていることを確認します。
```
oc get pods -n trident
```
trident 名前空間が削除されたことを確認します。
```
oc get ns
```
trident 名前空間が Terminating 状況のままである場合は、名前空間を削除する手順に従います。あるいは、『 NetApp 』のドキュメントに従って、 Tridentオペレーターをアンインストールすることもできます。
オプション: ストレージ構成をリストして、Trident 構成を削除します。
```
ibmcloud sat storage config ls
```
```
ibmcloud sat storage config rm --config CONFIG_NAME
```

NetApp Trident のヘルプおよびサポートの利用

NetApp Trident で問題が発生した場合は、 NetApp のサポートページをご覧ください。