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

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

   用于创建 V 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"
   

   用于创建 V 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 CloudIAM 令牌。

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

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

   用于创建 V 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\",}
   

   用于创建 V 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\",}
   

   用于创建 V 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. 获取要向其分配存储器的集群，集群组或服务的标识。

   要确保集群已向 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"
   

部署使用 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 的 pod 创建 YAML 配置文件。 以下示例创建一个 nginx pod，用于将当前日期和时间写入 ONTAP-NAS 卷安装路径上的 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. 在群集中创建 pod。

   oc apply -f pod.yaml
   

6. 验证 pod 是否已部署。 请注意，应用程序进入 Running 状态可能需要几分钟时间。

   oc get pods
   

   示例输出

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

7. 验证应用程序是否可以写入 ONTAP-NAS 实例。

   1. 登录到 pod。

      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. 退出 pod。

      exit