在主控台中建立及指派配置

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。

   建立 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 登錄，或要建立群組，請參閱 Setting up clusters to use with 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. 建立 Pod 的 YAML 配置檔，以裝載您所建立的 PVC。 下列範例會建立 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