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

1. パラメーターのリファレンスを確認します。

2. Locationsコンソールから、ストレージ構成を作成する場所を選択します。

3. ストレージ > ストレージ構成の作成を選択します。

4. 構成の名前を入力します。

5. ストレージタイプを選択します。

6. バージョンを選択し、「次へ」をクリックします

7. 選択した 「ストレージ・タイプ」 がカスタム・パラメーターを受け入れる場合は、 「パラメーター」 タブでそれらのパラメーターを入力します。

8. 選択した ストレージ・タイプ にシークレットが必要な場合は、 「シークレット (Secrets)」 タブに入力します。

9. ストレージ・クラスタブで、構成によってデプロイされたストレージ・クラスを確認するか、カスタム・ストレージ・クラスを作成します。

10. サービスへの割り当てタブで、構成の割り当て先となるサービスを選択します。

11. 完了をクリックして、ストレージ構成を割り当てます。

CLI での構成の作成

1. 使用するテンプレート・バージョンの パラメーター・リファレンス を確認します。

2. IBM Cloud CLI にログインします。

   ibmcloud login
   

3. Satellite ロケーションをリストして、Managed from 列をメモします。

   ibmcloud sat location ls
   

4. Satellite ロケーションの Managed from リージョンをターゲットにします。 例えば、wdc の場合は、us-east をターゲットにします。 詳しくは、Satellite リージョンを参照してください。

   ibmcloud target -r us-east
   

5. default 以外のリソース・グループを使用する場合は、そのリソース・グループをターゲットにします。

   ibmcloud target -g <resource-group>
   

6. 使用するテンプレート・バージョンについて、以下のいずれかのコマンド例をコピーします。 コマンドについて詳しくは、 コマンド・リファレンス の ibmcloud sat storage config create を参照してください。

   バージョン 22.04 の構成を作成するコマンドの例を示します。

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-nas --template-version 22.04 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "exportPolicy=EXPORTPOLICY"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"  --param "nfsMountOptions=NFSMOUNTOPTIONS"
   

   バージョン 22.10 の構成を作成するコマンドの例を示します。

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-nas --template-version 22.10 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "exportPolicy=EXPORTPOLICY"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"  --param "nfsMountOptions=NFSMOUNTOPTIONS"
   

   バージョン 24.02 構成を作成するコマンド例。

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-nas --template-version 24.02 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "exportPolicy=EXPORTPOLICY"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"  --param "nfsMountOptions=NFSMOUNTOPTIONS"
   

7. 使用する設定に基づいて、コマンドをカスタマイズします。

8. コマンドを実行してコンフィギュレーションを作成する。

9. コンフィギュレーションが作成されたことを確認する。

   ibmcloud sat storage config get --config CONFIG
   

API での構成の作成

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

2. 使用するテンプレート・バージョンの パラメーター・リファレンス を確認します。

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

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

   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-ontap-nas\", \"storage-template-version\": \"22.04\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"EXPORTPOLICY\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\", { \"entry.name\": \"NFSMOUNTOPTIONS\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
   

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

   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-ontap-nas\", \"storage-template-version\": \"22.10\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"EXPORTPOLICY\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\", { \"entry.name\": \"NFSMOUNTOPTIONS\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
   

   バージョン 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-ontap-nas\", \"storage-template-version\": \"24.02\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"EXPORTPOLICY\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\", { \"entry.name\": \"NFSMOUNTOPTIONS\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
   

4. ストレージ構成が作成されたことを確認します。

   ibmcloud sat storage config get --config <config>
   

CLIで課題を作成する

1. ストレージ構成をリストアップし、クラスタに割り当てるストレージ構成をメモしておきます。

   ibmcloud sat storage config ls
   

2. ストレージを割り当てるクラスタ、クラスタグループ、またはサービスのIDを取得します。

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

   クラスター・グループをリストするコマンドの例。

   ibmcloud sat group ls
   

   クラスターをリストするコマンドの例。

   ibmcloud oc cluster ls --provider satellite
   

   Satellite サービスをリストするコマンドの例。

   ibmcloud sat service ls --location <location>
   

3. 以前に取得したクラスター、グループ、またはサービスにストレージ構成を割り当てます。 詳しくは、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
   

4. 割り当てが作成されたことを確認します。

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

API でのストレージ割り当ての作成

1. 以下のいずれかの要求例をコピーします。

   構成をクラスターに割り当てる要求の例。

   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\"}"
   

2. 変数を自分の詳細に置き換え、要求を実行します。

3. 割り当てをリストして、割り当てが作成されたことを確認します。

   curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
   

コンソールでのストレージ割り当ての更新

Satellite コンソール を使用して、割り当てに最新のパッチ更新を適用できます。

1. Satellite コンソールの 「ロケーション」 ページで、ロケーションを選択します。

2. 「ストレージ」 タブをクリックして、構成を表示します。

3. 更新したい設定をクリックします。

4. 「情報」 (i) アイコンをクリックして、最新のリビジョンまたはパッチを適用します。

5. オプション: ストレージ割り当ての自動パッチ更新を有効にします。 自動パッチ更新を有効にすると、割り当てに常に最新のセキュリティー・フィックスが適用されます。

自動パッチ更新を有効にした場合でも、メジャー更新を手動で適用する必要があります。

CLI での割り当ての手動アップグレード

最新のストレージ・テンプレート・リビジョンを使用するように割り当てをアップグレードします。

1. Satellite ストレージ割り当てをリストし、アップグレードする Satellite 割り当てを書き留めます。

   ibmcloud sat storage assignment ls
   

2. Satellite ストレージ・テンプレートをリストして、使用可能な最新バージョンを確認します。

   ibmcloud sat storage template ls
   

3. Satellite 割り当てをアップグレードします。

   割り当てをアップグレードするコマンドの例。

   ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT
   

CLI での構成および割り当ての自動パッチ更新の有効化

sat storage assignment autopatch enable CLI を使用して、割り当ての自動パッチ更新を有効にすることができます。 自動パッチ更新を有効にすると、最新のストレージ・テンプレート・リビジョン (パッチ) が自動的に適用されます。 ただし、メジャー更新は手動で適用する必要があります。

1. Satellite ストレージ構成をリストします。 コンフィギュレーションIDをメモしておく。

   ibmcloud sat storage assignment ls
   

2. 以下のいずれかのコマンド例を実行して、ご使用の構成とその関連割り当てに対して自動パッチ更新を有効にします。 前のステップで取得したコンフィグレーション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
   

API での構成と割り当てのアップグレード

/v2/storage/satellite/updateAssignment API を使用して、新しいクラスターまたはクラスター・グループで割り当てを更新できます。 改訂の更新を適用するには、 updateConfigVersion を true に設定します。

1. 以下の要求例をコピーし、更新するクラスター・グループおよび割り当ての変数を置き換えます。

   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\"}"
   

2. 要求を実行します。

3. 更新を確認するために割り当ての詳細を取得します。

   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 を使用して、割り当ての自動パッチ更新を有効にすることができます。 自動パッチ更新を有効にすると、最新のストレージ・テンプレート・リビジョン (パッチ) が自動的に適用されます。 ただし、メジャー更新は手動で適用する必要があります。

1. 以下の要求例をコピーし、更新するクラスター・グループおよび割り当ての変数を置き換えます。

   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", ...], } }
   

2. 要求を実行します。

3. 割り当ての詳細を取得して、アップグレードを検証します。

   curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
   

ONTAP-NAS ストレージを使用するアプリのデプロイ

trident-kubectl-nas ドライバーを使用して、NetApp ONTAP-NAS ストレージを使用するアプリをクラスターにデプロイできます。

1. sat-netapp ストレージ・クラスのいずれかを使用する PVC 構成ファイルを作成します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: netapp-pvc
   spec:
     accessModes:
     - ReadWriteMany
     storageClassName: sat-netapp-file-gold
     resources:
     requests:
       storage: 10Gi
   

2. クラスター内に PVC を作成します。

   oc apply -f pvc.yaml
   

3. PVC が作成されたことを確認します。 PVC が Bound 状況であることを確認します。

   oc get pvc
   

   出力例

   NAME         STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS           AGE
   netapp-pvc   Bound    pvc-acd9e5b4-0b24-4e20-ac00-69a05148c799   10Gi       RWX            sat-netapp-file-gold   39s
   

4. 作成した PVC をマウントするポッドの YAML 構成ファイルを作成します。 以下の例では、ONTAP-NAS ボリューム・マウント・パスにある nginx ファイルに現在の日時を書き込む test.txt ポッドを作成します。

   apiVersion: v1
   kind: Pod
   metadata:
       name: app
   spec:
       containers:
       - name: app
       image: nginx
       command: ["/bin/sh"]
       args: ["-c", "while true; do echo $(date -u) >> /test/test.txt; sleep 5; done"]
       volumeMounts:
       - name: persistent-storage
           mountPath: /test
       volumes:
       - name: persistent-storage
       persistentVolumeClaim:
           claimName: netapp-pvc
   

5. クラスター内にポッドを作成します。

   oc apply -f pod.yaml
   

6. ポッドがデプロイされたことを確認します。 アプリが Running 状態になるまでに数分かかることがあることに注意してください。

   oc get pods
   

   出力例

   NAME                                READY   STATUS    RESTARTS   AGE
   app   1/1     Running   0          50s
   

7. アプリが ONTAP-NAS インスタンスに書き込めることを確認します。

   1. ポッドにログインします。

      oc exec app -it bash
      

   2. test.txt ファイルの内容を表示して、アプリが永続ストレージにデータを書き込めていることを確認します。

      cat /test/test.txt
      

      出力例

      Wed May 19 13:28:31 UTC 2021
      Wed May 19 13:28:37 UTC 2021
      Wed May 19 13:28:42 UTC 2021
      Wed May 19 13:28:47 UTC 2021
      

   3. ポッドを終了します。

      exit