Installazione del componente aggiuntivo OpenShift Data Foundation dalla console

Per installare ODF nel cluster, completare la seguente procedura.

Prima di abilitare il componente aggiuntivo, esaminare il log delle modifiche per le ultime informazioni sulla versione. Inoltre, per comprendere le opzioni di installazione, consultare il riferimento ai parametri.

1. Dalla console, selezionare il cluster in cui si desidera installare l'add-on.
2. Sulla scheda della Fondazione dati di Microsoft ( OpenShift ), fare clic su Installa. Si apre il pannello Installa ODF.
3. Nel pannello Installa ODF, immettere i parametri di configurazione che si desidera utilizzare per la distribuzione ODF.

Tipo di fatturazione

Essentials o Advanced come piano di fatturazione. Per ulteriori informazioni sul tipo di fatturazione, vedi Supporto della funzione per tipo di fatturazione.

Classe di archiviazione

Inserisci la classe di archiviazione che desideri utilizzare.

• Per i cluster VPC che utilizzano macchine virtuali, selezionare Provisioning remoto per fornire dinamicamente i volumi per ODF utilizzando il sito Block Storage for VPC.
• Per i cluster VPC che utilizzano i nodi worker Bare Metal Servers for VPC, selezionare Archiviazione locale. Se si desidera scoprire automaticamente i dispositivi di archiviazione disponibili sui nodi worker e utilizzarli in ODF, selezionare Local disk discovery.

Nome classe di storage OSD

Inserire il nome della classe di archiviazione che si desidera utilizzare per l'allocazione dei volumi di archiviazione.

• Per i cluster VPC con Bare Metal Servers for VPC nodi worker, selezionare localblock.
• Per i cluster multizona, utilizzare una classe di archiviazione con VolumeBindingMode di WaitForFirstConsumer.
• Per un elenco delle classi di archiviazione, consultare il Riferimento alle classi di archiviazione.

Dimensione della capsula OSD

Inserisci la dimensione del volume che desideri allocare. Inserire almeno 512Gi.

Nodi di lavoro

Immettere i nomi dei nodi worker in cui si desidera distribuire ODF. È necessario immettere almeno 3 nomi nodo di lavoro. Per trovare i nomi dei nodi, eseguire il comando oc get nodes nel proprio cluster. Node devono essere separati da virgole senza spazi tra i nomi. Ad esempio: 10.240.0.24,10.240.0.26,10.240.0.25. Lasciare questo campo vuoto per distribuire ODF su tutti i nodi worker.

Numero di dischi OSD necessari

Immettere il numero di dischi OSD (app storage) da fornire su ciascun nodo worker.

Abilita crittografia del cluster

Selezionare questa opzione se si desidera crittografare i volumi OSD (crittografia a livello di cluster) utilizzati dai pod di sistema ODF.

Abilitare la crittografia del volume

Selezionare questa opzione se si desidera abilitare la crittografia per i volumi delle applicazioni (app storage).

• Nel campo Nome istanza, immettere un nome univoco per l'istanza Hyper Protect Crypto Services o Key Protect.
• Nel campo Tipo istanza, immettere il tipo di istanza di crittografia.
• Nel campo ID istanza, immetti il tuo ID istanza Hyper Protect Crypto Services o Key Protect. Ad esempio: d11a1a43-aa0a-40a3-aaa9-5aaa63147aaa.
• Nel campo Nome segreto, immetti il nome del segreto che hai creato utilizzando le tue credenziali Hyper Protect Crypto Services o Key Protect. Ad esempio: ibm-hpcs-secret.
• Nel campo URL di base, inserire l'endpoint pubblico dell'istanza Hyper Protect Crypto Services o Key Protect. Ad esempio: https://api.eu-gb.hs-crypto.cloud.ibm.com:8389.
• Nel campo URL token, immettere https://iam.cloud.ibm.com/identity/token.

1. Dopo aver immesso i parametri che si desidera utilizzare, fare clic su Installa

2. Attendere qualche minuto affinché l'installazione del componente aggiuntivo venga completata. Quando la distribuzione è completa, lo stato del componente aggiuntivo è Normal - Addon Ready.

3. Verificare l'installazione. Accedi al tuo cluster Red Hat OpenShift.

4. Immetti il seguente comando per verificare che i pod ODF siano in esecuzione.

   oc get pods -n openshift-storage
   

Passi successivi

Distribuisci un'applicazione che utilizza ODF.

Installazione del componente aggiuntivo tramite la CLI

È possibile installare il componente aggiuntivo utilizzando il comando ibmcloud oc cluster addon enable.

1. Esamina il riferimento del parametro VPC. Quando si abilita il componente aggiuntivo, è possibile sovrascrivere i valori predefiniti specificando l'opzione --param "key=value" per ciascun parametro che si desidera sovrascrivere.

2. Accedi al tuo cluster Red Hat OpenShift.

3. Elencare le versioni del componente aggiuntivo openshift-data-foundation. Prendere nota della versione predefinita e determinare la versione che si desidera installare.

   ibmcloud ks cluster addon versions
   

4. Prima di abilitare il componente aggiuntivo, esaminare il log delle modifiche per le ultime informazioni sulla versione. Notare che il componente aggiuntivo supporta versioni di cluster n+1. Ad esempio, è possibile distribuire la versione 4.10.0 del componente aggiuntivo in un cluster OCP 4.9 o 4.11. Se si dispone di una versione cluster diversa da quella predefinita, è necessario specificare l'opzione --version quando si abilita il componente aggiuntivo.

5. Esaminare le opzioni del componente aggiuntivo.

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

   Per ottenere le migliori prestazioni, si consiglia di includere l'opzione resourceProfile specificata come performance. Questa opzione consente di ottenere livelli di prestazioni migliori in base alla disponibilità di risorse durante la distribuzione. Per ulteriori informazioni sull'opzione " resourceProfile ", consultare la sezione " Profili di prestazioni " nella documentazione ODF di " Red Hat OpenShift "

   Esempio di opzioni aggiuntive per la versione 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. Abilitare il componente aggiuntivo openshift-data-foundation. Se si desidera sovrascrivere uno dei parametri predefiniti, specificare l'opzione --param "key=value" per ciascun parametro che si desidera sovrascrivere. Se non si desidera creare il cluster di memoria quando si abilita il componente aggiuntivo, è possibile abilitare prima il componente aggiuntivo, quindi creare successivamente il cluster di memoria creando un CRD.

   Comando di esempio per distribuire il componente aggiuntivo versione 4.10 con le impostazioni predefinite del cluster di storage, il profilo delle risorse performance e la crittografia con Hyper Protect Crypto Services abilitata.

   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"
   

   Comando di esempio per la distribuzione solo del componente aggiuntivo ODF.

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

   Comando di esempio per la distribuzione di ODF e la creazione di un cluster di memoria con i parametri di configurazione predefiniti.

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

   Comando di esempio per distribuire ODF e creare un cluster di memoria sovrascrivendo il parametro osdSize.

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

7. Verificare che il componente aggiuntivo sia in uno stato Ready.

   oc get storagecluster -n openshift-storage
   

   Output di esempio:

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

8. Verifica che il pod ibm-ocs-operator-controller-manager-***** sia in esecuzione nel namespace kube-system.

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

9. Se è stato abilitato il componente aggiuntivo con odfDeploy impostato su false, seguire la procedura per creare una risorsa personalizzata ODF.

Installazione del componente aggiuntivo da Terraform

• Installa la CLI Terraform e il plug-in IBM Cloud Provider.
• Assicurarsi di disporre di una chiave API IBM Cloud.

1. Creare un file provider Terraform. Salvare il file nella directory Terraform. Per ulteriori informazioni, vedi la documentazione di Terraform IBM Cloud Provider.

   File provider Terraform di esempio.

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

2. Creare un file di configurazione Terraform per il componente aggiuntivo ODF. Salvare il file nella directory Terraform.

   File di configurazione di esempio.

   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. Nella CLI, passa alla tua directory Terraform.

   cd <terraform_directory>
   

4. Esegui i comandi per avviare e pianificare le tue azioni Terraform. Esaminare l'output del piano per assicurarsi che vengano eseguite le azioni corrette.

   terraform init
   

   terraform plan
   

5. Applica i file Terraform per creare il cluster. Passa quindi alla console IBM Cloud per controllare che il cluster stia eseguendo il provisioning.

   terraform apply
   

Creazione della risorsa personalizzata ODF

Per creare un cluster di memoria ODF nel cluster VPC utilizzando il provisioning dinamico per i volumi di memoria, è possibile creare una risorsa personalizzata per specificare i dettagli del dispositivo di memoria.

Se si desidera utilizzare un'istanza del servizio IBM Cloud Object Storage come backing store predefinito, assicurarsi di aver creato l'istanza del servizio e di aver creato il segreto Kubernetes nel cluster. Quando si crea il CRD di ODF nel cluster, ODF cerca un segreto chiamato ibm-cloud-cos-creds per impostare il backing store predefinito che utilizza le credenziali HMAC di Object Storage.

1. Creare una definizione risorsa personalizzata denominata OcsCluster. Salva uno dei seguenti file di definizione delle risorse personalizzate sul tuo computer locale e modificalo in modo da includere il nome della classe di archiviazione che hai creato in precedenza come parametri monStorageClassName e osdStorageClassName . Per ulteriori informazioni sui parametri OcsCluster, consultare il riferimento ai parametri.

   Definizione di risorsa personalizzata di esempio per installare ODF su tutti i nodi di lavoro su cluster 4.8.

   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
   

   Esempio di definizione di risorsa personalizzata per installare ODF solo su nodi di lavoro specificati su cluster 4.8.

   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. Salva il file e crea la risorsa personalizzata OcsCluster nel tuo cluster.

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

3. Verifica che il tuo OcsCluster sia in esecuzione.

   oc describe ocscluster ocscluster-vpc
   

   Output di esempio

   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. Distribuisci un'applicazione che utilizza ODF.