Criação de uma funcionalidade do kro por meio do Console - Amazon EKS
Criação da funcionalidade do kroVerificação da ativação da funcionalidadeConcessão de permissões para o gerenciamento de recursos do KubernetesVerificação da disponibilidade de recursos personalizadosPróximas etapas

Ajudar a melhorar esta página

Para contribuir com este guia de usuário, escolha o link Editar esta página no GitHub, disponível no painel direito de cada página.

Criação de uma funcionalidade do kro por meio do Console

Este tópico descreve como criar uma funcionalidade do kro (Kube Resource Orchestrator) usando o Console de gerenciamento da AWS.

Criação da funcionalidade do kro

  1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home#/clusters.

  2. Selecione o nome do cluster para abrir a página de detalhes do cluster.

  3. Escolha a guia Funcionalidades.

  4. No painel de navegação à esquerda, escolha kro (Kube Resource Orchestrator).

  5. Selecione Criar funcionalidade do kro.

  6. No perfil da funcionalidade do IAM:

    • Se você já tiver um perfil da funcionalidade do IAM, selecione-o no menu suspenso

    • Se a criação de um perfil for necessária, escolha Criar perfil do kro

      Isso abre o console do IAM em uma nova guia com a política de confiança preenchida previamente. O perfil não requer permissões do IAM adicionais, uma vez que o kro opera inteiramente no cluster.

      Após criar o perfil, retorne ao console do EKS e o perfil será selecionado automaticamente.

      nota

      Ao contrário do ACK e do Argo CD, o kro não requer permissões do IAM adicionais além da política de confiança. O kro opera inteiramente no cluster e não faz chamadas de API da AWS.

  7. Escolha Criar.

O processo de criação da funcionalidade é iniciado.

Verificação da ativação da funcionalidade

  1. Na guia Funcionalidades, visualize o status da funcionalidade do kro.

  2. Aguarde até que o status mude de CREATING para ACTIVE.

  3. Assim que estiver com o status ativo, a funcionalidade estará pronta para uso.

Para obter informações sobre os status das funcionalidades e sobre a solução de problemas, consulte Como trabalhar com recursos de funcionalidade.

Concessão de permissões para o gerenciamento de recursos do Kubernetes

Quando você cria um recurso kro, uma entrada de acesso do EKS é criada automaticamente com a AmazonEKSKROPolicy, o que permite que o kro gerencie ResourceGraphDefinitions e suas instâncias. Contudo, nenhuma permissão é concedida por padrão para criar os recursos subjacentes do Kubernetes (como implantações, serviços, ConfigMaps etc.) definidos em suas ResourceGraphDefinitions.

Esse design intencional segue o princípio de privilégio mínimo, em que definições de gráficos de recursos diferentes exigem permissões diferentes. É necessário configurar explicitamente as permissões de que o kro precisa com base nos recursos que suas ResourceGraphDefinitions gerenciarão.

Para começar rapidamente, testar ou desenvolver ambientes, use a AmazonEKSClusterAdminPolicy:

  1. No console do EKS, acesse a guia Acesso do cluster.

  2. Em Entradas de acesso, localize a entrada referente ao perfil da funcionalidade para o kro (ela terá o ARN do perfil que você criou anteriormente).

  3. Selecione a entrada de acesso para visualizar os detalhes.

  4. Na seção Políticas de acesso, escolha Associar política de acesso.

  5. Selecione AmazonEKSClusterAdminPolicy na lista de políticas.

  6. Em Escopo de acesso, selecione Cluster.

  7. Selecione Associar.

Importante

A AmazonEKSClusterAdminPolicy concede permissões abrangentes para criar e gerenciar todos os recursos do Kubernetes, incluindo a capacidade de criar qualquer tipo de recurso em todos os namespaces. Isso é conveniente para desenvolvimento e POCs, mas não deve ser usado em ambientes de produção. Para ambientes de produção, crie políticas de RBAC personalizadas que concedam somente as permissões necessárias para os recursos específicos que as ResourceGraphDefinitions gerenciarão. Para obter orientações sobre como configurar permissões de privilégio mínimo, consulte Configuração de permissões do kro e Considerações sobre segurança para funcionalidades do EKS.

Verificação da disponibilidade de recursos personalizados

Após a funcionalidade estar ativa, verifique se os recursos personalizados do kro estão disponíveis no cluster.

Utilizar o console

  1. Navegue até o cluster no console do Amazon EKS

  2. Escolha a guia Recursos

  3. Escolha Extensões

  4. Escolha CustomResourceDefinitions

O tipo de recurso ResourceGraphDefinition deve aparecer na lista apresentada.

Uso do kubectl 

kubectl api-resources | grep kro.run

O tipo de recurso ResourceGraphDefinition deve aparecer na lista apresentada.

Próximas etapas