

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Ambientes de computação Amazon EKS
<a name="eks"></a>

[Começando a usar AWS Batch no Amazon EKS](getting-started-eks.md)fornece um pequeno guia para criar ambientes de computação EKS. Esta seção fornece mais detalhes sobre os ambientes de computação do Amazon EKS.

![\[AWS Batch workflow diagram showing integration with Amazon EKS, ECS, Fargate, and EC2.\]](http://docs.aws.amazon.com/pt_br/batch/latest/userguide/images/batch-on-eks.png)


AWS Batch simplifica suas cargas de trabalho em lotes nos clusters do Amazon EKS fornecendo recursos gerenciados em lotes. Isso inclui filas, rastreamento de dependências, tentativas e prioridades gerenciadas de tarefas, gerenciamento de pods e escalabilidade de nós. AWS Batch pode lidar com várias zonas de disponibilidade e vários tipos e tamanhos de instâncias do Amazon EC2. AWS Batch integra várias das melhores práticas do Amazon EC2 Spot para executar suas cargas de trabalho de forma tolerante a falhas, permitindo menos interrupções. Você pode usar o AWS Batch para executar um punhado de trabalhos noturnos ou milhões de trabalhos essenciais à missão com confiança.

![\[AWS Batch workflow on Amazon EKS, showing job queue, compute environment, and EC2 instances.\]](http://docs.aws.amazon.com/pt_br/batch/latest/userguide/images/batch-on-eks-detail.png)


AWS Batch é um serviço gerenciado que orquestra cargas de trabalho em lotes em seus Kubernetes clusters que são gerenciados pelo Amazon Elastic Kubernetes Service (Amazon EKS). AWS Batch conduz essa orquestração externamente aos seus clusters usando um modelo de “sobreposição”. Como AWS Batch é um serviço gerenciado, não há Kubernetes componentes (por exemplo, operadores ou recursos personalizados) para instalar ou gerenciar em seu cluster. AWS Batch só precisa que seu cluster seja configurado com controles de acesso baseados em funções (RBAC) que permitem AWS Batch a comunicação com o servidor da API. Kubernetes AWS Batch chamadas Kubernetes APIs para criar, monitorar e excluir Kubernetes pods e nós.

AWS Batch tem lógica de escalabilidade integrada para escalar Kubernetes nós com base na carga da fila de trabalhos com otimizações em termos de alocações de capacidade de trabalho. Quando a fila de trabalhos está vazia AWS Batch , reduz os nós até a capacidade mínima que você define, que por padrão é zero. AWS Batch gerencia todo o ciclo de vida desses nós e decora os nós com rótulos e manchas. Dessa forma, outras Kubernetes cargas de trabalho não são colocadas nos nós gerenciados pelo AWS Batch. A exceção a isso é`DaemonSets`, que pode direcionar AWS Batch os nós para fornecer monitoramento e outras funcionalidades necessárias para a execução adequada dos trabalhos. Além disso, AWS Batch não executa trabalhos, especificamente pods, em nós do seu cluster que ele não gerencia. Assim, você pode usar lógica e serviços de escalabilidade separadamente para outros aplicativos no cluster.

Para enviar trabalhos para AWS Batch, você interage diretamente com a AWS Batch API. AWS Batch traduz trabalhos em `podspecs` e, em seguida, cria as solicitações para colocar pods em nós gerenciados pelo seu AWS Batch cluster Amazon EKS. Você pode usar ferramentas como `kubectl` para visualizar pods e nós em execução. Quando um pod conclui sua execução, AWS Batch exclui o pod criado para manter uma carga menor no Kubernetes sistema.

Você pode começar conectando um cluster válido do Amazon EKS com AWS Batch o. Em seguida, anexe uma fila de AWS Batch trabalhos a ela e registre uma definição de trabalho do Amazon EKS usando atributos `podspec` equivalentes. Por fim, envie trabalhos usando a operação [SubmitJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html)da API que faz referência à definição do trabalho. Para obter mais informações, consulte [Começando a usar AWS Batch no Amazon EKS](getting-started-eks.md).

## Amazon EKS
<a name="compute-environments-eks"></a>

**Topics**
+ [Amazon EKS](#compute-environments-eks)
+ [AMI padrão do Amazon EKS](eks-ce-ami-selection.md)
+ [Ambientes AMI mistos](mixed-ami-environments.md)
+ [Versões do Kubernetes com suporte](supported_kubernetes_version.md)
+ [Atualizar a versão Kubernetes do ambiente de computação](updating-k8s-version-ce.md)
+ [Responsabilidade compartilhada dos nós Kubernetes](eks-ce-shared-responsibility.md)
+ [Execute um DaemonSet em nós AWS Batch gerenciados](daemonset-on-batch-eks-nodes.md)
+ [Personalize os modelos de lançamento do Amazon EKS](eks-launch-templates.md)
+ [Como fazer o upgrade do EKS AL2 para o EKS AL2023](eks-migration-2023.md)

# AMI padrão do Amazon EKS
<a name="eks-ce-ami-selection"></a>

Ao criar um ambiente computacional Amazon EKS, você não precisa especificar uma Amazon Machine Image (AMI). AWS Batch seleciona uma AMI otimizada para Amazon EKS com base na Kubernetes versão e nos tipos de instância especificados na sua [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html)solicitação. Em geral, recomendamos usar a seleção AMI do padrão. Para obter mais informações sobre o Amazon EKS otimizado AMIs, consulte [Amazon Linux otimizado para Amazon EKS AMIs](https://docs.aws.amazon.com/eks/latest/userguide/eks-optimized-ami.html) no *Guia do usuário do Amazon EKS*.

**Importante**  
O Amazon Linux 2023 AMIs é o padrão AWS Batch para o Amazon EKS.  
AWS encerrará o suporte para o Amazon EKS AL2 otimizado e AL2 acelerado a partir de 26/11/25 AMIs. Você pode continuar usando o Amazon Linux 2 otimizado para Amazon EKS AWS Batch fornecido AMIs em seus ambientes computacionais do Amazon EKS após a end-of-support data de 26/11/25. No entanto, esses ambientes computacionais não receberão mais novas atualizações de software, patches de segurança ou correções de bugs. AWS Para obter mais informações sobre a atualização de AL2 para AL2023, consulte [Como fazer o upgrade do EKS AL2 para o EKS AL2023](eks-migration-2023.md) o *Guia do AWS Batch usuário*.

Execute o comando a seguir para ver qual tipo de AMI AWS Batch foi selecionado para seu ambiente computacional Amazon EKS. O exemplo a seguir é um tipo de instância sem GPU.

```
# compute CE example: indicates Batch has chosen the AL2 x86 or ARM EKS 1.32 AMI, depending on instance types
    $ aws batch describe-compute-environments --compute-environments My-Eks-CE1 \
        | jq '.computeEnvironments[].computeResources.ec2Configuration'
    [
      {
        "imageType": "EKS_AL2",
        "imageKubernetesVersion": "1.32"
      }
    ]
```

O exemplo a seguir é um tipo de instância de GPU.

```
# GPU CE example: indicates Batch has choosen the AL2 x86 EKS Accelerated 1.32 AMI
    $ aws batch describe-compute-environments --compute-environments My-Eks-GPU-CE \
        | jq '.computeEnvironments[].computeResources.ec2Configuration'
    [
      {
        "imageType": "EKS_AL2_NVIDIA",
        "imageKubernetesVersion": "1.32"
      }
    ]
```

# Ambientes AMI mistos
<a name="mixed-ami-environments"></a>

Você pode usar substituições de modelos de lançamento para criar ambientes computacionais com o Amazon Linux 2 () AL2 e o Amazon Linux 2023 (). AL2023 AMIs Isso é útil para usar diferentes AMIs arquiteturas ou durante períodos de migração durante a transição de para. AL2 AL2023

**nota**  
AWS encerrará o suporte para o Amazon EKS AL2 otimizado e AL2 acelerado a partir de 26/11/25 AMIs. Embora você possa continuar usando o Amazon Linux 2 otimizado para Amazon EKS AWS Batch fornecido AMIs em seus ambientes computacionais do Amazon EKS após a end-of-support data de 26/11/25, esses ambientes computacionais não receberão mais novas atualizações de software, patches de segurança ou correções de bugs. AWS Ambientes mistos de AMI podem ser úteis durante o período de transição, permitindo que você migre gradualmente as cargas de trabalho e AL2023 mantenha a compatibilidade com as cargas de trabalho AL2 baseadas existentes.

Exemplo de configuração usando os dois tipos de AMI:

```
{
  "computeResources": {
    "launchTemplate": {
      "launchTemplateId": "TemplateId",
      "version": "1",
      "userdataType": "EKS_BOOTSTRAP_SH",
      "overrides": [
        {
          "instanceType": "c5.large",
          "imageId": "ami-al2-custom",
          "userdataType": "EKS_BOOTSTRAP_SH"
        },
        {
          "instanceType": "c6a.large",
          "imageId": "ami-al2023-custom",
          "userdataType": "EKS_NODEADM"
        }
      ]
    },
    "instanceTypes": ["c5.large", "c6a.large"]
  }
}
```

# Versões do Kubernetes com suporte
<a name="supported_kubernetes_version"></a>

AWS Batch no Amazon EKS atualmente oferece suporte às seguintes Kubernetes versões:
+ `1.34`
+ `1.33`
+ `1.32`
+ `1.31`
+ `1.30`
+ `1.29`

Talvez você veja uma mensagem de erro semelhante à seguinte ao usar a operação de `CreateComputeEnvironment` API ou a operação de `UpdateComputeEnvironment` API para criar ou atualizar um ambiente de computação. Esse problema ocorre se você especificar uma versão Kubernetes não suportada em `EC2Configuration`.

```
At least one imageKubernetesVersion in EC2Configuration is not supported.
```

Para resolver esse problema, exclua o ambiente de computação e recrie-o com uma versão Kubernetes compatível. 

Você pode realizar uma pequena atualização de versão no seu cluster Amazon EKS. Por exemplo, você pode atualizar o cluster de `1.xx` para, `1.yy` mesmo que a versão secundária não seja compatível. 

No entanto, o status do ambiente de computação pode mudar para `INVALID` depois de uma atualização de versão principal. Por exemplo, se você realizar uma atualização de versão principal de `1.xx` para `2.yy`. Se a versão principal não for compatível com AWS Batch, você verá uma mensagem de erro semelhante à seguinte.

```
reason=CLIENT_ERROR - ... EKS Cluster version [2.yy] is unsupported
```

# Atualizar a versão Kubernetes do ambiente de computação
<a name="updating-k8s-version-ce"></a>

Com AWS Batch, você pode atualizar a Kubernetes versão de um ambiente computacional para oferecer suporte às atualizações de cluster do Amazon EKS. A Kubernetes versão de um ambiente computacional é a versão do Amazon EKS AMI para os Kubernetes nós que são AWS Batch iniciados para executar trabalhos. Você pode realizar uma atualização de versão Kubernetes em seus nós do Amazon EKS antes ou depois de atualizar a versão do ambiente de gerenciamento do cluster do Amazon EKS. Recomendamos que você atualize os nós após atualizar o plano de controle. Para obter mais informações, consulte [Atualizando uma versão Kubernetes do cluster Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html) no *Guia do usuário do Amazon EKS*.

Para atualizar a versão Kubernetes de um ambiente de computação, use a operação API [https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html).

```
$ aws batch update-compute-environment \
    --compute-environment <compute-environment-name> \
    --compute-resources \
      'ec2Configuration=[{imageType=EKS_AL2,imageKubernetesVersion=1.32}]'
```

# Responsabilidade compartilhada dos nós Kubernetes
<a name="eks-ce-shared-responsibility"></a>

A manutenção dos ambientes de computação é uma responsabilidade compartilhada.
+ Não altere nem remova AWS Batch nós, rótulos, manchas, namespaces, modelos de lançamento ou grupos de escalonamento automático. Não adicione manchas aos nós AWS Batch gerenciados. Se você fizer alguma dessas alterações, seu ambiente de computação não poderá ser compatível e ocorrerão falhas, incluindo instâncias ociosas.
+ Não direcione seus pods para nós AWS Batch gerenciados. Se você direcionar seus pods para os nós gerenciados, ocorrerão falhas no escalonamento e filas de trabalhos paralisadas. Execute cargas de trabalho que não são usadas AWS Batch em nós autogerenciados ou grupos de nós gerenciados. Para obter mais informações, consulte [Grupos de nós gerenciados](https://docs.aws.amazon.com/eks/latest/userguide/managed-node-groups.html) no *Guia do usuário do Amazon EKS*.
+ Você pode DaemonSet direcionar um para ser executado em nós AWS Batch gerenciados. Para obter mais informações, consulte [Execute um DaemonSet em nós AWS Batch gerenciados](daemonset-on-batch-eks-nodes.md).

AWS Batch não atualiza automaticamente o ambiente AMIs computacional. É sua responsabilidade atualizá-las. Execute o comando a seguir para atualizá-lo AMIs para a versão mais recente da AMI.

```
$ aws batch update-compute-environment \
    --compute-environment <compute-environment-name> \
    --compute-resources 'updateToLatestImageVersion=true'
```

AWS Batch não atualiza automaticamente a Kubernetes versão. Execute o comando a seguir para atualizar a Kubernetes versão do ambiente do seu computador para *1.32* o.

```
$ aws batch update-compute-environment \
    --compute-environment <compute-environment-name> \
    --compute-resources \
      'ec2Configuration=[{imageType=EKS_AL2,imageKubernetesVersion=1.32}]'
```

Ao atualizar para uma AMI ou versão Kubernetes mais recente, você pode especificar se os trabalhos serão encerrados quando eles forem atualizados (`terminateJobsOnUpdate`) e quanto tempo esperar até que uma instância seja substituída se os trabalhos em execução não forem concluídos (`jobExecutionTimeoutMinutes`.) Para obter mais informações, consulte [Atualize um ambiente computacional no AWS Batch](updating-compute-environments.md) e a política de atualização de infraestrutura ([https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdatePolicy.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdatePolicy.html)) definida na operação da API [https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html).

# Execute um DaemonSet em nós AWS Batch gerenciados
<a name="daemonset-on-batch-eks-nodes"></a>

AWS Batch define manchas nos Kubernetes nós AWS Batch gerenciados. Você pode DaemonSet direcionar um para ser executado em nós AWS Batch gerenciados com o seguinte`tolerations`.

```
tolerations:
  - key: "batch.amazonaws.com/batch-node"
    operator: "Exists"
```

Outra maneira de fazer isso é com o `tolerations` a seguir.

```
tolerations:
  - key: "batch.amazonaws.com/batch-node"
    operator: "Exists"
    effect: "NoSchedule"
  - key: "batch.amazonaws.com/batch-node"
    operator: "Exists"
    effect: "NoExecute"
```

# Personalize os modelos de lançamento do Amazon EKS
<a name="eks-launch-templates"></a>

AWS Batch no Amazon EKS oferece suporte a modelos de lançamento. Há restrições sobre o que seu modelo de lançamento pode fazer.

**Importante**  
Para EKS AL2 AMIs, AWS Batch funciona`/etc/eks/bootstrap.sh`. Não execute `/etc/eks/bootstrap.sh` em seu modelo de lançamento ou scripts cloud-init user-data. Você pode adicionar outros parâmetros além do parâmetro `--kubelet-extra-args` ao [bootstrap.sh](https://github.com/awslabs/amazon-eks-ami/blob/main/templates/al2/runtime/bootstrap.sh). Para fazer isso, defina a variável `AWS_BATCH_KUBELET_EXTRA_ARGS` no arquivo `/etc/aws-batch/batch.config`. Consulte o código a seguir para ver um exemplo.
Para o EKS AL2023, AWS Batch utiliza o [NodeConfigSpec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec)do EKS para fazer com que as instâncias se juntem ao cluster EKS. AWS Batch é [ClusterDetails](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#clusterdetails)preenchido [NodeConfigSpec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec)para o cluster EKS e você não precisa especificá-los.

**nota**  
Recomendamos que você não defina nenhuma das [https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec)configurações a seguir no modelo de lançamento, pois AWS Batch substituirá seus valores. Para obter mais informações, consulte [Responsabilidade compartilhada dos nós Kubernetes](eks-ce-shared-responsibility.md).  
`Taints`
`Cluster Name`
`apiServerEndpoint`
`certificatAuthority`
`CIDR`
Não crie rótulos com o prefixo `batch.amazonaws.com/`

**nota**  
Se o modelo de lançamento for alterado após [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html)ser chamado, [https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html)deverá ser chamado para avaliar a versão do modelo de lançamento para substituição.

**Topics**
+ [Adicionar argumentos extras de `kubelet`](#kubelet-extra-args)
+ [Configurar o runtime do contêiner](#change-container-runtime)
+ [Montar um volume do Amazon EFS](#mounting-efs-volume)
+ [IPv6 apoio](#eks-ipv6-support)

## Adicionar argumentos extras de `kubelet`
<a name="kubelet-extra-args"></a>

AWS Batch suporta a adição de argumentos extras ao `kubelet` comando. Para obter a lista completa de parâmetros compatíveis, consulte [https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/) na *documentação Kubernetes*. No exemplo a seguir para EKS AL2 AMIs, `--node-labels mylabel=helloworld` é adicionado à linha de `kubelet` comando.

```
MIME-Version: 1.0
      Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

      --==MYBOUNDARY==
      Content-Type: text/x-shellscript; charset="us-ascii"

      #!/bin/bash
      mkdir -p /etc/aws-batch

      echo AWS_BATCH_KUBELET_EXTRA_ARGS=\"--node-labels mylabel=helloworld\" >> /etc/aws-batch/batch.config

      --==MYBOUNDARY==--
```

Para EKS AL2023 AMIs , o formato do arquivo é YAML. Para obter a lista completa de parâmetros compatíveis, consulte [https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec) na *documentação Kubernetes*. No exemplo a seguir para EKS AL2023 AMIs, `--node-labels mylabel=helloworld` é adicionado à linha de `kubelet` comando.

```
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: application/node.eks.aws

apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
  kubelet:
    flags:
    - --node-labels=mylabel=helloworld

--==MYBOUNDARY==--
```

## Configurar o runtime do contêiner
<a name="change-container-runtime"></a>

Você pode usar a variável de AWS Batch `CONTAINER_RUNTIME` ambiente para configurar o tempo de execução do contêiner em um nó gerenciado. O exemplo a seguir define o runtime do contêiner para `containerd` quando `bootstrap.sh` for executado. Para obter mais informações, consulte [https://kubernetes.io/docs/setup/production-environment/container-runtimes/#containerd](https://kubernetes.io/docs/setup/production-environment/container-runtimes/#containerd) *na documentação Kubernetes*. 

Se você estiver usando uma AMI otimizada `EKS_AL2023` ou `EKS_AL2023_NVIDIA`, não precisará especificar o runtime do contêiner, pois somente **containerd** é compatível.

**nota**  
A variável de ambiente `CONTAINER_RUNTIME` é equivalente à opção `--container-runtime` de `bootstrap.sh`. Para obter mais informações, consulte [https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/#options](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/#options) *na documentação Kubernetes*.

```
MIME-Version: 1.0
      Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

      --==MYBOUNDARY==
      Content-Type: text/x-shellscript; charset="us-ascii"

      #!/bin/bash
      mkdir -p /etc/aws-batch

      echo CONTAINER_RUNTIME=containerd >> /etc/aws-batch/batch.config

      --==MYBOUNDARY==--
```

## Montar um volume do Amazon EFS
<a name="mounting-efs-volume"></a>

Você pode usar modelos de execução para montar volumes no nó. No exemplo a seguir, as configurações `cloud-config` `packages` e `runcmd` são usadas. Para obter mais informações, consulte [Exemplos de configuração de Nuvem](https://cloudinit.readthedocs.io/en/latest/topics/examples.html) na *documentação cloud-init*.

```
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/cloud-config; charset="us-ascii"

packages:
- amazon-efs-utils

runcmd:
- file_system_id_01=fs-abcdef123
- efs_directory=/mnt/efs

- mkdir -p ${efs_directory}
- echo "${file_system_id_01}:/ ${efs_directory} efs _netdev,noresvport,tls,iam 0 0" >> /etc/fstab
- mount -t efs -o tls ${file_system_id_01}:/ ${efs_directory}

--==MYBOUNDARY==--
```

Para usar esse volume na tarefa, ele deve ser adicionado ao parâmetro [EksProperties](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksProperties.html) a. [RegisterJobDefinition](https://docs.aws.amazon.com/batch/latest/APIReference/API_RegisterJobDefinition.html) O exemplo a seguir é uma grande parte da definição do trabalho.

```
{
    "jobDefinitionName": "MyJobOnEks_EFS",
    "type": "container",
    "eksProperties": {
        "podProperties": {
            "containers": [
                {
                    "image": "public.ecr.aws/amazonlinux/amazonlinux:2",
                    "command": ["ls", "-la", "/efs"],
                    "resources": {
                        "limits": {
                            "cpu": "1",
                            "memory": "1024Mi"
                        }
                    },
                    "volumeMounts": [
                        {
                            "name": "efs-volume",
                            "mountPath": "/efs"
                        }
                    ]
                }
            ],
            "volumes": [
                {
                    "name": "efs-volume",
                    "hostPath": {
                        "path": "/mnt/efs"
                    }
                }
            ]
        }
    }
}
```

No nó, o volume do Amazon EFS é montado no diretório `/mnt/efs`. No contêiner do trabalho do Amazon EKS, o volume é montado no diretório `/efs`.

## IPv6 apoio
<a name="eks-ipv6-support"></a>

AWS Batch é compatível com clusters Amazon EKS que têm IPv6 endereços. Nenhuma personalização é necessária para AWS Batch suporte. No entanto, antes de começar, recomendamos que você analise as considerações e condições descritas em [Atribuição de IPv6 endereços a pods e serviços no](https://docs.aws.amazon.com/eks/latest/userguide/cni-ipv6.html) Guia do usuário do *Amazon* EKS.

# Como fazer o upgrade do EKS AL2 para o EKS AL2023
<a name="eks-migration-2023"></a>

Os Amazon EKS otimizados AMIs estão disponíveis em duas famílias com base no Amazon Linux 2 (AL2) e no Amazon Linux 2023 (AL2023). AL2023 é um sistema operacional baseado em Linux projetado para fornecer um ambiente seguro, estável e de alto desempenho para seus aplicativos em nuvem. Para obter mais informações sobre as diferenças entre AL2 e AL2023 consulte [Atualização do Amazon Linux 2 para o Amazon Linux 2023](https://docs.aws.amazon.com/eks/latest/userguide/al2023.html) no *Guia do usuário do Amazon EKS*.

**Importante**  
AWS encerrará o suporte para o Amazon EKS AL2 otimizado e AL2 acelerado a partir de 26/11/25 AMIs. Recomendamos migrar os ambientes computacionais do AWS Batch Amazon EKS para o Amazon Linux 2023 antes de 26/11/25 para manter o desempenho e a segurança ideais. Embora você possa continuar usando o Amazon Linux 2 otimizado para Amazon EKS AWS Batch fornecido AMIs em seus ambientes computacionais do Amazon EKS após a end-of-support data de 26/11/25, esses ambientes computacionais não receberão mais novas atualizações de software, patches de segurança ou correções de bugs. AWS Posteriormente end-of-life, é sua [responsabilidade manter](eks-ce-shared-responsibility.md#eks-ce-shared-responsibility.title) esses ambientes computacionais na AMI Amazon Linux 2 otimizada para Amazon EKS.

Dependendo de como seu ambiente computacional está configurado, você pode usar um dos seguintes caminhos de atualização de AL2 para AL2023.

**Atualize usando o Ec2Configuration. ImageType**
+ [Se você não estiver usando um modelo de execução ou substituições de modelo de execução, altere Ec2Configuration. ImageType](https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html#Batch-Type-Ec2Configuration-imageType)para `EKS_AL2023` ou `EKS_AL2023_NVIDIA` e depois execute [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html). 
+ Se você especificar uma configuração [Ec2. ImageIdOverride](https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html#Batch-Type-Ec2Configuration-imageIdOverride)depois [Ec2Configuration. ImageType](https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html#Batch-Type-Ec2Configuration-imageType)deve corresponder ao tipo de AMI especificado em [Ec2Configuration. ImageIdOverride](https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html#Batch-Type-Ec2Configuration-imageIdOverride). 

  Se você não corresponder `ImageIdOverride` e `ImageType`, o nó não se juntará ao cluster. 

**Atualizar usando modelos de execução**
+ Se você tiver argumentos `kubelet` extras definidos em um modelo de execução ou substituição de modelo de execução, eles precisarão ser atualizados para o novo [formato de argumentos `kubelet` extras](eks-launch-templates.md#kubelet-extra-args.title).

  Se você não corresponder ao formato dos argumentos extras `kubelet`, os argumentos extras não serão aplicados.
+ Pois AL2023 AMIs, **containerd** é o único ambiente de execução de contêiner compatível. Você não precisa especificar um runtime de contêiner para `EKS_AL2023` no modelo de execução.

  Você não pode especificar um tempo de execução de contêiner personalizado com`EKS_AL2023`.
+ Se você usar um modelo de execução ou uma substituição de modelo de execução que especifique uma AMI com base em `EKS_AL2023`, você precisará definir [userDataType](https://docs.aws.amazon.com/batch/latest/APIReference/API_LaunchTemplateSpecification.html) como `EKS_NODEADM`. 

  Se você não corresponder `userdataType` e AMI, o nó não se juntará ao cluster EKS.