Antes de empezar

Revise los siguientes pasos previos e información antes de instalar el complemento ACM.

1. Asegúrate de que tus clústeres cumplan los siguientes requisitos.
   • Su clúster concentrador debe ser un clúster VPC con al menos 3 nodos trabajadores que ejecuten RHCOS y un mínimo de 6 VCPU y 64GB RAM. Para una alta disponibilidad, asegúrese de que su cluster tiene al menos un nodo trabajador por zona a través de 3 zonas.
   • Cada clúster gestionado debe tener al menos 3 nodos trabajadores que ejecuten RHCOS y un mínimo de 6 VCPU y 64GB RAM.
2. Revise los operadores que instala automáticamente el complemento ACM y los operadores opcionales que puede instalar como mejoras.
3. Debe tener la función de acceso a la plataforma Administrador y la función de acceso al servicio Gestor para el clúster en IBM Cloud Kubernetes Service.
4. Debes disponer de un clúster VPC con al menos 3 nodos de trabajo. Cada nodo de trabajo debe tener un mínimo de 4 CPU y un 16GB s de RAM. Para una alta disponibilidad, asegúrese de que su cluster tiene al menos un nodo trabajador por zona a través de 3 zonas.
5. Cree un perfil de confianza en su clúster para utilizarlo en ACM.
6. Opcional: si desea importar clústeres gestionados durante el proceso de instalación del complemento ACM, si tiene previsto importar clústeres gestionados mediante la CLI tras la instalación, o si tiene previsto actualizar más adelante las credenciales de conexión de un clúster gestionado, debe crear un secreto en el clúster central para cada clúster gestionado. Consulta Preparación de secretos para ACM. Este paso no es necesario si solo tiene previsto importar clústeres gestionados tras la instalación mediante la consola web de OpenShift.
7. Instale o actualice la CLI.

Crear un perfil de confianza para ACM

Sigue los pasos para crear un perfil de confianza que se utilizará para ACM y asígnalo al clúster del hub.

Una vez que añadas un perfil de confianza a un clúster, no podrás eliminarlo ni volver a utilizar una clave API para tus recursos. Asegúrate de seguir estos pasos con atención para garantizar que tu perfil de confianza esté configurado correctamente.

Preparación de secretos para ACM

La creación de secretos para ACM es opcional. Solo es necesario completar esta sección si desea importar clústeres gestionados durante el proceso de instalación del complemento ACM, si tiene previsto importar clústeres gestionados tras la instalación mediante la CLI o si tiene previsto actualizar más adelante las credenciales de conexión de un clúster gestionado.

Si tiene previsto importar clústeres gestionados tras la instalación mediante la consola web de OpenShift y no necesita actualizar las credenciales de conexión posteriormente, no es necesario que cree secretos.

Para cada clúster que desee gestionar, siga los siguientes pasos en el clúster central.

1. En el clúster que desea gestionar con ACM, ejecute el comando para buscar el servidor URL. En la salida, busque y anote el valor Master URL. Este es el servidor URL para hacer referencia en el secreto. También utilizarás este URL en los siguientes pasos.

   ibmcloud oc cluster get -c CLUSTER_NAME_OR_ID
   

   Ejemplo de salida.

   NAME:                           mycluster
   ID:                             1234567
   State:                          normal
   Created:                        2025-01-22T19:22:16+0000
   Location:                       dal10
   Master URL:                     https://c100-e.<region>.containers.cloud.ibm.com:<port>
   ...
   

2. Recupera la URL base URL del servidor OAuth Red Hat OpenShift. Sustituye MASTER_URL por el URL que has encontrado en el paso anterior. El comando extrae la dirección base URL sin el sufijo /oauth/token.

   curl -sS MASTER_URL/.well-known/oauth-authorization-server | jq -r .token_endpoint | sed 's#/oauth/token##'
   

   Ejemplo de salida.

   https://c111-e.us-east.containers.cloud.ibm.com:31282
   

3. Obtén un token de acceso utilizando el punto de conexión obtenido en el paso anterior. Ejecuta el siguiente comando cURL, sustituyendo URL por el resultado del paso anterior y API_KEY por tu clave de API de IBM Cloud. En el resultado, busca el que figura ACCESS_TOKEN en la respuesta Location. Este es el token de acceso a incluir en el secreto.

   Ejemplo de solicitud de curl:

   curl -u 'apikey:API_KEY' -H "X-CSRF-Token: a" 'URL/oauth/authorize?client_id=openshift-challenging-client&response_type=token' -vvv
   

   Ejemplo de salida. El ACCESS_TOKEN se incluye en la cadena de respuesta de Location.

   < HTTP/1.1 302 Found
   < Cache-Control: no-cache, no-store, max-age=0, must-revalidate
   < Cache-Control: no-cache, no-store, max-age=0, must-revalidate
   < Expires: 0
   < Expires: Fri, 01 Jan 2030 00:00:00 GMT
   < Location: TOKEN_ENDPOINT/oauth/token/implicit#access_token=ACCESS_TOKEN&expires_in=86400&scope=user%3Afull&token_type=Bearer
   ...
   

4. En el clúster concentrador, cree un secreto que contenga el token de acceso al clúster y el servidor URL. Para obtener información sobre la creación de secretos, consulte Trabajar con secretos en la documentación de Kubernetes.

   Secreto de ejemplo.

   apiVersion: v1
   kind: Secret
   metadata:
     name: SECRET_NAME
     namespace: SECRET_NAMESPACE  # The namespace that the secret is to be created in
   type: Opaque
   stringData:
     token: ACCESS_TOKEN
     server: SERVER_URL
   

Operadores de ACM

Revise los operadores que instala automáticamente el complemento ACM y los operadores opcionales que puede instalar como mejoras.

Importación de clústeres gestionados tras la instalación de ACM

Una vez instalado ACM, puedes importar clústeres gestionados mediante la consola web OpenShift o la CLI. Los métodos basados en la consola no requieren una clave secreta. El método CLI requiere una clave secreta.

Todos los clústeres gestionados por ACM deben pertenecer a un conjunto de clústeres. Puede crear un nuevo conjunto de clústeres o añadir clústeres al conjunto de Default. Si no se especifica ningún conjunto de clústeres, los clústeres gestionados se añaden a la opción Default.

Actualización o eliminación de un clúster gestionado

Para eliminar un clúster gestionado de una instancia de ACM, o para actualizar las credenciales de conexión de ACM para un clúster gestionado (por ejemplo, tras una rotación de tokens o un cambio en el servidor URL ), debe editar la sección managedClusters del recurso personalizado de ACM en el clúster del hub. Esta Update acción actualiza las credenciales basadas en secretos que utiliza ACM para comunicarse con un clúster gestionado. Esto no es lo mismo que actualizar la versión OpenShift de un clúster.

Para actualizar las credenciales de conexión de un clúster gestionado se necesita el secreto de dicho clúster.

1. Ejecute el comando para editar el recurso ACM.

   oc edit acmhub RESOURCE_NAME
   

2. En la sección managedClusters del recurso, añada el ID del clúster, el nombre del secreto del clúster creado para ACM, el espacio de nombres para el secreto y la acción que desea implementar para el clúster. Consulte el ejemplo siguiente para ver el formato. Para la acción, especifica o Delete Update. Tenga en cuenta que para eliminar un clúster, no necesita el secreto o el espacio de nombres secreto.

   El siguiente ejemplo elimina CLUSTER_ID_1 y actualiza CLUSTER_ID_2.

   managedclusters:
     - clusterid: "CLUSTER_ID_1"
       action: "Delete"
     - clusterid: "CLUSTER_ID_2"
       secretname: "SECRET_NAME"
       secretnamespace: "SECRET_NAMESPACE" # The namespace that the secret was created in
       action: "Update"
   

3. Guarde y aplique los cambios.

Actualización de la versión de ACM

Ejecute el comando para actualizar el complemento a una nueva versión.

ibmcloud oc cluster addon update acm --cluster CLUSTER_ID --version ADD-ON_VERSION

Para comprobar que el complemento se ha actualizado, haga una lista de los complementos de su clúster. En la salida, busque los detalles del complemento ACM.

ibmcloud oc cluster addon ls --cluster CLUSTER_ID

Eliminar el complemento ACM

Siga los pasos para eliminar el complemento ACM.

1. Elimine el recurso ACM del clúster de concentradores.

   oc delete acmhub RESOURCE_NAME
   

2. Una vez eliminado el recurso, elimine el complemento ACM. Especifica el mismo ID de clúster.

   ibmcloud oc cluster addon disable acm -f --cluster CLUSTER_ID