在控制台中创建和分配配置

1. 查看 参数参考。

2. 从 "位置" 控制台，选择要在其中创建存储配置的位置。

3. 选择 存储器 > 创建存储器配置

4. 输入配置名称。

5. 选择存储类型。

6. 选择版本并单击下一步

7. 如果您选择的 存储器类型 接受定制参数，请在 参数 选项卡上输入这些参数。

8. 如果您选择的 存储器类型 需要私钥，请在 私钥 选项卡上输入私钥。

9. 在 存储类 选项卡上，查看配置所部署的存储类或创建定制存储类。

10. 在 分配给服务 选项卡上，选择要将配置分配给的服务。

11. 单击 完成 以分配存储器配置。

在 CLI 中创建配置

1. 查看要使用的模板版本的 参数参考。

2. 登录到 IBM Cloud CLI。

   ibmcloud login
   

3. 列出 Satellite 位置并记下 Managed from 列。

   ibmcloud sat location ls
   

4. 将 Satellite 位置的 Managed from 区域作为目标。 例如，对于 wdc target us-east。 有关更多信息，请参阅 Satellite 区域。

   ibmcloud target -r us-east
   

5. 如果使用除 default 以外的资源组，请将其作为目标。

   ibmcloud target -g <resource-group>
   

6. 针对要使用的模板版本，复制以下某个示例命令。 有关该命令的更多信息，请参阅 命令参考 中的 ibmcloud sat storage config create。

   用于创建 V 1.0.0 配置的示例命令。

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-storage --template-version 1.0.0 --param "install-local-storage-file=INSTALL-LOCAL-STORAGE-FILE"  --param "auto-discover-devices-file=AUTO-DISCOVER-DEVICES-FILE"  [--param "file-nodes-label-key=FILE-NODES-LABEL-KEY"]  [--param "file-nodes-label-value=FILE-NODES-LABEL-VALUE"]  [--param "file-devicepath=FILE-DEVICEPATH"]  --param "fstype=FSTYPE"  --param "install-local-storage-block=INSTALL-LOCAL-STORAGE-BLOCK"  --param "auto-discover-devices-block=AUTO-DISCOVER-DEVICES-BLOCK"  [--param "block-nodes-label-key=BLOCK-NODES-LABEL-KEY"]  [--param "block-nodes-label-value=BLOCK-NODES-LABEL-VALUE"]  [--param "block-devicepath=BLOCK-DEVICEPATH"]
   

7. 根据要使用的设置定制命令。

8. 运行命令创建配置。

9. 验证是否已创建配置。

   ibmcloud sat storage config get --config CONFIG
   

在 API 中创建配置

1. 生成 API 密钥，然后请求刷新令牌。 有关详细信息，请参阅 使用 API 密钥生成IBM CloudIAM 令牌。

2. 查看要使用的模板版本的 参数参考。

3. 复制以下某个示例请求并替换要使用的变量。

   用于创建 V 1.0.0 配置的示例请求。

   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-storage\", \"storage-template-version\": \"1.0.0\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"INSTALL-LOCAL-STORAGE-FILE\", { \"entry.name\": \"AUTO-DISCOVER-DEVICES-FILE\", { \"entry.name\": \"FILE-NODES-LABEL-KEY\", { \"entry.name\": \"FILE-NODES-LABEL-VALUE\", { \"entry.name\": \"FILE-DEVICEPATH\", { \"entry.name\": \"FSTYPE\", { \"entry.name\": \"INSTALL-LOCAL-STORAGE-BLOCK\", { \"entry.name\": \"AUTO-DISCOVER-DEVICES-BLOCK\", { \"entry.name\": \"BLOCK-NODES-LABEL-KEY\", { \"entry.name\": \"BLOCK-NODES-LABEL-VALUE\", { \"entry.name\": \"BLOCK-DEVICEPATH\",\"user-secret-parameters\": }
   

在 CLI 中创建任务

1. 列出存储配置，并记下要分配给集群的存储配置。

   ibmcloud sat storage config ls
   

2. 获取要向其分配存储器的集群，集群组或服务的标识。

   要确保集群已向 Satellite 配置注册或要创建组，请参阅 设置集群以与 Satellite 配置配合使用。

   用于列出集群组的示例命令。

   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"
   

从控制台中除去存储器配置

1. 从 Satellite 存储仪表板中，选择要删除的存储配置。
2. 选择 操作 > 删除。
3. 输入存储器配置的名称。
4. 选择删除。

从命令行除去本地存储器配置

1. 列出 local-storage 名称空间中的资源。 删除存储器分配时，将除去这些资源。

   oc get all -n local-storage
   

   示例输出

   NAME                                         READY   STATUS    RESTARTS   AGE
   pod/local-disk-local-diskmaker-clvg6         1/1     Running   0          29h
   pod/local-disk-local-diskmaker-kqddq         1/1     Running   0          29h
   pod/local-disk-local-diskmaker-p6z9q         1/1     Running   0          29h
   pod/local-disk-local-provisioner-dw5g7       1/1     Running   0          29h
   pod/local-disk-local-provisioner-hxd9n       1/1     Running   0          29h
   pod/local-disk-local-provisioner-tfg95       1/1     Running   0          29h
   pod/local-storage-operator-df4994656-7826l   1/1     Running   0          29h
   
   NAME                             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)     AGE
   service/local-storage-operator   ClusterIP   172.21.147.17   <none>        60000/TCP   29h
   
   NAME                                          DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/local-disk-local-diskmaker     3         3         3       3            3           <none>          29h
   daemonset.apps/local-disk-local-provisioner   3         3         3       3            3           <none>          29h
   
   NAME                                     READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/local-storage-operator   1/1     1            1           29h
   
   NAME                                               DESIRED   CURRENT   READY   AGE
   replicaset.apps/local-storage-operator-df4994656   1         1         1       29h
   

2. 列出存储器分配并查找用于集群的存储分配。

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

3. 除去分配。 除去分配后，将从属于存储分配的所有集群中除去本地存储驱动程序 pod 和存储类。

   ibmcloud sat storage assignment rm --assignment <assignment_ID>
   

4. 列出 local-storage 名称空间中的资源，并验证是否已除去本地存储驱动程序 pod。

   oc get all -n local-storage
   

   示例输出

   No resources found in local-storage namespace.
   

5. 列出集群中的存储类，并验证是否已除去本地存储类。

   oc get sc
   

6. 可选: 除去存储器配置。

   1. 列出存储配置。

      ibmcloud sat storage config ls
      

   2. 除去存储器配置。

      ibmcloud sat storage config rm --config <config_name>
      

7. 列出 PVC 并记下要除去的 PVC 的名称。

   oc get pvc
   

8. 移除目前安装 PVC 的任何 pod。

   1. 列出当前安装要删除的 PVC 的所有 pod。 如果未返回任何 pod，那么您当前没有任何使用 PVC 的 pod。

      oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
      

      示例输出

      app    sat-local-block-gold
      

   2. 除去使用 PVC 的 pod。 如果 pod 是部署的一部分，请除去该部署。

      oc delete pod <pod_name>
      

      oc delete deployment <deployment-name>
      

   3. 验证是否已除去 pod 或部署。

      oc get pods
      

      oc get deployments
      

9. 删除 PVC。 由于使用 Retain 回收策略指定了所有 IBM提供的本地块存储类，因此在删除应用程序或部署时不会自动删除 PV 和 PVC。

   oc delete pvc <pvc-name>
   

10. 确认您的 PVC 已移除。

    oc get pvc
    

11. 列出 PV 并记下要除去的 PV 的名称。

    oc get pv
    

12. 删除 PV。 删除 PV 将使磁盘可用于其他工作负载。

    oc delete pv <pv-name>
    

13. 验证您的 PV 是否已移除。

    oc get pv