**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.
# Criar uma AMI personalizada do Windows com o Image Builder
É possível usar o Image Builder do EC2 para criar AMIs personalizadas do Windows otimizadas para o Amazon EKS com uma das seguintes opções:
+ [Usando uma AMI do Windows otimizada para o Amazon EKS como base](#custom-windows-ami-as-base)
+ [Usar o componente de compilação gerenciado pela Amazon](#custom-windows-ami-build-component)
Com ambos os métodos, é necessário criar sua própria fórmula do Image Builder. Para obter mais informações, consulte [Criar uma nova versão de uma fórmula de imagem](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html), no Guia do usuário do Image Builder.
**Importante**
Os seguintes componentes **gerenciados pela Amazon** para o `eks` incluem patches para o `CVE-2024-5321`.
`1.28.2` e superior
`1.29.2` e superior
`1.30.1` e superior
Todas as versões para Kubernetes 1.31 e superiores
## Usando uma AMI do Windows otimizada para o Amazon EKS como base
Essa opção é a maneira recomendada para criar AMIs personalizadas do Windows. As AMIs do Windows otimizadas para o Amazon EKS que fornecemos são atualizadas com mais frequência do que o componente de compilação gerenciado pela Amazon.
1. Inicie uma fórmula do Image Builder.
1. Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder.
1. No painel de navegação esquerdo, escolha **Image recipes** (Fórmulas de imagens).
1. Escolha **Create image recipe** (Criar fórmula de imagem).
1. Na seção **Detalhes da fórmula**, insira um **Nome** e uma **Versão**.
1. Especifique o ID da AMI do Windows otimizada para o Amazon EKS na seção **Imagem base**.
1. Escolha **Inserir ID de AMI personalizada**.
1. Recupere o ID da AMI da versão do sistema operacional do Windows necessária. Para obter mais informações, consulte [Recuperar IDs de AMI do Microsoft Windows recomendadas](retrieve-windows-ami-id.md).
1. Em **AMI ID**, insira o ID da AMI personalizado. Se o ID da AMI não for encontrada, certifique-se de que a região AWS do ID da AMI corresponda à região AWS mostrada no canto superior direito do console.
1. (Opcional) Para obter as atualizações de segurança mais recentes, adicione o componente `update-windows` na seção **Componentes de compilação**.
1. Na lista suspensa à direita da caixa de pesquisa **Find components by name** (Localizar componentes por nome), escolha **Amazon-managed** (Gerenciado pela Amazon).
1. Na caixa **Find components by name** (Localizar componentes por nome), insira `update-windows`.
1. Marque a caixa de seleção do resultado da pesquisa de **`update-windows`**. Esse componente inclui os patches mais recentes do Windows para o sistema operacional.
1. Conclua as entradas restantes da fórmula de imagem com as configurações necessárias. Para obter mais informações, consulte [Criar uma nova versão de fórmula de imagem (console)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html#create-image-recipe-version-console), no Guia do usuário do Image Builder.
1. Escolha **Create recipe** (Criar fórmula).
1. Use a nova fórmula de imagem em um pipeline de imagens novo ou existente. Quando o pipeline de imagens for executado com êxito, a AMI personalizada será listada como imagem de saída e estará pronta para uso. Para obter mais informações, consulte [Criar um pipeline de imagem usando o assistente do console do EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html).
## Usar o componente de compilação gerenciado pela Amazon
Quando o uso de uma AMI do Windows otimizada para o Amazon EKS como base não for viável, será possível usar o componente de compilação gerenciado pela Amazon. Essa opção pode estar defasada em relação às versões mais recentes compatíveis do Kubernetes.
1. Inicie uma fórmula do Image Builder.
1. Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder.
1. No painel de navegação esquerdo, escolha **Image recipes** (Fórmulas de imagens).
1. Escolha **Create image recipe** (Criar fórmula de imagem).
1. Na seção **Recipe details** (Detalhes da fórmula), insira um **nome** e uma **versão**.
1. Determine qual opção usar para criar sua AMI personalizada na seção **Base image** (Imagem base):
+ **Select managed images** (Selecionar imagens gerenciadas): escolha **Windows** em **Image Operating System (OS)** (Sistema operacional da imagem). Em seguida, escolha uma das seguintes opções para **Origem da imagem**.
+ **Início rápido (gerenciado pela Amazon)**: na lista suspensa **Nome da imagem**, escolha uma versão do Windows Server compatível com o Amazon EKS. Para obter mais informações, consulte [Criar nós com AMIs otimizadas do Windows](eks-optimized-windows-ami.md).
+ **Images owned by me** (Imagens que pertencem a mim): para **Nome da imagem**, escolha o ARN da sua própria imagem com sua própria licença. A imagem que você fornece ainda não pode ter componentes do Amazon EKS instalados.
+ **Inserir ID da AMI personalizado**: para o ID da AMI, insira o ID da AMI com sua própria licença. A imagem que você fornece ainda não pode ter componentes do Amazon EKS instalados.
1. Na seção **Componentes de compilação - Windows**, faça o seguinte:
1. Na lista suspensa à direita da caixa de pesquisa **Find components by name** (Localizar componentes por nome), escolha **Amazon-managed** (Gerenciado pela Amazon).
1. Na caixa **Find components by name** (Localizar componentes por nome), insira `eks`.
1. Marque a caixa de seleção do resultado da pesquisa de **`eks-optimized-ami-windows`**, mesmo que o resultado retornado não seja a versão desejada.
1. Na caixa **Find components by name** (Localizar componentes por nome), insira `update-windows`.
1. Marque a caixa de seleção do resultado da pesquisa de **update-windows**. Esse componente inclui os patches mais recentes do Windows para o sistema operacional.
1. Na seção **Componentes selecionados**, faça o seguinte:
1. Selecionar **Opções de versionamento** para ** `eks-optimized-ami-windows` **.
1. Escolha **Especificar versão do componente**.
1. No campo **Versão do componente**, insira *versão.x*, substituindo *versão* por uma versão compatível do Kubernetes. A inserção de um *x* em parte do número da versão indica o uso da versão mais recente do componente que também se alinha com a parte da versão que você define explicitamente. Preste atenção na saída do console, pois ela informará se a versão desejada está disponível como componente gerenciado. Lembre-se de que as versões do Kubernetes mais recentes podem não estar disponíveis para o componente de compilação. Para obter mais informações sobre as versões disponíveis, consulte [Recuperar informações sobre versões de componentes `eks-optimized-ami-windows`](#custom-windows-ami-component-versions).
1. Conclua as entradas restantes da fórmula de imagem com as configurações necessárias. Para obter mais informações, consulte [Criar uma nova versão de fórmula de imagem (console)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html#create-image-recipe-version-console), no Guia do usuário do Image Builder.
1. Escolha **Create recipe** (Criar fórmula).
1. Use a nova fórmula de imagem em um pipeline de imagens novo ou existente. Quando o pipeline de imagens for executado com êxito, a AMI personalizada será listada como imagem de saída e estará pronta para uso. Para obter mais informações, consulte [Criar um pipeline de imagem usando o assistente do console do EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html).
## Recuperar informações sobre versões de componentes `eks-optimized-ami-windows`
É possível recuperar informações específicas sobre o que está instalado com cada componente. Por exemplo, você pode verificar qual versão do `kubelet` está instalada. Os componentes passam por testes funcionais nas versões dos sistemas operacionais do Windows compatíveis com o Amazon EKS. Para obter mais informações, consulte [Calendário de lançamento](eks-optimized-windows-ami.md#windows-ami-release-calendar). Quaisquer outras versões do sistema operacional do Windows listadas como não compatíveis ou que tenham chegado ao fim do suporte podem não ser compatíveis com o componente.
1. Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder.
1. No painel de navegação à esquerda, escolha **Components** (Componentes).
1. Na lista suspensa à direita da caixa de pesquisa **Find components by name** (Localizar componentes por nome), altere **Owned by me** (Pertencem a mim) para **Quick start (Amazon-managed)** (Início rápido, gerenciado pela Amazon).
1. Na caixa **Localizar componentes por nome**, insira `eks`.
1. (Opcional) Se estiver usando uma versão recente, classifique a coluna **Version** (Versão) em ordem decrescente, escolhendo-a duas vezes.
1. Escolha o link **`eks-optimized-ami-windows`** com a versão desejada.
As informações em **Description** (Descrição) na página resultante mostra as informações específicas.