Instalación del complemento OpenShift Data Foundation desde la consola

Para instalar ODF en el clúster, realice los pasos siguientes.

Antes de habilitar el complemento, revise el registro de cambios para obtener la información de versiones más reciente. Además, revise la referencia de parámetros para comprender las opciones de instalación.

1. Desde la consola, selecciona el clúster en el que deseas instalar el complemento.
2. En la tarjeta OpenShift Data Foundation, pulse Instalar. Se abrirá el panel Instalar ODF.
3. En el panel Instalar ODF, especifique los parámetros de configuración que desee usar en el despliegue de ODF.

Tipo de facturación

Plan de facturación Essentials o Advanced. Para obtener más información sobre el tipo de facturación, consulte Soporte de características por tipo de facturación.

Clase de almacenamiento

Introduce la clase de almacenamiento que deseas utilizar.

• Para los clústeres de VPC que utilizan máquinas virtuales, selecciona Aprovisionamiento remoto para aprovisionar dinámicamente volúmenes para ODF mediante el servicio de aprovisionamiento de datos de IBM ( Block Storage for VPC ).
• Para clústeres VPC que utilizan nodos trabajadores Bare Metal Servers for VPC, seleccione Almacenamiento local. Si desea detectar automáticamente los dispositivos de almacenamiento disponibles en sus nodos de trabajo y utilizarlos en ODF, seleccione Detección de discos locales.

Nombre de clase de almacenamiento de OSD

Introduzca el nombre de la clase de almacenamiento que desea utilizar para aprovisionar volúmenes de almacenamiento.

• Para clusters VPC con Bare Metal Servers for VPC nodos trabajadores, seleccione localblock.
• Para clústeres multizona, utilice una clase de almacenamiento con la dirección VolumeBindingMode de WaitForFirstConsumer.
• Para obtener una lista de las clases de almacenamiento, consulte la Referencia de clases de almacenamiento.

Tamaño de la cápsula OSD

Introduce el tamaño del volumen que deseas aprovisionar. Introduzca al menos 512Gi.

Nodos de trabajador

Introduce los nombres de los nodos de trabajo en los que deseas implementar ODF. Debe especificar al menos 3 nombres de nodo de trabajador. Para encontrar los nombres de sus nodos, ejecute el comando oc get nodes en su clúster. Node deben estar separados por comas y sin espacios. Por ejemplo: 10.240.0.24,10.240.0.26,10.240.0.25. Deje este campo en blanco para desplegar ODF en todos los nodos de trabajador.

Número de discos de OSD necesarios

Introduzca el número de discos OSD (almacenamiento de aplicaciones) para aprovisionar en cada nodo trabajador.

Habilitar el cifrado de clúster

Seleccione esta opción si desea cifrar los volúmenes OSD (cifrado en todo el clúster) utilizados por los pods del sistema ODF.

Habilitar cifrado de volumen

Seleccione esta opción si desea activar el cifrado para los volúmenes de aplicaciones (almacenamiento de aplicaciones).

• En el campo Nombre de instancia, especifique un nombre exclusivo para la instancia de Hyper Protect Crypto Services o Key Protect.
• En el campo Tipo de instancia, especifique el tipo de instancia de cifrado.
• En el campo ID de instancia, introduce el ID de tu instancia de Hyper Protect Crypto Services o Key Protect. Por ejemplo: d11a1a43-aa0a-40a3-aaa9-5aaa63147aaa.
• En el campo Nombre del secreto, introduce el nombre del secreto que has creado utilizando tus credenciales de Hyper Protect Crypto Services o Key Protect. Por ejemplo: ibm-hpcs-secret.
• En el campo Base URL, introduce el punto final público de tu instancia de Hyper Protect Crypto Services o Key Protect. Por ejemplo: https://api.eu-gb.hs-crypto.cloud.ibm.com:8389.
• En el campo URL de señal, escriba https://iam.cloud.ibm.com/identity/token.

1. Una vez especificados los parámetros que desee usar, pulse Instalar.

2. Espere unos minutos a que termine el despliegue del complemento. Cuando se haya completado el despliegue, el estado del complemento será Normal - Addon Ready.

3. Verifique la instalación. Acceda al clúster de Red Hat OpenShift.

4. Ejecute el comando siguiente para verificar que los pods PDF están ejecutando.

   oc get pods -n openshift-storage
   

Próximos pasos

Despliegue una aplicación que usa ODF.

Instalación del complemento desde la CLI

Puedes instalar el complemento utilizando el ibmcloud oc cluster addon enable comando.

1. Revise la Referencia de parámetros de VPC. Al habilitar el complemento, puede anular los valores predeterminados especificando la opción --param "key=value" correspondiente para cada parámetro que desee anular.

2. Acceda al clúster de Red Hat OpenShift.

3. Liste las versiones del complemento openshift-data-foundation. Anote la versión predeterminada y determine la versión que desea instalar.

   ibmcloud ks cluster addon versions
   

4. Antes de habilitar el complemento, revise el registro de cambios para obtener la información de versiones más reciente. Tenga en cuenta que el complemento da soporte a las versiones de clúster n+1. Por ejemplo, puede implementar la versión 4.10.0 del complemento en un OCP 4.9 o en un clúster 4.11. Si tienes una versión de clúster distinta de la predeterminada, debes especificar la opción --version al habilitar el complemento.

5. Revise las opciones del complemento.

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

   Para obtener el mejor rendimiento, se recomienda incluir la opción resourceProfile especificada como performance. Esta opción ayuda a obtener niveles de rendimiento mejorados en función de la disponibilidad de recursos durante el despliegue. Para obtener más información sobre la opción « resourceProfile », consulta la sección «Perfiles de rendimiento» en la documentación de ODF de Red Hat OpenShift.

   Ejemplo de opciones adicionales para la versión 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. Habilite el complemento openshift-data-foundation. Si desea anular alguno de los parámetros predeterminados, especifique la opción --param "key=value" correspondiente para cada parámetro que desee anular. Si no desea crear el clúster de almacenamiento cuando habilite el complemento, puede habilitar el complemento primero y, a continuación, crear el clúster de almacenamiento más adelante creando una CRD.

   Ejemplo comando comando para implementar la versión del complemento 4.10 con la configuración predeterminada del clúster de almacenamiento, el perfil de recursos performance y el cifrado con Hyper Protect Crypto Services habilitado.

   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"
   

   Ejemplo de comando de despliegue del complemento ODF solo.

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

   Ejemplo de comando de despliegue de ODF y de creación de un clúster de almacenamiento con los parámetros de configuración predeterminados.

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

   Ejemplo de comando de despliegue de ODF y creación de un clúster de almacenamiento sustituyendo el parámetro osdSize.

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

7. Verifique que el complemento esté en un estado Ready.

   oc get storagecluster -n openshift-storage
   

   Salida de ejemplo:

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

8. Verifique que el pod de ibm-ocs-operator-controller-manager-***** se está ejecutando en el espacio de nombres kube-system.

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

9. Si ha habilitado el complemento con odfDeploy establecido en false, siga los pasos para crear un recurso personalizado ODF.

Instalación del complemento desde Terraform

• Instale la CLI de Terraform y el plugin de proveedor de IBM Cloud.
• Asegúrese de que dispone de una clave API IBM Cloud.

1. Crear un archivo de proveedor de Terraform. Guarde el archivo en el directorio de Terraform. Para obtener más información, consulte la documentación de Terraform IBM Cloud Provider.

   Archivo de proveedor de Terraform de ejemplo.

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

2. Cree un archivo de configuración de Terraform para el complemento ODF. Guarde el archivo en el directorio de Terraform.

   Archivo de configuración de ejemplo.

   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. En la CLI, vaya al directorio de Terraform.

   cd <terraform_directory>
   

4. Ejecute los mandatos para inicializar y planificar las acciones de Terraform. Revise la salida del plan para asegurarse de que se realizan las acciones correctas.

   terraform init
   

   terraform plan
   

5. Aplique los archivos de Terraform para crear el clúster. A continuación, vaya a la consola de IBM Cloud para comprobar que el clúster se está suministrando.

   terraform apply
   

Creación del recurso personalizado de ODF

Para crear un clúster de almacenamiento ODF en el clúster VPC utilizando un suministro dinámico de los volúmenes de almacenamiento, se puede crear un recurso personalizado para especificar los detalles del dispositivo de almacenamiento.

Si desea utilizar una instancia de servicio de IBM Cloud Object Storage como almacenamiento de copia de seguridad predeterminado, asegúrese de que ha creado la instancia de servicio y que ha creado el secreto de Kubernetes en el clúster. Cuando crea el CRD de ODF en el clúster, ODF busca un secreto denominado ibm-cloud-cos-creds para configurar el almacén de copia de seguridad predeterminado que utiliza las credenciales de Object Storage HMAC.

1. Cree una definición de recurso personalizada denominada OcsCluster. Guarda uno de los siguientes archivos de definición de recursos personalizados en tu equipo local y edítalo para incluir el nombre de la clase de almacenamiento que has creado anteriormente como parámetros osdStorageClassName y monStorageClassName. Para obtener más información sobre los parámetros de OcsCluster, consulte la referencia de parámetros.

   Ejemplo de definición de recurso personalizado para instalar ODF en todos los nodos de trabajador en un clúster de la versión 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
   

   Ejemplo de definición de recurso personalizado para instalar ODF solo en los nodos de trabajador especificados en un clúster de la versión 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. Guarde el archivo y cree el recurso personalizado OcsCluster en el clúster.

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

3. Verifique que su OcsCluster esté en ejecución.

   oc describe ocscluster ocscluster-vpc
   

   Salida de ejemplo

   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. Despliegue una aplicación que usa ODF.