Comece a usar o AWS Fargate em seu cluster - Amazon EKS
Etapa 1: verificar se os nós existentes podem se comunicar com os Pods do FargateEtapa 2: criar um perfil de execução de Pod do FargateEtapa 3: criar um perfil do Fargate para o clusterEtapa 4: atualizar o CoreDNSPróximas etapas

Comece a usar o AWS Fargate em seu cluster

Importante

O AWS Fargate com Amazon EKS não está disponível nas regiões AWS GovCloud (EUA-Leste) e AWS GovCloud (EUA-Oeste).

Este tópico descreve como começar a executar o Pods no AWS Fargate com seu cluster do Amazon EKS.

Se você restringir o acesso ao endpoint público do cluster usando blocos CIDR, é recomendável também habilitar o acesso ao endpoint privado. Dessa forma, os Pods do Fargate podem se comunicar com o cluster. Sem o endpoint privado ativado, os blocos CIDR especificados para acesso público devem incluir as origens de saída da VPC. Para ter mais informações, consulte Controlar o acesso à rede ao endpoint do servidor de API do cluster.

Pré-requisito

Um cluster existente. Se você ainda não tem um cluster do Amazon EKS, consulte Começar a usar o Amazon EKS.

Etapa 1: verificar se os nós existentes podem se comunicar com os Pods do Fargate

Se estiver trabalhando com um novo cluster sem nós ou um cluster com apenas grupos de nós gerenciados (consulte Simplificar o ciclo de vida dos nós com grupos de nós gerenciados), pule para Etapa 2: criar um perfil de execução de Pod do Fargate.

Pressuponha que você esteja trabalhando com um cluster existente que já tenha nós associados a ele. Verifique se os Pods nesses nós podem se comunicar livremente com os Pods que estão em execução no Fargate. Os Pods que estão em execução no Fargate são automaticamente configurados para usar o grupo de segurança do cluster ao qual estão associados. Certifique-se de que todos os nós existentes em seu cluster possam enviar e receber tráfego de e para o grupo de segurança do cluster. Os grupos de nós gerenciados são configurados automaticamente para usar também o grupo de segurança do cluster, portanto, não é necessário modificá-los ou verificá-los quanto a essa compatibilidade (consulte Simplificar o ciclo de vida dos nós com grupos de nós gerenciados).

Para grupos de nós existentes que foram criados com eksctl ou com os modelos AWS CloudFormation gerenciados pelo Amazon EKS, você pode adicionar manualmente o grupo de segurança do cluster aos nós. Ou então, pode modificar o modelo de lançamento do grupo do Auto Scaling para o grupo de nós para anexar o grupo de segurança do cluster às instâncias. Para obter mais informações, consulte Alterar os grupos de segurança de uma instância no Guia do usuário da Amazon VPC.

Você pode conferir se há um grupo de segurança para o seu cluster no AWS Management Console, na seção Networking (Rede). Ou você pode fazer isso usando o seguinte comando da CLI AWS. Quando usar esse comando, substitua my-cluster pelo nome de seu cluster.

aws eks describe-cluster --name my-cluster --query cluster.resourcesVpcConfig.clusterSecurityGroupId

Etapa 2: criar um perfil de execução de Pod do Fargate

Quando seu cluster cria Pods em AWS Fargate, os componentes executados na infraestrutura Fargate devem fazer chamadas para as APIs AWS em seu nome. A função de execução de Pod do Amazon EKS fornece as permissões do IAM para isso. Para criar um perfil de execução do AWS Fargate Pod, consulte Perfil do IAM para execução de Pod do Amazon EKS.

nota

Se você criou o cluster com o eksctl usando a opção --fargate, o cluster já tem uma função de execução de Pod que é possível encontrar no console do IAM com o padrão eksctl-my-cluster-FargatePodExecutionRole-ABCDEFGHIJKL. Da mesma forma, se você usar o eksctl para criar os perfis do Fargate, o eksctl criará a função de execução de Pod, caso ela ainda não tenha sido criada.

Etapa 3: criar um perfil do Fargate para o cluster

Antes de agendar os Pods em execução no Fargate no cluster, é necessário definir um perfil do Fargate que especifique quais Pods deverão usá-lo quando forem executados. Para ter mais informações, consulte Defina quais Pods usam o AWS Fargate quando iniciado.

nota

Se você criou o cluster com o eksctl usando a opção --fargate, um perfil do Fargate já foi criado para o cluster com seletores para todos os Pods nos namespaces kube-system e default. Use o procedimento a seguir para criar perfis do Fargate para qualquer outro namespace que você deseja usar com o Fargate.

Você pode criar um perfil do Fargate usando qualquer uma dessas ferramentas:

eksctl

Este procedimento exige a versão eksctl 0.194.0 ou superior. Você pode verificar a versão com o seguinte comando:

eksctl version

Para obter instruções sobre como instalar ou atualizar o eksctl, consulte Instalação na documentação do eksctl.

Para criar um perfil do Fargate com o eksctl

Crie seu perfil Fargate com o seguinte comando eksctl, substituindo cada valor de exemplo por seus próprios valores. Você precisa especificar um namespace. Mas, a opção --labels não é exigida.

eksctl create fargateprofile \
    --cluster my-cluster \
    --name my-fargate-profile \
    --namespace my-kubernetes-namespace \
    --labels key=value

É possível usar certos curingas para os rótulos my-kubernetes-namespace e key=value. Para ter mais informações, consulte Curingas do perfil do Fargate.

AWS Management Console

Para criar um perfil do Fargate com o AWS Management Console

  1. Abra o console do Amazon EKS.

  2. Escolha o cluster para o qual deve ser criado um perfil do Fargate.

  3. Escolha a guia Compute (Computação).

  4. Em Fargate profile (Perfil do Fargate), escolha Add Fargate profile (Adicionar perfil do Fargate).

  5. Na página Configure Fargate profile (Configurar o perfil do Fargate), faça o seguinte:

    1. Em Name (Nome), insira um nome para o perfil do Fargate. O nome deve ser exclusivo.

    2. Em Pod execution role (Função de execução de pod), escolha a função de execução de Pod que deve ser usada com o perfil do Fargate. Somente funções do IAM com o principal de serviço do eks-fargate-pods.amazonaws.com são mostradas. Se nenhuma função estiver listada, você deve criar uma. Para ter mais informações, consulte Perfil do IAM para execução de Pod do Amazon EKS.

    3. Modifique as sub-redes selecionadas conforme necessário.

      nota

      Somente sub-redes privadas são compatíeis com Pods em execução no Fargate.

    4. Em Tags (Etiquetas), você tem a opção de etiquetar o perfil do Fargate. Essas tags não são propagadas para outros recursos associados ao perfil, como Pods.

    5. Escolha Próximo.

  6. Na página Configure Pod selection (Configurar a seleção de ), faça o seguinte:

    1. Em Namespace, insira um namespace para fazer a correspondência com Pods.

      • É possível usar namespaces específicos para a correspondência, como kube-system ou default.

      • É possível usar certos curingas (por exemplo, prod-*) para fazer a correspondência com vários namespaces (por exemplo, prod-deployment e prod-test). Para ter mais informações, consulte Curingas do perfil do Fargate.

    2. (Opcional) Adicione rótulos Kubernetes ao seletor. Adicione-os especificamente ao seletor ao qual os Pods no namespace especificado precisam corresponder.

      • É possível adicionar o rótulo infrastructure: fargate ao seletor para que somente Pods no namespace especificado que também tenham o rótulo Kubernetes do infrastructure: fargate correspondam ao seletor.

      • É possível usar certos curingas (por exemplo, key?: value?) para fazer a correspondência com vários namespaces (por exemplo, keya: valuea e keyb: valueb). Para ter mais informações, consulte Curingas do perfil do Fargate.

    3. Escolha Próximo.

  7. Na página Review and create (Revisar e criar), revise as informações do perfil do Fargate e selecione Create (Criar).

Etapa 4: atualizar o CoreDNS

Por padrão, o CoreDNS é configurado para ser executado na infraestrutura do Amazon EC2 nos clusters do Amazon EKS. Se você só quiser executar os Pods no Fargate no cluster, conclua as etapas a seguir.

nota

Se você criou o cluster com o eksctl usando a opção --fargate, poderá avançar para Próximas etapas.

  1. Crie um perfil do Fargate para o CoreDNS com o comando a seguir. Substitua my-cluster pelo nome do cluster, 111122223333 pelo ID da conta, AmazonEKSFargatePodExecutionRole pelo nome do perfil de execução Pod e 0000000000000001, 0000000000000002 e 0000000000000003 pelos IDs das sub-redes privadas. Se você não tiver um perfil de execução do Pod, deverá criar um primeiro (consulte Etapa 2: criar um perfil de execução de Pod do Fargate).

    Importante

    O ARN da função não pode incluir um caminho diferente de /. Por exemplo, se o nome da sua função for development/apps/my-role, você precisará alterá-lo para my-role ao especificar o ARN da função. O formato do ARN da função deve ser arn:aws:iam::111122223333:role/role-name.

    aws eks create-fargate-profile \
    --fargate-profile-name coredns \
    --cluster-name my-cluster \
    --pod-execution-role-arn arn:aws:iam::111122223333:role/AmazonEKSFargatePodExecutionRole \
    --selectors namespace=kube-system,labels={k8s-app=kube-dns} \
    --subnets subnet-0000000000000001 subnet-0000000000000002 subnet-0000000000000003

  2. Execute e o comando a seguir para remover a anotação padrão eks.amazonaws.com/compute-type : ec2 dos Pods do CoreDNS.

    kubectl patch deployment coredns \
    -n kube-system \
    --type json \
    -p='[{"op": "remove", "path": "/spec/template/metadata/annotations/eks.amazonaws.com~1compute-type"}]'

Próximas etapas

  • É possível começar a migrar as aplicações existentes para serem executadas no Fargate com o fluxo de trabalho a seguir.

    1. Criar um perfil do Fargate que corresponda ao namespace Kubernetes e aos rótulos Kubernetes da sua aplicação.

    2. Exclua e recrie os Pods existentes para que eles sejam agendados no Fargate. Por exemplo, o comando a seguir aciona uma implantação de coredns. É possível modificar o namespace e o tipo de implantação para atualizar os Pods específicos.

      kubectl rollout restart -n kube-system deployment coredns

  • Implante o Roteamento de aplicações e tráfego HTTP com Application Load Balancers para permitir objetos de Ingresso para os Pods em execução no Fargate.

  • É possível usar Ajuste os recursos do pod com o Vertical Pod Autoscaler para definir o tamanho correto da CPU e da memória para os Pods do Fargate e, em seguida, usar Escalar implantações de pods com o Horizontal Pod Autoscaler para dimensionar a escala desses Pods. Se quiser que o Vertical Pod Autoscaler reimplante automaticamente os Pods no Fargate com combinações maiores de CPU e memória, defina o modo do Vertical Pod Autoscaler como Auto ou Recreate. Isso ocorre para garantir a funcionalidade correta. Para obter mais informações, consulte a documentação do Vertical Pod Autoscaler no GitHub.

  • Você pode configurar o coletor AWS Distro for OpenTelemetry (ADOT) para monitoramento de aplicações seguindo estas instruções.