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. Opcional: Se você quiser importar clusters gerenciados durante o processo de instalação do complemento ACM, se planeja importar clusters gerenciados usando a CLI após a instalação ou se planeja atualizar as credenciais de conexão de um cluster gerenciado posteriormente, é necessário criar um segredo no cluster hub para cada cluster gerenciado. Consulte “Preparação de segredos para o ACM ”. Essa etapa não é necessária se você pretender importar apenas clusters gerenciados após a instalação, por meio do console da web do OpenShift.
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

A criação de segredos para o ACM é opcional. Você só precisa preencher esta seção se quiser importar clusters gerenciados durante o processo de instalação do complemento ACM, se planeja importar clusters gerenciados após a instalação usando a CLI ou se planeja atualizar as credenciais de conexão de um cluster gerenciado posteriormente.

Se você planeja importar clusters gerenciados após a instalação usando o console da web do OpenShift e não precisar atualizar as credenciais de conexão posteriormente, não será necessário criar segredos.

Para cada cluster que você deseja gerenciar, execute as etapas a seguir no cluster hub.

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

É possível importar clusters gerenciados após a instalação do ACM, utilizando o console da web do OpenShift ou a CLI. Os métodos baseados no console não exigem um segredo. O método CLI requer um segredo.

Todos os clusters gerenciados pela 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 um cluster gerenciado de uma instância do ACM ou para atualizar as credenciais de conexão do ACM para um cluster gerenciado (por exemplo, após a rotação de tokens ou uma alteração no servidor URL ), é necessário editar a seção managedClusters do recurso personalizado do ACM no cluster hub. A ação “ Update ” atualiza as credenciais baseadas em segredos que o ACM utiliza para se comunicar com um cluster gerenciado. Isso não é o mesmo que atualizar a versão “ OpenShift ” de um cluster.

Para atualizar as credenciais de conexão de um cluster gerenciado, é necessário o segredo desse cluster.

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: "SECRET_NAME"
       secretnamespace: "SECRET_NAMESPACE" # 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