Antes de empezar

Antes de crear los clústeres, recopila los datos de la VPC y de Cloud Object Storage que necesitas introducir en los comandos de creación de clústeres.

1. Recupera tus ID de VPC. Anota el ID de la VPC que deseas utilizar para cada clúster.

   ibmcloud is vpcs
   

2. Recuperar los detalles de la subred de una VPC específica. Anota los ID de subred que quieras utilizar para cada clúster.

   ibmcloud is subnets --vpc VPC_ID
   

3. Enumera tus instancias de Cloud Object Storage.

   ibmcloud resource service-instances --service-name cloud-object-storage
   

4. Recupera el CRN de la instancia que deseas utilizar. Tenga en cuenta el valor del campo ID.

   ibmcloud resource service-instance SERVICE_INSTANCE
   

Paso 1. Crear el clúster central

Hub cluster

Este es el clúster en el que se instala ACM para gestionar los clústeres ODF primario y secundario. Asegúrese de que su clúster central disponga de al menos capacidad de cálculo 16 vCPU x 64 GB disponible.

Para cada clúster, asegúrese de permitir el tráfico saliente incluyendo el parámetro --disable-outbound-traffic-protection en la CLI o seleccionando la opción para desactivar la protección del tráfico saliente en la UI.

1. Cree un clúster VPC en us-east para instalar ACM en él. Este es el clúster central que puede utilizar para gestionar sus clústeres ODF. Asegúrate de que tu clúster central cuente con al menos 3 nodos de trabajo que ejecuten RHCOS, una capacidad de cálculo disponible de al menos 16 vCPU y 64 GB, que el tráfico saliente esté desactivado y que cumpla todos los requisitos previos para ACM. El siguiente comando ejemplo crea un cluster para ACM en us-east.

   ibmcloud ks cluster create vpc-gen2 --flavor bx2.16x64 --name acm-hub-cluster-dr-odf --subnet-id SUBNET_ID --vpc-id VPC_ID --zone us-east-2 --version 4.21.31_openshift --workers 3 --cos-instance COS_CRN --disable-outbound-traffic-protection --cni OVNKubernetes
   

2. Anota el ID del clúster que aparece en la salida. Lo necesitarás en un paso posterior.

Paso 2. Crear un perfil de confianza para el clúster central

Hub cluster

1. Crea un perfil de confianza.

   ibmcloud iam trusted-profile-create acm-operator-profile
   

2. Crea la regla de confianza del recurso de computación, limitada al espacio de kube-system nombres de los recursos de computación de Red Hat OpenShift.

   ibmcloud iam trusted-profile-rule-create acm-operator-profile \
     --name kube-system-rule \
     --type Profile-CR \
     --conditions claim:namespace,operator:EQUALS,value:kube-system \
     --cr-type ROKS_SA
   

3. Asigna la política de acceso de IAM al perfil. Sustituye CLUSTER_ID por el ID de tu clúster de hub.

   ibmcloud iam trusted-profile-policy-create acm-operator-profile \
     --roles Reader,Viewer,Operator,Editor \
     --service-name containers-kubernetes \
     --service-instance CLUSTER_ID
   

4. Asigna el perfil de confianza al clúster del hub. Una vez que se haya asignado un perfil de confianza a un clúster, este no se podrá eliminar.

   ibmcloud oc experimental trusted-profile set --cluster CLUSTER_NAME_OR_ID --trusted-profile TRUSTED_PROFILE_ID
   

5. Comprueba que se haya creado el secreto del perfil de confianza en el clúster. Este comando puede tardar hasta 10 minutos en completarse. Espera a que aparezca la clave secreta antes de continuar con la instalación del complemento ACM. Si continúa antes de que se haya creado el secreto, la instalación del complemento ACM fallará.

   oc get secrets -n kube-system | grep ibm-cloud-credentials
   

6. Si utilizas la versión 4.21 o posterior de ODF, instala el operador OpenShift ( GitOps ) en el clúster del hub.

   1. Desde la perspectiva de la plataforma Core de la consola web OpenShift del clúster central, ve a Ecosistema > Catálogo de software y busca Red Hat OpenShift GitOps.

   2. Haz clic en el mosaico Red Hat OpenShift ( GitOps ).

   3. En la página Install Operator, selecciona un canal de actualización y una versión de GitOps para instalar.

   4. Selecciona un espacio de nombres instalado. El espacio de nombres de instalación predeterminado es openshift-gitops-operator.

      En la versión 1.10 y posteriores de GitOps, el espacio de nombres predeterminado ha cambiado de a openshift-operators openshift-gitops-operator.

   5. Marque la casilla de selección Habilitar la supervisión de clústeres recomendada por el operador en este espacio de nombres para habilitar la supervisión de clústeres.

   6. Pulse Instalar. Red Hat OpenShift GitOps Se instala en todos los espacios de nombres del clúster.

   7. Comprueba que el operador Red Hat OpenShift GitOps aparece en Operadores > Operadores instalados y que el estado indica Correcto.

   Tras la instalación, OpenShift GitOps configura automáticamente una instancia de Argo CD lista para usar en el espacio openshift-gitops de nombres, y aparece un icono de Argo CD en la barra de herramientas de la consola.

Paso 3. Crear los clústeres gestionados

Managed cluster

1. Crea un clúster VPC en us-east con al menos 3 nodos de trabajo que ejecuten RHCOS, una capacidad de computación disponible de al menos 16 vCPU y 64 GB, y la protección del tráfico saliente desactivada. Este será el cluster ODF primario gestionado. El siguiente comando de ejemplo crea un clúster en us-east.

   ibmcloud ks cluster create vpc-gen2 --flavor bx2.16x64 --name managed-cluster-1-dr-odf --subnet-id SUBNET_ID --vpc-id VPC_ID --zone us-east-2 --version 4.21.31_openshift --workers 3 --cos-instance COS_CRN --disable-outbound-traffic-protection --cni OVNKubernetes
   

2. Crea un clúster VPC en jp-tok con al menos 3 nodos de trabajo que ejecuten RHCOS, una capacidad de computación disponible de al menos 16 vCPU y 64 GB, y la protección del tráfico saliente desactivada. Este será el clúster ODF secundario gestionado. Para una alta disponibilidad, asegúrese de que la red del clúster secundario no se solapa con la red del clúster primario. El siguiente comando de ejemplo crea un clúster en jp-tok.

   ibmcloud ks cluster create vpc-gen2 --flavor bx2.16x64 --name managed-cluster-2-dr-odf --subnet-id SUBNET_ID --vpc-id VPC_ID --zone jp-tok --version 4.21.31_openshift --workers 3 --cos-instance COS_CRN --disable-outbound-traffic-protection --cni OVNKubernetes
   

Paso 4. Instala el complemento ACM en el clúster del hub

Hub cluster

Utilice la CLI para instalar el complemento ACM en el clúster del hub.

1. Busca la versión predeterminada del complemento ACM.

   ibmcloud oc cluster addon versions
   

2. Consulta las opciones de complementos de ACM. En el comando, especifica la versión predeterminada que has encontrado en el paso anterior. Anota cualquier opción que quieras incluir al instalar el complemento.

   ibmcloud oc cluster addon options --addon acm --version DEFAULT_VERSION
   

3. Ejecuta el comando para activar el complemento. Asegúrate de especificar los parámetros isLicenseAccepted y billingPlan.

   ibmcloud oc cluster addon enable acm --cluster HUB_CLUSTER_ID --param 'billingPlan=PLAN' --param 'isLicenseAccepted=BOOLEAN'
   

   Parámetros comando. Consulta el comando de ejemplo que aparece a continuación para ver un ejemplo de cada tipo de parámetro.

   --cluster

   Obligatorio. El ID del clúster central en el que se va a instalar el complemento ACM.

   --param 'billingPlan='

   Obligatorio. El plan de facturación que desea seleccionar para ACM. Especifica KUBERNETES para el plan ACM de Kubernetes.

   --param 'isLicenseAccepted='

   Obligatorio. Seleccione esta opción true para aceptar el acuerdo de licencia del plan de facturación seleccionado. El complemento no se instalará correctamente a menos que se acepte la licencia. Al aceptar esta licencia, aceptas los términos y condiciones aplicables y confirmas que comprendes los servicios incluidos en el plan seleccionado.

   Ejemplo comando comando para instalar el complemento ACM con el plan de facturación ACM for Kubernetes.

   ibmcloud oc cluster addon enable acm --cluster a5bcde982dfer2nwxq73 --param 'billingPlan=KUBERNETES' --param 'isLicenseAccepted=true'
   

4. Comprueba que el complemento se haya instalado. El complemento puede tardar varios minutos en aparecer en los siguientes resultados.

   1. En el clúster del hub, comprueba que se haya creado el recurso acmhub.

       oc get acmhub
       ```
       Ejemplo de salida.
   
       ```sh {: screen}
           NAME       AGE
           acm-auto   1h
       ```
   1. En el clúster central, comprueba el estado `acmhub`.
   
   ```sh {: pre}
       oc describe acmhub
       ```
       Ejemplo de salida.
   
       ```sh {: screen}
       Status
           Message: ACM installed successfully
       ```
   

Paso 5. Importar los clústeres gestionados a ACM

Hub cluster Managed cluster

Importa ambos clústeres gestionados a ACM para que el clúster central pueda gestionarlos.

1. Abre la consola web de OpenShift para el clúster del hub.

2. Desde la perspectiva de Fleet Management, haz clic en Importar clúster.

3. Introduce el nombre del primer clúster gestionado, selecciona un conjunto de clústeres si procede e introduce etiquetas adicionales si procede.

4. Para Modo de importación, selecciona Ejecutar comandos de importación manualmente y haz clic en Siguiente.

5. Si lo desea, seleccione una plantilla de automatización y haga clic en Siguiente.

6. Revisa los detalles y haz clic en Generar comando. Copia el comando que aparece en pantalla.

7. Inicia sesión en el primer clúster gestionado y ejecuta el comando copiado con la configuración kubectl específica de ese clúster.

8. Repite los pasos 2 a 7 para el segundo clúster gestionado.

9. En la perspectiva Gestión de flotas, comprueba que ambos clústeres gestionados aparezcan en la lista y muestren el estado Listo antes de continuar.

Paso 6. Configurar el complemento Submariner

Managed cluster

Siga los pasos para instalar y configurar el complemento Submariner, que establece la conectividad entre sus dos clústeres gestionados. Estos pasos utilizan la consola ACM. Para obtener información más detallada, consulta Implementación de Submariner mediante la consola en la documentación de Red Hat.

1. Vaya a la consola ACM. A continuación, haz clic en Gestión de flotas > Clústeres > Conjuntos de clústeres.
2. Haz clic en Crear conjunto de clústeres. Siga las instrucciones para añadir sus dos clústeres gestionados al conjunto de clústeres.
3. Haga clic en la opción para instalar el complemento Submariner en el conjunto de clústeres.
4. Seleccione los clústeres gestionados como clústeres de destino para la instalación del complemento.
5. Al revisar la configuración de ambos clústeres, cambie los siguientes ajustes como se muestra y deje el resto como predeterminado. A continuación, haz clic en Instalar.

   globalnetEnabled: true (checked)
   gateways: 2
   NATTEnable: false (unchecked)
   cableDriver: vxlan
   

6. Espere a que el estado del complemento Submariner se muestre en buen estado (verde). Esto puede tardar hasta 20 minutos.

Paso 7. Instale y configure OpenShift Data Foundation

Managed cluster

Instale y configure ODF en sus 2 clusters gestionados. Asegúrese de completar estos pasos tanto en el clúster gestionado primario como en el secundario.

Antes de ejecutar cualquier oc comandos de esta sección, asegúrate de que el contexto esté configurado en el clúster gestionado que estás configurando. Ejecuta ibmcloud oc cluster config --cluster MANAGED_CLUSTER_NAME_OR_ID --admin para cambiar de contexto y, a continuación, verifica con oc config current-context.

1. Para cada clúster gestionado, instala el complemento OpenShift Data Foundation desde la consola de IBM Cloud.

   1. Ve a la página Descripción general de tu clúster y desplázate hacia abajo hasta la sección Complementos.
   2. En OpenShift Data Foundation, haz clic en Instalar.
   3. Marca la casilla Implementar una puerta de enlace de objetos multicloud d NooBaa.
   4. Vuelve a hacer clic en Instalar para confirmar.
   5. Espera a que el estado del complemento ODF cambie de Enabling a Normal (marca de verificación verde) antes de continuar.

2. Comprueba que ODF se haya instalado correctamente. En la salida, compruebe que el estado dice Ready.

   El estado Normal de la interfaz de usuario indica que el complemento se ha implementado, pero es posible que el operador de ODF aún necesite unos minutos para completar la inicialización y el registro de sus recursos.

   oc get storagecluster -n openshift-storage ocs-storagecluster -o jsonpath='{.status.phase}{"\n"}'
   

Se deben completar los siguientes pasos en cada clúster gestionado. Cambia de contexto al primer clúster gestionado utilizando ibmcloud oc cluster config --cluster MANAGED_CLUSTER_NAME_OR_ID --admin, completa todos los pasos hasta el final de esta sección y, a continuación, cambia al segundo clúster gestionado y repite el proceso.

1. Ejecuta el comando para actualizar el en ACM Managed Cluster Name la sección multiClusterService del storageCluster recurso. Esto permite a ODF utilizar GlobalNet. Para obtener más información, consulte Creación de un clúster de OpenShift Data Foundation en clústeres gestionados.

   Sustituye por MANAGED_CLUSTER_NAME el nombre del clúster al que apunta actualmente tu contexto.

   kubectl patch storagecluster -n openshift-storage ocs-storagecluster --type merge -p'{"spec":{"network":{"multiClusterService":{"clusterID":"MANAGED_CLUSTER_NAME","enabled":true}}}}'
   

   Ejemplo de salida.

   storagecluster.ocs.openshift.io/ocs-storagecluster patched
   

2. Verificar las exportaciones de servicios. Esto puede tardar unos minutos en aparecer en la salida.

   oc get serviceexport -n openshift-storage
   

   Salida de ejemplo:

   NAME              AGE
   rook-ceph-mon-d   4d14h
   rook-ceph-mon-e   4d14h
   rook-ceph-mon-f   4d14h
   rook-ceph-osd-0   4d14h
   rook-ceph-osd-1   4d14h
   rook-ceph-osd-2   4d14h
   

3. Crear una exportación de servicio para ocs-provider-server.

   oc apply -f - <<EOF
   apiVersion: multicluster.x-k8s.io/v1alpha1
   kind: ServiceExport
   metadata:
     name: ocs-provider-server
     namespace: openshift-storage
   EOF
   

   Ejemplo de salida.

   serviceexport.multicluster.x-k8s.io/ocs-provider-server created
   

4. Ejecute el comando para actualizar el recurso storageCluster y utilizar la exportación del servicio ocs-provider-server que ha creado.

   oc annotate storagecluster ocs-storagecluster -n openshift-storage ocs.openshift.io/api-server-exported-address=MANAGED_CLUSTER_NAME.ocs-provider-server.openshift-storage.svc.clusterset.local:50051.
   

   Ejemplo de salida.

   storagecluster.ocs.openshift.io/ocs-storagecluster annotated
   

5. Compruebe que el recurso storageCluster está listo.

   oc get storagecluster -n openshift-storage
   

   Ejemplo de salida.

   NAME                    PHASE  
   ocs-storagecluster      Ready   
   

Paso 8. Configurar la política de recuperación ante desastres regional

Hub cluster

Instala el ODF Multicluster Orchestrator en tu clúster central y crea la política de recuperación ante desastres (DR) que permita la duplicación entre tus dos clústeres gestionados.

1. Instala el ODF Multicluster Orchestrator en el clúster central.

   1. Instala el operador OpenShift ( GitOps ) en el clúster del hub si aún no lo has hecho. Para conocer los pasos de instalación, consulta el final del paso 2. Crea un perfil de confianza para el clúster del hub.
   2. En la vista de la plataforma Core de la consola web OpenShift del clúster central, ve a Ecosistema > Catálogo de software y busca ODF Multicluster Orchestrator.
   3. Haz clic en el mosaico de ODF Multicluster Orchestrator. Asegúrese de seleccionar el mismo número de versión que el de la versión de ODF que instaló en los clústeres gestionados en la sección anterior. Mantén el resto de ajustes predeterminados y haz clic en Instalar.
   4. Asegúrese de que los recursos de operador estén instalados en el proyecto openshift-operators y estén disponibles para todos los espacios de nombres. Vuelve a hacer clic en Instalar para confirmar.

   El ODF Multicluster Orchestrator también instala el operador DR Hub de OpenShift en el clúster central como dependencia.

2. Verifique la instalación comprobando que los pods de operador están en funcionamiento. Asegúrate de que el contexto de la CLI esté configurado en el clúster del hub antes de ejecutar este comando.

   oc get pods -n openshift-operators
   

   Ejemplo de salida.

   NAME                                        READY   STATUS       RESTARTS    AGE
   odf-multicluster-console-6845b795b9-blxrn   1/1     Running      0           4d20h
   odfmo-controller-manager-f9d9dfb59-jbrsd    1/1     Running      0           4d20h
   ramen-hub-operator-6fb887f885-fss4w         2/2     Running      0           4d20h
   

3. En el clúster central, cree una política de recuperación ante desastres con un intervalo de sincronización de 5 minutos y especifique cada clúster gestionado en los parámetros. Esto crea compartimentos de objetos NooBaa tanto en los clústeres gestionados como en los no gestionados, y habilita la duplicación del grupo de bloques Ceph de ODF para la replicación de volúmenes.

   1. En la sección Gestión de flotas de la consola web OpenShift del clúster central, ve a Servicios de datos > Recuperación ante desastres > Políticas > Crear DRPolicy.

   2. Cree una política DR que incluya los siguientes parámetros.

      • Clústeres conectados: PRIMARY_MANAGED_CLUSTER_NAME, SECONDARY_MANAGED_CLUSTER_NAME
      • Política de replicación: Asíncrona
      • Intervalo de replicación: 5m
      • Si procede, selecciona Habilitar soporte de recuperación ante desastres para PersistentVolumeClaims restaurados y clonados (solo para Data Foundation) en Configuración avanzada.

      Red Hat Se indica explícitamente que esta opción solo debe utilizarse con aplicaciones y entornos detectados en los que se admita de forma activa el uso de volúmenes RBD clonados o restaurados.

4. En el clúster central, ejecute los siguientes comandos para comprobar que se ha creado la política de recuperación ante desastres y que se ha aplicado a los clústeres gestionados. Asegúrate de que el contexto de la CLI esté configurado en el clúster del hub antes de ejecutar estos comandos.

   ibmcloud oc cluster config --cluster HUB_CLUSTER_NAME --admin
   

   oc get drpolicy DRPOLICY_NAME -o jsonpath='{.status.conditions[].reason}{"\n"}'
   

   Ejemplo de salida.

   Succeeded
   

   oc get drclusters
   

   Ejemplo de salida.

   NAME               AGE
   managed-cluster1   4m42s
   managed-cluster2   4m42s
   

5. En cada clúster gestionado, compruebe que se haya aplicado la política de recuperación ante desastres y que esté en buen estado. Cambia el contexto de la CLI a cada clúster gestionado antes de ejecutar estos comandos.

   ibmcloud oc cluster config --cluster MANAGED_CLUSTER_NAME --admin
   

   oc get csv,pod -n openshift-dr-system
   

   Ejemplo de salida.

   NAME                                                                          DISPLAY                         VERSION        REPLACES   PHASE
   clusterserviceversion.operators.coreos.com/odr-cluster-operator.v4.15.0       Openshift DR Cluster Operator   4.15.0                    Succeeded
   clusterserviceversion.operators.coreos.com/volsync-product.v0.8.0             VolSync                         0.8.0                     Succeeded
   NAME                                             READY   STATUS    RESTARTS   AGE
   pod/ramen-dr-cluster-operator-6467cf5d4c-cc8kz   2/2     Running   0          3d12h
   

   oc get cephblockpool ocs-storagecluster-cephblockpool -n openshift-storage -o jsonpath='{.status.mirroringStatus.summary}{"\n"}'
   

   Ejemplo de salida.

   {"daemon_health":"OK","health":"OK","image_health":"OK","states":{}}
   

6. Opcional: Revise los operadores que puede instalar para mejorar las funciones de recuperación de desastres regionales de ODF.

7. Opcional: Pruebe su configuración de recuperación ante desastres.

Operadores opcionales para la recuperación regional en caso de catástrofe del ODF

Revise los operadores opcionales que puede instalar en el concentrador ACM o en los clústeres gestionados para mejorar las funciones de recuperación de desastres regionales de ODF. Tenga en cuenta que IBM no es responsable de la gestión de estos operadores.

Usted es responsable de la gestión de estos operadores, lo que incluye, entre otras cosas, la actualización, supervisión, recuperación y reinstalación.

Probar la configuración de recuperación ante desastres

Cree una aplicación de muestra para probar su solución de recuperación ante desastres. Para obtener más información, consulte Crear una aplicación de muestra para probar la aplicación de recuperación ante desastres.

1. Implementar una aplicación basada en suscripción desde la consola ACM. La pestaña de topología de la aplicación se muestra en verde cuando todos los recursos de la aplicación se implementan correctamente.

2. En la página de la aplicación, vaya a Acciones > Gestionar política de datos.

3. Asigne la política de DR creada anteriormente a esta aplicación.

4. Verifique que los pods de la aplicación se estén ejecutando en el clúster principal.

5. En la página de la aplicación, vaya a Acciones > Aplicación de conmutación por error. Seleccione su clúster ODF secundario como clúster de destino. Haga clic en Iniciar.

6. Verifique que los pods de aplicaciones se hayan trasladado al clúster secundario.

7. En la página de la solicitud, vaya a Acciones > Reubicar solicitud. Seleccione su clúster ODF principal como clúster de destino. Haga clic en Iniciar.

8. Verifique que los pods de aplicación se muevan de nuevo al clúster principal.

Actualización de tu entorno regional de recuperación ante desastres de ODF

Para obtener información sobre cuándo y cómo actualizar los componentes de su entorno ODF-RDR, consulte « Actualización de su entorno regional de recuperación ante desastres(ODF )».

Resolución de problemas

Si tienes problemas con la configuración de la recuperación ante desastres regional de ODF, consulta el artículo «Comprobación de la configuración de la recuperación ante desastres regional de Data Foundation de OpenShift » para comprobar el estado de cada componente de tu configuración.

Aplicaciones y cargas de trabajo compatibles

Revisa los tipos de aplicaciones y cargas de trabajo a los que puedes aplicar la recuperación ante desastres regional una vez completada la configuración.

Por suscripción

Una aplicación se despliega desde una fuente externa, como GitHub, un repo Helm, o Object Storage.

Para más información, consulte Creación de una aplicación de ejemplo basada en suscripciones en la documentación de Red Hat.

ApplicationSet-based

Una aplicación se implementa desde un repositorio de GitHub utilizando el operador GitOps, que gestiona la entrega continua. Incluye dos subtipos:

• GitOps Modelo pull ( ArgoCD pull): Un clúster gestionado extrae la aplicación de GitHub utilizando el operador GitOps.

• GitOps Modelo Push ( ArgoCD push): El operador de GitOps empuja la aplicación al clúster gestionado durante los despliegues y actualizaciones.

Para más información, consulte Creación de aplicaciones basadas en conjuntos de aplicaciones en la documentación de Red Hat.

Para obtener más información sobre los subtipos de GitOps, consulte Despliegue de CD Argo con el modelo Push y Pull en la documentación de Red Hat.

Aplicaciones descubiertas

Se ha preimplantado una aplicación en un clúster gestionado sin utilizar ACM. En este caso, puede utilizar la detección ACM para la aplicación preinstalada y seguir configurando la política DR.

Para más información, consulte Protección de recuperación ante desastres para aplicaciones descubiertas en la documentación de Red Hat.

Aplicaciones que incluyen despliegues VM

Una aplicación basada en VM se despliega en el clúster gestionado desde la consola ACM. Estas aplicaciones de VM pueden estar disponibles mediante suscripción, ApplicationSet-based, o ser descubiertas, tal y como se ha descrito anteriormente. Desde la consola ACM se pueden realizar operaciones para iniciar, detener, pausar y eliminar las operaciones de VM en este tipo de aplicaciones.

Para más información, consulte Red Hat Advanced Cluster Management for Virtualization en la documentación de Red Hat.