IBM Cloud Docs
本地存储器操作员

本地存储器操作员

使用本地块或文件卷为 IBM Cloud Satellite® 集群设置持久存储器。 您可以使用 Satellite 存储模板来创建存储配置。 将存储器配置分配给集群时，所选存储器提供者的存储器驱动程序将安装在集群中。

在可以将存储器模板部署到您所在位置的集群之前，请确保通过在控制台中选择 对 Satellite 配置启用集群管理访问权 选项或者在创建集群时包含 --enable-config-admin 选项来设置 Satellite 配置。

不能将 Satellite 存储服务的作用域限定为资源组。 但是，如果要将其他资源 (例如，位置和集群) 限定为资源组，那么需要为帐户中的所有资源添加 Satellite 阅读器和链接管理员角色。

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

  1. 从 "位置" 控制台，选择要在其中创建存储配置的位置。
  2. 选择 存储器 > 创建存储器配置
  3. 输入配置名称。
  4. 选择 存储类型。
  5. 选择版本，然后单击下一步
  6. 如果您选择的 存储器类型 接受定制参数，请在 参数 选项卡上输入这些参数。
  7. 如果您选择的 存储器类型 需要私钥，请在 私钥 选项卡上输入私钥。
  8. 在 存储类 选项卡上，查看配置所部署的存储类或创建定制存储类。
  9. 在 分配给服务 选项卡上，选择要将配置分配给的服务。
  10. 单击 完成 以分配存储器配置。

在 CLI 中创建配置

  1. 登录到 IBM Cloud CLI。

    ibmcloud login

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

    ibmcloud sat location ls

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

    ibmcloud target -r us-east

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

    ibmcloud target -g <resource-group>

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

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

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-storage-operator --template-version 1.0.0

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

  7. 运行命令创建配置。

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

    ibmcloud sat storage config get --config CONFIG

在 API 中创建配置

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

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

    用于创建 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-operator\", \"storage-template-version\": \"1.0.0\", \"update-assignments\": true}

在 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

在 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"