**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 um cluster com o modo automático do Amazon EKS Este capítulo explica como criar um cluster do Amazon EKS com o Modo Automático habilitado usando várias ferramentas e interfaces. O Modo Automático simplifica a criação de clusters configurando e gerenciando automaticamente a infraestrutura de computação, rede e armazenamento do cluster. Você aprenderá a criar um cluster do Modo Automático usando a AWS CLI, o Console de gerenciamento da AWS ou a ferramenta de linha de comandos do eksctl. **nota** O Modo Automático do EKS requer a versão 1.29 ou superior do Kubernetes. Escolha a ferramenta de preferência com base em suas necessidades: o Console de gerenciamento da AWS fornece uma interface visual ideal para aprender sobre os recursos do Modo Automático do EKS e criar clusters individuais. A AWS CLI é mais adequada para tarefas de script e automação, especialmente ao integrar a criação de clusters em fluxos de trabalho ou pipelines de CI/CD existentes. A CLI do eksctl oferece uma experiência nativa do Kubernetes e é recomendada para usuários familiarizados com as ferramentas do Kubernetes que desejam operações de linha de comando simplificadas com padrões adequados. Antes de começar, verifique se você tem os pré-requisitos necessários instalados e configurados, incluindo as permissões apropriadas do IAM para criar clusters do EKS. Para saber como instalar ferramentas da CLI, como `kubectl`, `aws` e `eksctl`, consulte [Configurar para usar o Amazon EKS](setting-up.md). Você pode usar a AWS CLI, o Console de gerenciamento da AWS ou a CLI do eksctl para criar um cluster com o Modo Automático do Amazon EKS. **Topics** + [Criar um cluster do Modo Automático do EKS com a CLI do eksctl](automode-get-started-eksctl.md) + [Criar um cluster do Modo Automático do EKS com a AWS CLI](automode-get-started-cli.md) + [Criar um cluster do Modo Automático do EKS com o Console de gerenciamento da AWS](automode-get-started-console.md) # Criar um cluster do Modo Automático do EKS com a CLI do eksctl Este tópico mostra como criar um cluster do Modo Automático do Amazon EKS usando a interface de linha de comandos (CLI) do eksctl. Você pode criar um cluster do Modo Automático executando um único comando da CLI ou aplicando um arquivo de configuração YAML. Ambos os métodos fornecem a mesma funcionalidade, com a abordagem de YAML oferecendo um controle mais granular das configurações do cluster. A CLI do eksctl simplifica o processo de criação e gerenciamento de clusters do Modo Automático do EKS ao lidar com a criação e configuração de recursos subjacentes da AWS. Antes de prosseguir, certifique-se de ter as credenciais e permissões da AWS necessárias configuradas na máquina local. Este guia pressupõe que você esteja familiarizado com os conceitos básicos do Amazon EKS e já tenha instalado as ferramentas de CLI necessárias. **nota** Você deve instalar a versão `0.195.0` ou superior do eksctl. Para obter mais informações, consulte as [versões do eksctl](https://github.com/eksctl-io/eksctl/releases) no GitHub. ## Criar um cluster do Modo Automático do EKS com um comando da CLI Você deve ter as ferramentas da `aws` e do `eksctl` instaladas. Você deve estar conectado à AWS CLI com permissões suficientes para gerenciar recursos da AWS, incluindo: instâncias do EC2, redes do EC2, clusters do EKS e perfis do IAM. Para ter mais informações, consulte [Configurar para usar o Amazon EKS](setting-up.md). Execute o comando a seguir para criar um cluster do Modo Automático do EKS com ``` eksctl create cluster --name= --enable-auto-mode ``` ## Crie um cluster do Modo Automático do EKS com um arquivo YAML Você deve ter as ferramentas da `aws` e do `eksctl` instaladas. Você deve estar conectado à AWS CLI com permissões suficientes para gerenciar recursos da AWS, incluindo: instâncias do EC2, redes do EC2, clusters do EKS e perfis do IAM. Para ter mais informações, consulte [Configurar para usar o Amazon EKS](setting-up.md). Analise as opções de configuração do Modo Automático do EKS no exemplo do recurso ClusterConfig abaixo. Para conferir a especificação completa do ClusterConfig, consulte a [documentação do eksctl](https://eksctl.io/usage/creating-and-managing-clusters/). AWS sugere habilitar o Modo Automático do EKS. Se esta for a primeira vez que você cria um cluster do Modo Automático do EKS, deixe o `nodeRoleARN` não especificado criar um perfil do IAM do nó para o Modo Automático do EKS. Caso já tenha um perfil do IAM do nó na conta da AWS, a AWS sugere reutilizá-la. AWS sugere não especificar nenhum valor para `nodePools`. O Modo Automático do EKS criará grupos de nós padrão. Você pode usar a API do Kubernetes para criar grupos de nós adicionais. ``` # cluster.yaml apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: region: iam: # ARN of the Cluster IAM Role # optional, eksctl creates a new role if not supplied # suggested to use one Cluster IAM Role per account serviceRoleARN: autoModeConfig: # defaults to false enabled: boolean # optional, defaults to [general-purpose, system]. # suggested to leave unspecified # To disable creation of nodePools, set it to the empty array ([]). nodePools: []string # optional, eksctl creates a new role if this is not supplied # and nodePools are present. nodeRoleARN: string ``` Salve o arquivo `ClusterConfig` como `cluster.yaml` e use o seguinte comando para criar o cluster: ``` eksctl create cluster -f cluster.yaml ``` # Criar um cluster do Modo Automático do EKS com a AWS CLI Os clusters de modo automático do EKS automatizam as tarefas de rotina de gerenciamento de clusters para computação, armazenamento e rede. Por exemplo, os clusters do Modo Automático do EKS detectam automaticamente quando nós adicionais são necessários e provisionam novas instâncias do EC2 para atender às demandas de workloads. Este tópico orienta você na criação de um novo cluster do Modo Automático do EKS usando a AWS CLI e, opcionalmente, na implantação de uma workload de exemplo. ## Pré-requisitos + A versão mais recente da AWS Command Line Interface (AWS CLI) instalada e configurada no seu dispositivo. Para verificar sua versão atual, use `aws --version`. Para instalar a versão mais recente, consulte [Instalar](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [Configuração rápida com aws configure](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-configure-quickstart-config), no Guia do usuário da AWS Command Line Interface. + Faça login na CLI com permissões suficientes do IAM para criar recursos da AWS, incluindo políticas do IAM, perfis do IAM e clusters do EKS. + A ferramenta de linha de comando do kubectl instalada no dispositivo. A AWS sugere que você use a mesma versão do kubectl que a versão do Kubernetes do cluster do EKS. Para instalar ou atualizar o kubectl, consulte [Configurar o `kubectl` e o `eksctl`](install-kubectl.md). ## Especificar sub-redes da VPC O Modo Automático do Amazon EKS implanta nós em sub-redes da VPC. Ao criar um cluster do EKS, você deve especificar as sub-redes da VPC nas quais os nós serão implantados. Você pode usar as sub-redes da VPC padrão na conta da AWS ou criar uma VPC dedicada para workloads críticas. + A AWS sugere a criação de uma VPC dedicada para o cluster. Saiba como [Criar uma Amazon VPC para o cluster do Amazon EKS](creating-a-vpc.md). + O console do EKS ajuda na criação de uma nova VPC. Saiba como [Criar um cluster do Modo Automático do EKS com o Console de gerenciamento da AWS](automode-get-started-console.md). + Como alternativa, você pode usar a VPC padrão da conta da AWS. Use as instruções a seguir para encontrar os IDs de sub-rede. ### Para encontrar os IDs de sub-redes da VPC padrão **Usar a AWS CLI:** 1. Execute o comando a seguir para listar a VPC padrão e suas sub-redes: ``` aws ec2 describe-subnets --filters "Name=vpc-id,Values=$(aws ec2 describe-vpcs --query 'Vpcs[?IsDefault==`true`].VpcId' --output text)" --query 'Subnets[*].{ID:SubnetId,AZ:AvailabilityZone}' --output table ``` 1. Salve a saída e anote os **IDs das sub-redes**. Exemplo de resultado: ``` ---------------------------------------- | DescribeSubnets | ---------------------------------------- | SubnetId | AvailabilityZone | |--------------------|---------------------| | subnet-012345678 | us-west-2a | | subnet-234567890 | us-west-2b | | subnet-345678901 | us-west-2c | ---------------------------------------- ``` ## Perfis do IAM de clusters do Modo Automático do EKS ### Perfil do IAM do cluster O Modo Automático do EKS exige um perfil do IAM do cluster para realizar ações na conta da AWS, como provisionar novas instâncias do EC2. Você deve criar esse perfil para conceder ao EKS as permissões necessárias. A AWS recomenda anexar as seguintes políticas gerenciadas pela AWS ao perfil do IAM do cluster: + [AmazonEKSComputePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSComputePolicy) + [AmazonEKSBlockStoragePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSBlockStoragePolicy) + [AmazonEKSLoadBalancingPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSLoadBalancingPolicy) + [AmazonEKSNetworkingPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSNetworkingPolicy) + [AmazonEKSClusterPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-amazoneksclusterpolicy) ### Perfil do IAM do nó Ao criar um cluster do Modo Automático do EKS, você especifica um perfil do IAM do nó. Quando o Modo Automático do EKS cria nós para processar workloads pendentes, cada novo nó de instância do EC2 recebe o perfil do IAM do nó. Esse perfil permite que o nó se comunique com o EKS, mas geralmente não é acessado pelas workloads em execução no nó. Se você quiser conceder permissões para workloads em execução em um nó, use a Identidade de Pods do EKS. Para obter mais informações, consulte [Saiba como a Identidade de Pods do EKS concede aos pods acesso aos serviços da AWS](pod-identities.md). Você deve criar esse perfil e anexar a seguinte política gerenciada pela AWS: + [AmazonEKSWorkerNodeMinimalPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSWorkerNodeMinimalPolicy) + [AmazonEC2ContainerRegistryPullOnly](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonEC2ContainerRegistryPullOnly) O Modo Automático do EKS também requer um perfil vinculado ao serviço, que é criado e configurado automaticamente pela AWS. Para obter mais informações, consulte [AWSServiceRoleForAmazonEKS](using-service-linked-roles-eks.md). ## Criar um perfil do IAM do cluster do Modo Automático do EKS ### Etapa 1: criar a política de confiança Crie uma política de confiança para permitir que o serviço do Amazon EKS assuma o perfil. Salve a política como `trust-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "eks.amazonaws.com" }, "Action": [ "sts:AssumeRole", "sts:TagSession" ] } ] } ``` ### Etapa 2: criar o perfil do IAM Use a política de confiança para criar o perfil do IAM do cluster: ``` aws iam create-role \ --role-name AmazonEKSAutoClusterRole \ --assume-role-policy-document file://trust-policy.json ``` ### Etapa 3: registre o ARN do perfil Recupere e salve o ARN do novo perfil para uso nas etapas subsequentes: ``` aws iam get-role --role-name AmazonEKSAutoClusterRole --query "Role.Arn" --output text ``` ### Etapa 4: anexar as políticas necessárias Anexe as seguintes políticas gerenciadas pela AWS ao perfil do IAM do cluster para conceder as permissões necessárias: **AmazonEKSClusterPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSClusterPolicy ``` **AmazonEKSComputePolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSComputePolicy ``` **AmazonEKSBlockStoragePolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSBlockStoragePolicy ``` **AmazonEKSLoadBalancingPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSLoadBalancingPolicy ``` **AmazonEKSNetworkingPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSNetworkingPolicy ``` ## Criar um perfil do IAM do nó do Modo Automático do EKS ### Etapa 1: criar a política de confiança Crie uma política de confiança para permitir que o serviço do Amazon EKS assuma o perfil. Salve a política como `node-trust-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` #### Etapa 2: criar o perfil do IAM do nó Use o arquivo **node-trust-policy.json** da etapa anterior para definir quais entidades podem assumir o perfil. Execute o seguinte comando para criar o perfil do IAM do nó: ``` aws iam create-role \ --role-name AmazonEKSAutoNodeRole \ --assume-role-policy-document file://node-trust-policy.json ``` #### Etapa 3: registre o ARN do perfil Depois de criar o perfil, recupere e salve o ARN do perfil do IAM do nó. Você precisará desse ARN nas etapas subsequentes. Use o seguinte comando para obter o ARN: ``` aws iam get-role --role-name AmazonEKSAutoNodeRole --query "Role.Arn" --output text ``` #### Etapa 4: anexar as políticas necessárias Anexe as seguintes políticas gerenciadas pela AWS ao perfil do IAM do nó para fornecer as permissões necessárias: **AmazonEKSWorkerNodeMinimalPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoNodeRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSWorkerNodeMinimalPolicy ``` **AmazonEC2ContainerRegistryPullOnly**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoNodeRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryPullOnly ``` ## Criar um cluster do Modo Automático do EKS ### Visão geral Para criar um cluster de Modo Automático do EKS usando a AWS CLI, você precisará dos seguintes parâmetros: + `cluster-name`: o nome do cluster. + `k8s-version`: a versão do Kubernetes (por exemplo, 1.31). + `subnet-ids`: IDs de sub-rede identificados nas etapas anteriores. + `cluster-role-arn`: ARN do perfil do IAM do cluster. + `node-role-arn`: ARN do perfil do IAM do nó. #### Configurações padrão do cluster Analise estes valores e recursos padrão antes de criar o cluster: + `nodePools`: o Modo Automático do EKS inclui grupos de nós de uso geral e padrão do sistema. Saiba mais sobre [Grupos de nós](create-node-pool.md). **Observação:** os grupos de nós no Modo Automático do EKS diferem dos grupos dos nós gerenciados pelo Amazon EKS, mas podem coexistir no mesmo cluster. + `computeConfig.enabled`: automatiza tarefas computacionais de rotina, como criar e excluir instâncias do EC2. + `kubernetesNetworkConfig.elasticLoadBalancing.enabled`: automatiza as tarefas de balanceamento de carga, incluindo a criação e exclusão de Elastic Load Balancers. + `storageConfig.blockStorage.enabled`: automatiza tarefas de armazenamento, como criar e excluir volumes do Amazon EBS. + `accessConfig.authenticationMode`: requer entradas de acesso do EKS. Saiba mais sobre os [modos de autenticação do EKS](grant-k8s-access.md). #### Executar o comando Use o seguinte comando para criar o cluster: ``` aws eks create-cluster \ --region ${AWS_REGION} \ --cli-input-json \ "{ \"name\": \"${CLUSTER_NAME}\", \"version\": \"${K8S_VERSION}\", \"roleArn\": \"${CLUSTER_ROLE_ARN}\", \"resourcesVpcConfig\": { \"subnetIds\": ${SUBNETS_JSON}, \"endpointPublicAccess\": true, \"endpointPrivateAccess\": true }, \"computeConfig\": { \"enabled\": true, \"nodeRoleArn\":\"${NODE_ROLE_ARN}\", \"nodePools\": [\"general-purpose\", \"system\"] }, \"kubernetesNetworkConfig\": { \"elasticLoadBalancing\": { \"enabled\": true } }, \"storageConfig\": { \"blockStorage\": { \"enabled\": true } }, \"accessConfig\": { \"authenticationMode\": \"API\" } }" ``` ### Verificar o status do cluster #### Etapa 1: verificar a criação do cluster Execute o comando a seguir para verificar o status do cluster. A criação do cluster normalmente leva cerca de 15 minutos. ``` aws eks describe-cluster --name "${CLUSTER_NAME}" --output json ``` #### Etapa 2: atualizar o kubeconfig Quando o cluster estiver pronto, atualize o arquivo kubeconfig local para permitir que o `kubectl` se comunique com o cluster. Esta configuração usa a AWS CLI para autenticação. ``` aws eks update-kubeconfig --name "${CLUSTER_NAME}" ``` #### Etapa 3: verificar grupos de Node Listar os grupos de nós no cluster com o comando a seguir: ``` kubectl get nodepools ``` ## Próximas etapas + Saiba como [implantar uma workload de exemplo](automode-workload.md) no novo cluster do Modo Automático do EKS. # Criar um cluster do Modo Automático do EKS com o Console de gerenciamento da AWS Criar um cluster do Modo Automático do EKS no Console de gerenciamento da AWS requer menos configuração do que outras opções. O EKS se integra ao AWS IAM e à rede de VPC para ajudar a criar os recursos associados a um cluster do EKS. Você tem duas opções para criar um cluster no console: + Configuração rápida (com o Modo Automático do EKS) + Configuração personalizada Neste tópico, você aprenderá como criar um cluster do Modo Automático do EKS usando a opção Configuração rápida. ## Criar um Modo Automático do EKS usando a opção de configuração rápida Você deve estar conectado ao Console de gerenciamento da AWS com permissões suficientes para gerenciar recursos da AWS, incluindo: instâncias do EC2, redes do EC2, clusters do EKS e perfis do IAM. 1. Navegue até o console do EKS. 1. Clique em **Criar cluster**. 1. Confirme se a opção **Configuração rápida** está selecionada. 1. Determine os valores a seguir ou use os padrões para um cluster de teste. + **Nome** do cluster + Versão do Kubernetes 1. Selecione o perfil do IAM do cluster. Se esta for a primeira vez que você cria um cluster do Modo Automático do EKS, use a opção **Criar perfil recomendado**. + Opcionalmente, você pode reutilizar um único perfil do IAM do cluster na conta da AWS para todos os clusters do Modo Automático do EKS. + O perfil do IAM do cluster inclui as permissões necessárias para o Modo Automático do EKS gerenciar recursos, incluindo instâncias do EC2, volumes do EBS e balanceadores de carga do EC2. + A opção **Criar perfil recomendado** preenche previamente todos os campos com valores recomendados. Selecione **Próximo** e, em seguida, **Criar**. O perfil usará o nome `AmazonEKSAutoClusterRole` sugerido. + Se você criou recentemente um novo perfil, use o ícone de **Atualizar** para recarregar a lista suspensa de seleção de perfis. 1. Selecione o perfil do IAM do nó. Se esta for a primeira vez que você cria um cluster do Modo Automático do EKS, use a opção **Criar perfil recomendado**. + Opcionalmente, você pode reutilizar um único perfil do IAM do nó na conta da AWS para todos os clusters do Modo Automático do EKS. + O perfil do IAM do nó inclui as permissões necessárias para que os nós do Modo Automático se conectem ao cluster. O perfil do IAM do nó deve incluir permissões para recuperar imagens do ECR para os contêineres. + A opção **Criar perfil recomendado** preenche previamente todos os campos com valores recomendados. Selecione **Próximo** e, em seguida, **Criar**. O perfil usará o nome `AmazonEKSAutoNodeRole` sugerido. + Se você criou recentemente um novo perfil, use o ícone de **Atualizar** para recarregar a lista suspensa de seleção de perfis. 1. Selecione a VPC para o cluster do Modo Automático do EKS. Escolha **Criar VPC** para criar uma VPC para o EKS, ou escolha uma VPC que você criou anteriormente para o EKS. + Se você usar o console da VPC para criar uma VPC, a AWS sugere que você crie pelo menos um gateway NAT por zona de disponibilidade. Do contrário, você pode usar todos os outros padrões. + Para obter mais informações e detalhes sobre os requisitos do cluster IPv6, consulte [Criar uma Amazon VPC para o cluster do Amazon EKS](creating-a-vpc.md). 1. (opcional) O Modo Automático do EKS preenche automaticamente as sub-redes privadas da VPC selecionada. Você pode remover as sub-redes indesejadas. + O EKS seleciona automaticamente sub-redes privadas da VPC seguindo as práticas recomendadas. Opcionalmente, você pode selecionar sub-redes adicionais da VPC, como sub-redes públicas. 1. (opcional) Selecione **Visualizar padrões de configuração rápida** para analisar todos os valores de configuração do novo cluster. A tabela indica que alguns valores não são editáveis após a criação do cluster. 1. Selecione **Create cluster** (Criar cluster). Observe que a conclusão da criação do cluster pode levar quinze minutos. ## Próximas etapas + Saiba como [implantar uma workload de exemplo no cluster do Modo Automático do EKS](sample-storage-workload.md)