Prima di iniziare

Prima di installare il componente aggiuntivo ACM, esaminare i passaggi e le informazioni sui prerequisiti riportati di seguito.

1. Assicurarsi che i cluster soddisfino i seguenti requisiti.
   • Il cluster hub deve essere un cluster VPC con almeno 3 nodi worker che eseguono RHCOS e un minimo di 6 VCPU e 64GB RAM. Per l'alta disponibilità, assicurarsi che il cluster abbia almeno un nodo worker per zona su 3 zone.
   • Ogni cluster gestito deve avere almeno 3 nodi worker che eseguono RHCOS e un minimo di 6 VCPU e 64GB RAM.
2. Esaminare gli operatori installati automaticamente dal componente aggiuntivo ACM e gli operatori opzionali che si possono installare come miglioramenti.
3. È necessario avere il ruolo di accesso alla piattaforma Administrator e il ruolo di accesso al servizio Manager per il cluster in IBM Cloud Kubernetes Service.
4. È necessario disporre di un cluster VPC con almeno 3 nodi worker. Ogni nodo worker deve avere un minimo di 4 CPU e 16GB RAM. Per l'alta disponibilità, assicurarsi che il cluster abbia almeno un nodo worker per zona su 3 zone.
5. Creare un profilo di fiducia sul cluster da utilizzare per ACM.
6. Per ogni cluster che si desidera gestire con ACM, è necessario creare un segreto sul cluster hub con il token di accesso del cluster gestito e il server URL. Questa fase può essere completata prima o dopo l'installazione. Vedere Preparazione dei segreti per l'ACM.
7. Installare o aggiornare la CLI.

Creare un profilo di fiducia per ACM

Segui la procedura indicata per creare un profilo attendibile da utilizzare con ACM e assegnarlo al cluster hub.

Una volta aggiunto un profilo attendibile a un cluster, non è più possibile rimuoverlo né tornare a utilizzare una chiave API per le proprie risorse. Assicurati di seguire attentamente questi passaggi per garantire che il tuo profilo di fiducia sia configurato correttamente.

Preparare i segreti per l'ACM

Per ogni cluster che si desidera gestire con ACM, è necessario creare un segreto sul cluster hub che includa il token di accesso del cluster gestito e il server URL.

Se si desidera importare i cluster gestiti durante il processo di installazione del componente aggiuntivo ACM, completare questi passaggi prima di iniziare l'installazione. Se si sceglie di creare i segreti e importare i cluster gestiti dopo che il componente aggiuntivo è stato installato sul cluster hub, è possibile farlo completando ulteriori passaggi con la CLI.

Completare i passaggi seguenti per ogni cluster che si desidera gestire.

1. Sul cluster che si vuole gestire con ACM, eseguire il comando per trovare il server URL. Nell'output, individuare e annotare il valore di Master URL. È il server URL a cui fare riferimento nel segreto. Questo URL viene utilizzato anche nelle fasi successive.

   ibmcloud oc cluster get -c CLUSTER_NAME_OR_ID
   

   Output di esempio.

   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 l' URL e di base del server OAuth Red Hat OpenShift. Sostituisci MASTER_URL con l' URL e individuato nel passaggio precedente. Il comando estrae l'indirizzo di base URL senza il suffisso /oauth/token.

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

   Output di esempio.

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

3. Recupera un token di accesso utilizzando l'endpoint ottenuto nel passaggio precedente. Esegui il seguente comando cURL, sostituendo URL con l'output del passaggio precedente e API_KEY con il tuo [IBM Cloud Chiave API](https://cloud.ibm.com/iam/apikeys){: external}. Nell'output, individua l' ACCESS_TOKEN e contenuto nella risposta "Location ". È il token di accesso da includere nel segreto.

   Richiesta curl di esempio:

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

   Output di esempio. L'ACCESS_TOKEN è incluso nella stringa di risposta di 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. Sul cluster hub, creare un segreto che contenga il token di accesso al cluster e il server URL. Per informazioni sulla creazione di segreti, vedere Lavorare con i segreti nella documentazione di Kubernetes.

   Esempio di segreto.

   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
   

Operatori ACM

Esaminare gli operatori installati automaticamente dal componente aggiuntivo ACM e gli operatori opzionali che si possono installare come miglioramenti.

Importazione dei cluster gestiti dopo l'installazione di ACM

Esistono diversi modi per importare i cluster da gestire con ACM. Prima di importare un cluster, assicurarsi di aver creato il segreto necessario per ACM.

Tutti i cluster gestiti da ACM devono appartenere a un insieme di cluster. È possibile creare un nuovo set di cluster o aggiungere cluster al set di cluster Default. Se non viene specificato alcun set di cluster, i cluster gestiti vengono aggiunti all'opzione Default.

Aggiornamento o rimozione di un cluster gestito

Per rimuovere o aggiornare il cluster gestito da un'istanza ACM, è necessario modificare la sezione managedClusters della risorsa personalizzata ACM sul cluster hub.

1. Eseguire il comando per modificare la risorsa ACM.

   oc edit acmhub RESOURCE_NAME
   

2. Nella sezione managedClusters della risorsa, aggiungere l'ID del cluster, il nome del segreto del cluster creato per ACM, lo spazio dei nomi per il segreto e l'azione che si desidera implementare per il cluster. Per la formattazione, vedere l'esempio seguente. Per l'azione, specificare Delete o Update. Si noti che per eliminare un cluster non sono necessari il segreto o lo spazio dei nomi segreto.

   L'esempio seguente cancella cluster_id_1 e aggiorna 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. Salvare e applicare le modifiche.

Aggiornamento della versione di ACM

Eseguire il comando per aggiornare il componente aggiuntivo a una nuova versione.

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

Per verificare che il componente aggiuntivo sia stato aggiornato, elencare i componenti aggiuntivi del cluster. Nell'output, cercare i dettagli del componente aggiuntivo ACM.

ibmcloud oc cluster addon ls --cluster CLUSTER_ID

Eliminazione del componente aggiuntivo ACM

Seguire la procedura per eliminare il componente aggiuntivo ACM.

1. Eliminare la risorsa ACM dal cluster hub.

   oc delete acmhub RESOURCE_NAME
   

2. Dopo aver eliminato la risorsa, rimuovere il componente aggiuntivo ACM. Specificare lo stesso ID del cluster.

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