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

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

2. [ロケーション]コンソールから、ストレージ構成を作成するロケーションを選択します。

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 を参照してください。

   バージョン 4.9 構成を作成するためのコマンド例。

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-file --template-version 4.9 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"  --param "fstype=FSTYPE"
   

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

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-file --template-version 4.10 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"  --param "fstype=FSTYPE"
   

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

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-file --template-version 4.11 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"  --param "fstype=FSTYPE"
   

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

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-file --template-version 4.12 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"  --param "fstype=FSTYPE"
   

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

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-file --template-version 4.13 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"  --param "fstype=FSTYPE"
   

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

8. 設定を作成するには、コマンドを実行してください。

9. 設定が作成されたことを確認してください。

   ibmcloud sat storage config get --config CONFIG
   

アプリケーション・プログラミング・インターフェース（API）での設定の作成

1. API キーを生成してから、リフレッシュ・トークンを要求します。 詳細については、「 API キーを使用した IAM（ IBM Cloud Identity and Access Management ）トークンの生成 」を参照してください。

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

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

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

   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\": \"local-volume-file\", \"storage-template-version\": \"4.9\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\", { \"entry.name\": \"FSTYPE\",\"user-secret-parameters\": }
   

   バージョン 4.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\": \"local-volume-file\", \"storage-template-version\": \"4.10\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\", { \"entry.name\": \"FSTYPE\",\"user-secret-parameters\": }
   

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

   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\": \"local-volume-file\", \"storage-template-version\": \"4.11\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\", { \"entry.name\": \"FSTYPE\",\"user-secret-parameters\": }
   

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

   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\": \"local-volume-file\", \"storage-template-version\": \"4.12\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\", { \"entry.name\": \"FSTYPE\",\"user-secret-parameters\": }
   

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

   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\": \"local-volume-file\", \"storage-template-version\": \"4.13\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\", { \"entry.name\": \"FSTYPE\",\"user-secret-parameters\": }
   

コマンドラインインターフェース（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
   

CLI での構成の手動アップグレード

Satellite のストレージ構成をアップグレードすることで、同じメジャーバージョン内で最新のストレージテンプレートのリビジョンを取得できます。

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

   ibmcloud sat storage config ls
   

2. 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 に設定します。

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"
   

4. ストレージ構成リソースがデプロイされたことを確認します。 local-storage 名前空間のすべてのリソースのリストを取得します。

   oc get all -n local-storage
   

   出力例

   NAME                                         READY   STATUS    RESTARTS   AGE
   pod/local-disk-local-diskmaker-cpk4r         1/1     Running   0          30s
   pod/local-disk-local-provisioner-xstjh       1/1     Running   0          30s
   pod/local-storage-operator-96c444dfc-ttpmq   1/1     Running   0          35s
   NAME                             TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)     AGE
   service/local-storage-operator   ClusterIP   172.21.173.238   <none>        60000/TCP   32s
   NAME                                          DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/local-disk-local-diskmaker     1         1         1       1            1           <none>          31s
   daemonset.apps/local-disk-local-provisioner   1         1         1       1            1           <none>          31s
   NAME                                     READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/local-storage-operator   1/1     1            1           36s
   NAME                                               DESIRED   CURRENT   READY   AGE
   replicaset.apps/local-storage-operator-96c444dfc   1         1         1       37s
   

5. 使用可能なストレージ・クラスをリストします。

   oc get sc -n local-storage | grep local
   

   出力例

   sat-local-file-gold       kubernetes.io/no-provisioner   Delete          WaitForFirstConsumer   false                  21m
   

6. PV をリストし、状況が Available であることを確認します。 構成の作成時に指定したローカル・ディスクが、永続ボリュームとして使用できるようになっています。

   oc get pv
   

   出力例

   NAME               CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS          REASON   AGE
   local-pv-1d14680   50Gi       RWO            Delete           Available           sat-local-file-gold            50s
   

7. ローカル PV を参照する PVC を作成してから、ローカル・ストレージを使用するアプリをデプロイします。