Antes de empezar

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

1. Asegúrese de que sus 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. Para cada clúster que desee gestionar con ACM, debe crear un secreto en el clúster concentrador con el token de acceso del clúster gestionado y el servidor URL. Este paso puede realizarse antes o después de la instalación. Véase Preparación de secretos para ACM.
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

Para cada clúster que desee gestionar con ACM, debe crear un secreto en el clúster concentrador que incluya el token de acceso del clúster gestionado y el servidor URL.

Si desea importar clústeres gestionados durante el proceso de instalación del complemento ACM, complete estos pasos antes de iniciar la instalación. Si decide crear los secretos e importar clústeres gestionados después de instalar el complemento en el clúster concentrador, puede hacerlo completando pasos adicionales con la CLI.

Sigue los siguientes pasos para cada clúster que desees gestionar.

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

Hay varias formas de importar clusters para gestionarlos con ACM. Antes de importar un clúster, asegúrese de haber creado el secreto necesario para ACM.

Todos los clusters gestionados por ACM deben pertenecer a un conjunto de clusters. 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 o actualizar el clúster gestionado de una instancia de ACM, debe editar la sección managedClusters del recurso personalizado de ACM en el clúster central.

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, especifique, Delete o Update. Tenga en cuenta que para eliminar un clúster, no necesita el secreto o el espacio de nombres secreto.

   El siguiente ejemplo borra cluster_id_1 y actualiza cluster_id_2.

   managedclusters:
     - clusterid: "cluster_id_1"
       action: "Delete"
     - clusterid: "cluster_id_2"
       secretname: "managed-secret-2"
       secretnamespace: "managed-namespace-2" # 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