從主控台安裝 OpenShift Data Foundation 附加程式

若要在叢集裡安裝 ODF，請完成下列步驟。

在啟用附加程式之前，請先檢閱 變更日誌，以取得最新版本資訊。 此外，請 檢閱參數參考 以瞭解安裝選項。

1. 從 主控台，選擇要安裝附加元件的群集。
2. 在 OpenShift Data Foundation 卡上，按一下安裝。 安裝 ODF 面板會打開。
3. 在「安裝 ODF」畫面中，輸入您要用於 ODF 部署的配置參數。

計費類型

Essentials 或 Advanced 作為您的帳單計劃。 如需計費類型的相關資訊，請參閱 依計費類型的特性支援。

儲存空間類別

請輸入您要使用的儲存類別。

• 對於使用虛擬機器的 VPC 集群，請選擇遠端佈建，以便使用 Block Storage for VPC 為 ODF 動態佈建磁碟區。
• 對於使用 Bare Metal Servers for VPC 工作節點的 VPC 群集，請選擇「本端儲存」。 如果您要自動發現工作站節點上的可用儲存裝置，並在 ODF 中使用它們，請選擇本機磁碟發現。

OSD 儲存類別名稱

請輸入您要用來配置儲存卷的儲存類別名稱。

• 對於具有 Bare Metal Servers for VPC 工作節點的 VPC 群集，請選擇 localblock。
• 對於多區群集，請使用 VolumeBindingMode 的儲存類別 WaitForFirstConsumer。
• 如需儲存類別清單，請參閱儲存類別 參考。

OSD pod 大小

請輸入您要配置的磁碟區大小。 至少輸入 512Gi。

工作者節點

輸入您要部署 ODF 的工作節點的節點名稱。 您必須至少輸入 3 個工作者節點名稱。 若要尋找您的節點名稱，請在您的群集中執行 oc get nodes 指令。 Node 名稱必須以逗號分隔，名稱之間不得有空格。 例如：10.240.0.24,10.240.0.26,10.240.0.25。 如果要在所有工作站節點上部署 ODF，請將此欄位留空。

需要 OSD 磁碟數目

輸入要在每個工作站節點上配置的 OSD 磁碟 (應用程式儲存空間) 數量。

啟用叢集加密

如果要加密 ODF 系統 pod 使用的 OSD 磁碟區 (群集範圍加密)，請選取此選項。

啟用磁區加密

如果要啟用應用程式磁碟區 (應用程式儲存空間) 的加密，請選取此選項。

• 在 實例名稱 欄位中，輸入 Hyper Protect Crypto Services 或 Key Protect 實例的唯一名稱。
• 在 實例類型 欄位中，輸入加密實例的類型。
• 在 實例 ID 欄位中，輸入 Hyper Protect Crypto Services 或 Key Protect 實例 ID。 例如: d11a1a43-aa0a-40a3-aaa9-5aaa63147aaa。
• 在 密鑰名稱 欄位中，輸入您使用 Hyper Protect Crypto Services 或 Key Protect 認證建立的密鑰名稱。 例如: ibm-hpcs-secret。
• 在 Base URL 欄位中，輸入 Hyper Protect Crypto Services 或 Key Protect 實例的公用端點。 例如: https://api.eu-gb.hs-crypto.cloud.ibm.com:8389。
• 在令牌 URL 欄位中，輸入 https://iam.cloud.ibm.com/identity/token。

1. 輸入您要使用的參數之後，請按一下 安裝

2. 請等待幾分鐘，直到外掛程式部署完成為止。 部署完成時，附加程式狀態為 Normal - Addon Ready。

3. 驗證您的安裝。 存取您的 Red Hat OpenShift 叢集。

4. 執行下列指令，以驗證 ODF Pod 是否在執行中。

   oc get pods -n openshift-storage
   

下一步

部署使用 ODF 的應用程式。

從 CLI 安裝附加程式

您可以使用 ibmcloud oc cluster addon enable 指令 來安裝附加程式。

1. 檢閱 VPC 參數參照。 當您啟用附加程式時，可以針對您要置換的每一個參數指定 --param "key=value" 選項來置換預設值。

2. 存取您的 Red Hat OpenShift 叢集。

3. 列出 openshift-data-foundation 附加程式版本。 請記下預設版本，並決定您要安裝的版本。

   ibmcloud ks cluster addon versions
   

4. 在啟用附加程式之前，請先檢閱 變更日誌，以取得最新版本資訊。 請注意，附加程式支援 n+1 叢集版本。 例如，您可以將附加程式 4.10.0 版部署至 OCP 4.9 或 4.11 叢集。 如果您具有非預設叢集版本，則在啟用附加程式時必須指定 --version 選項。

5. 檢閱附加程式選項。

   ibmcloud oc cluster addon options --addon openshift-data-foundation --version 4.15.0
   

   為了獲得最佳效能，建議包含指定為 performance 的 resourceProfile 選項。 此選項有助於在部署期間根據資源可用性獲得增強的性能等級。 有關「resourceProfile」選項的更多資訊，請參閱《 Red Hat OpenShift ODF 文件》中的「效能分析」章節。

   版本 4.15.0 的附加元件選項範例

   Add-on Options
   Option                            Default Value
   osdStorageClassName               ibmc-vpc-block-metro-10iops-tier
   ocsUpgrade                        false
   billingType                       advanced
   autoDiscoverDevices               false
   hpcsBaseUrl                       <Please provide the KMS Base (public) URL>
   taintNodes                        false
   enableNFS                         false
   resourceProfile                   performance
   useCephRBDAsDefaultStorageClass   false
   clusterEncryption                 false
   hpcsEncryption                    false
   hpcsSecretName                    <Please provide the KMS secret name>
   encryptionInTransit               false
   disableNoobaaLB                   false
   osdSize                           512Gi
   numOfOsd                          1
   ignoreNoobaa                      true
   addSingleReplicaPool              false
   prepareForDisasterRecovery        false
   workerPool                        -
   odfDeploy                         true
   osdDevicePaths                    <Please provide IDs of the disks to be used for OSD pods if using local disks or standard classic cluster>
   workerNodes                       all
   hpcsServiceName                   <Please provide the KMS Service instance name>
   hpcsInstanceId                    <Please provide the KMS Service instance ID>
   hpcsTokenUrl                      <Please provide the KMS token URL>
   

6. 啟用 openshift-data-foundation 附加程式。 如果您要置換任何預設參數，請針對您要置換的每一個參數指定 --param "key=value" 選項。 如果您不想在啟用附加程式時建立儲存空間叢集，則可以先啟用附加程式，然後稍後透過建立 CRD 來建立儲存空間叢集。

   使用預設儲存群集設定、performance 資源設定檔，以及啟用 Hyper Protect Crypto Services 加密的附加元件 4.10 版部署指令範例。

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version 4.15.0 --param "odfDeploy=true" --param "resourceProfile=performance" --param "hpcsTokenUrl=https://iam.cloud.ibm.com/identity/token" --param "hpcsEncryption=true" --param "hpcsBaseUrl=HPCS_INSTANCE_PUBLIC_ENDPOINT" --param "hpcsInstanceId=HPCS_INSTANCE_ID" --param "hpcsServiceName=HPCS_INSTANCE_NAME" --param "hpcsSecretName=HPCS_SECRET_NAME"
   

   僅部署 ODF 附加程式的範例指令。

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version VERSION --param "odfDeploy=false"
   

   部署 ODF 並使用預設配置參數建立儲存體叢集的範例指令。

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version VERSION
   

   部署 ODF 並建立儲存體叢集，同時置換 osdSize 參數的範例指令。

   ibmcloud oc cluster addon enable openshift-data-foundation -c CLUSTER_NAME --version VERSION --param "osdSize=500Gi"
   

7. 驗證附加程式是否處於 Ready 狀態。

   oc get storagecluster -n openshift-storage
   

   輸出範例：

   NAME                 AGE   PHASE   EXTERNAL   CREATED AT             VERSION
   ocs-storagecluster   53m   Ready              2023-03-10T12:20:52Z   4.11.0
   

8. 驗證 ibm-ocs-operator-controller-manager-***** Pod 是否在 kube-system 名稱空間中執行。

   oc get pods -A | grep ibm-ocs-operator-controller-manager
   

9. 如果您已在 odfDeploy 設為 false 的情況下啟用附加程式，請遵循 建立 ODF 自訂資源 的步驟。

從 Terraform 安裝附加程式

• 安裝 Terraform CLI 和 IBM Cloud 提供者外掛程式。
• 請確定您有 IBM Cloud API 金鑰。

1. 建立 Terraform 提供者檔案。 將檔案儲存在 Terraform 目錄中。 如需相關資訊，請參閱 Terraform IBM Cloud 提供者說明文件。

   範例 Terraform 提供者檔案。

   terraform {
   required_providers {
       ibm = {
       source = "IBM-Cloud/ibm"
       version = "1.53.0"
       }
   }
   }
   provider "ibm" {
   region = "us-south"
   ibmcloud_api_key = "<api-key>"
   }
   

2. 建立 ODF 附加程式的 Terraform 配置檔。 將檔案儲存在 Terraform 目錄中。

   配置檔範例。

   ibmcloud_api_key = "" # Enter your API Key
   cluster = "" # Enter the Cluster ID
   region = "us-south" # Enter the region
   # For add-on deployment
   odfVersion = "4.12.0"
   # For CRD Creation and Management
   autoDiscoverDevices = "false"
   billingType = "advanced"
   clusterEncryption = "false"
   hpcsBaseUrl = null
   hpcsEncryption = "false"
   hpcsInstanceId = null
   hpcsSecretName = null
   hpcsServiceName = null
   hpcsTokenUrl = null
   ignoreNoobaa = "false"
   numOfOsd = "1"
   ocsUpgrade = "false"
   osdDevicePaths = null
   osdSize = "250Gi"
   osdStorageClassName = "ibmc-vpc-block-metro-10iops-tier"
   workerNodes = null
   

3. 在 CLI 中，導覽至 Terraform 目錄。

   cd <terraform_directory>
   

4. 執行指令以起始設定及計劃 Terraform 動作。 請檢閱計劃輸出，以確定已執行正確的動作。

   terraform init
   

   terraform plan
   

5. 套用 Terraform 檔案以建立叢集。 然後，導覽至 IBM Cloud 主控台，以檢查叢集是否正在佈建。

   terraform apply
   

建立 ODF 自訂資源

若要使用儲存磁區的動態佈建在 VPC 叢集中建立 ODF 儲存體叢集，您可以建立自訂資源來指定儲存裝置詳細資料。

如果您要使用 IBM Cloud Object Storage 服務實體作為預設備份儲存，請確定您已 建立服務實體，並在群集中建立 Kubernetes secret。 當您在群集中建立 ODF CRD 時，ODF 會尋找一個名為 ibm-cloud-cos-creds 的秘密，以設定使用 Object Storage HMAC 認證的預設備份儲存。

1. 建立稱為 OcsCluster 的自訂資源定義。 請將以下其中一個自訂資源定義檔案儲存至您的本地端電腦，並進行編輯，將您先前建立的儲存類別名稱加入為 monStorageClassName 和 osdStorageClassName 參數。 如需 OcsCluster 參數的相關資訊，請參閱 參數參照。

   在 4.8 叢集的所有工作者節點上安裝 ODF 的自訂資源定義範例。

   apiVersion: ocs.ibm.io/v1
   kind: OcsCluster
   metadata:
     name: ocscluster-vpc # Kubernetes resource names can't contain capital letters or special characters. Enter a name for your resource that uses only lowercase letters, numbers, `-` or `.`
   spec:
     osdStorageClassName: <osdStorageClassName> # Specify an ODF storage class with a waitForFirstConsumer volume binding mode
     osdSize: <osdSize> # The OSD size is the total storage capacity of your OCS storage cluster. Use at least 250Gi OSDs for production workloads.
     numOfOsd: 1
     billingType: advanced
     ocsUpgrade: false
   

   僅在 4.8 叢集的指定工作者節點上安裝 ODF 的自訂資源定義範例。

   apiVersion: ocs.ibm.io/v1
   kind: OcsCluster
   metadata:
     name: ocscluster-vpc # Kubernetes resource names can't contain capital letters or special characters. Enter a name for your resource that uses only lowercase letters, numbers, `-` or `.`
   spec:
     osdStorageClassName: <osdStorageClassName> # Specify an ODF storage class with a waitForFirstConsumer volume binding mode
     osdSize: <osdSize> # The OSD size is the total storage capacity of your OCS storage cluster. Use at least 250Gi OSDs for production workloads.
     numOfOsd: 1
     billingType: advanced
     ocsUpgrade: false
     workerNodes: # Specify the private IP addresses of the worker nodes where you want to install OCS.
       - <workerNodes> # To get a list worker nodes, run `oc get nodes`.
       - <workerNodes>
       - <workerNodes>
   

2. 將檔案儲存並建立 OcsCluster 自訂資源至叢集。

   oc create -f <ocs-cluster-filename>.yaml
   

3. 請確認您的 OcsCluster 是否正在運行。

   oc describe ocscluster ocscluster-vpc
   

   輸出範例

   Name:         ocscluster-vpc
   Namespace:    
   Labels:       <none>
   Annotations:  <none>
   API Version:  ocs.ibm.io/v1
   Kind:         OcsCluster
   Metadata:
       Creation Timestamp:  2021-03-23T20:56:51Z
   Finalizers:
     finalizer.ocs.ibm.io
   Generation:  1
   Managed Fields:
     API Version:  ocs.ibm.io/v1
     Fields Type:  FieldsV1
     fieldsV1:
       f:spec:
         .:
         f:billingType:
         f:monSize:
         f:monStorageClassName:
         f:numOfOsd:
         f:ocsUpgrade:
         f:osdSize:
         f:osdStorageClassName:
     Manager:      oc
     Operation:    Update
     Time:         2021-03-23T20:56:51Z
     API Version:  ocs.ibm.io/v1
     Fields Type:  FieldsV1
     fieldsV1:
       f:metadata:
         f:finalizers:
           .:
           v:"finalizer.ocs.ibm.io":
       f:status:
         .:
         f:storageClusterStatus:
     Manager:         manager
     Operation:       Update
     Time:            2021-04-09T23:12:02Z
   Resource Version:  11372332
   Self Link:         /apis/ocs.ibm.io/v1/ocsclusters/ocscluster-vpc
   UID:               aa11a1a1-111f-aace-afac-1fa1afe1111a
   Spec:
     Billing Type:            hourly
     Mon Size:                20Gi
     Mon Storage Class Name:  ibmc-vpc-block-10iops-tier
     Num Of Osd:              1
     Ocs Upgrade:             false
     Osd Size:                250Gi
     Osd Storage Class Name:  ibmc-vpc-block-10iops-tier
   Status:
     Storage Cluster Status:  
   Events:                    <none>
   

4. 部署使用 ODF 的應用程式。