Antes de Iniciar

Analise as seguintes etapas e informações de pré-requisitos antes de instalar o complemento ACM.

1. Certifique-se de que seus clusters atendam aos seguintes requisitos.
   • Seu cluster de hub deve ser um cluster VPC com pelo menos 3 nós de trabalho que executam o RHCOS e um mínimo de 6 VCPU e 64GB RAM. Para obter alta disponibilidade, certifique-se de que seu cluster tenha pelo menos um nó de trabalho por zona em 3 zonas.
   • Cada cluster gerenciado deve ter pelo menos 3 nós de trabalho que executam o RHCOS e um mínimo de 6 VCPU e 64GB RAM.
2. Analise os operadores que são instalados automaticamente pelo complemento ACM e os operadores opcionais que você pode instalar como aprimoramentos.
3. Você deve ter a função de acesso à plataforma Administrator e a função de acesso ao serviço Manager para o cluster em IBM Cloud Kubernetes Service.
4. É necessário ter um cluster VPC com pelo menos 3 nós de trabalho. Cada nó de trabalho deve ter, no mínimo, 4 CPUs e um 16GB s de RAM. Para obter alta disponibilidade, certifique-se de que seu cluster tenha pelo menos um nó de trabalho por zona em 3 zonas.
5. Crie um perfil confiável em seu cluster para usar no ACM.
6. Para cada cluster que você deseja gerenciar com o ACM, é necessário criar um segredo no cluster do hub com o token de acesso do cluster gerenciado e o servidor URL. Essa etapa pode ser concluída antes ou depois da instalação. Consulte Preparando segredos para a ACM.
7. Instalar ou atualizar a CLI.

Criar um perfil confiável para a ACM

Siga as etapas para criar um perfil confiável a ser usado pelo ACM e atribua-o ao cluster de hubs.

Depois de adicionar um perfil confiável a um cluster, ele não pode ser removido e você não poderá voltar a usar uma chave de API para seus recursos. Certifique-se de seguir estas etapas cuidadosamente para garantir que seu perfil de confiança esteja configurado corretamente.

Preparando segredos para a ACM

Para cada cluster que você deseja gerenciar com o ACM, é necessário criar um segredo no cluster do hub que inclua o token de acesso do cluster gerenciado e o servidor URL.

Se você quiser importar clusters gerenciados durante o processo de instalação do complemento ACM, conclua estas etapas antes de iniciar a instalação. Se você optar por criar os segredos e importar clusters gerenciados depois que o complemento for instalado no cluster do hub, poderá fazer isso concluindo etapas adicionais com a CLI.

Siga as etapas a seguir para cada cluster que você deseja gerenciar.

1. No cluster que você deseja gerenciar com o ACM, execute o comando para localizar o servidor URL. Na saída, localize e anote o valor do Master URL. Este é o servidor URL a ser referenciado no segredo. Você também utilizará este link URL nas etapas a seguir.

   ibmcloud oc cluster get -c CLUSTER_NAME_OR_ID
   

   Exemplo de saída.

   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. Recuperar o endereço base URL do servidor OAuth Red Hat OpenShift. Substitua MASTER_URL pelo endereço URL encontrado na etapa anterior. O comando extrai a base URL sem o sufixo /oauth/token.

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

   Exemplo de saída.

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

3. Recupere um token de acesso usando o endpoint obtido na etapa anterior. Execute o seguinte comando cURL, substituindo URL pelo resultado da etapa anterior e API_KEY pela sua chave de API do IBM Cloud. Na saída, localize o parâmetro “ ACCESS_TOKEN ” contido na resposta “Location ”. Esse é o token de acesso a ser incluído no segredo.

   Exemplo de solicitação curl:

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

   Exemplo de saída. O ACCESS_TOKEN está incluído na string de resposta do 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. No cluster do hub, crie um segredo que contenha o token de acesso ao cluster e o servidor URL. Para obter informações sobre como criar segredos, consulte Trabalhar com segredos na documentação Kubernetes.

   Exemplo de segredo.

   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 da ACM

Analise os operadores que são instalados automaticamente pelo complemento ACM e os operadores opcionais que você pode instalar como aprimoramentos.

Importação de clusters gerenciados após a instalação do ACM

Há várias maneiras de importar clusters para gerenciar com o ACM. Antes de importar um cluster, certifique-se de ter criado o segredo necessário para o ACM.

Todos os clusters gerenciados pelo ACM devem pertencer a um conjunto de clusters. Você pode criar um novo conjunto de clusters ou adicionar clusters ao conjunto de clusters Default. Se nenhum conjunto de clusters for especificado, os clusters gerenciados serão adicionados à opção Default.

Atualização ou remoção de um cluster gerenciado

Para remover ou atualizar o cluster gerenciado de uma instância do ACM, é necessário editar a seção managedClusters do recurso personalizado do ACM no cluster do hub.

1. Execute o comando para editar o recurso ACM.

   oc edit acmhub RESOURCE_NAME
   

2. Na seção managedClusters do recurso, adicione o ID do cluster, o nome do segredo do cluster criado para o ACM, o namespace do segredo e a ação que deseja implementar no cluster. Veja o exemplo abaixo para formatação. Para a ação, especifique Delete ou Update. Observe que, para excluir um cluster, você não precisa do segredo ou do namespace secreto.

   O exemplo a seguir exclui cluster_id_1 e atualiza 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. Salve e aplique as mudanças.

Atualização da versão do ACM

Execute o comando para atualizar o complemento para uma nova versão.

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

Para verificar se o complemento foi atualizado, liste os complementos do cluster. No resultado, procure os detalhes do complemento ACM.

ibmcloud oc cluster addon ls --cluster CLUSTER_ID

Exclusão do complemento ACM

Siga as etapas para excluir o complemento ACM.

1. Exclua o recurso ACM do cluster do hub.

   oc delete acmhub RESOURCE_NAME
   

2. Depois que o recurso for excluído, remova o complemento ACM. Especifique o mesmo ID do cluster.

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