

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á.

# Gerenciar versões da AMI em ambientes computacionais
<a name="managing-ami-versions"></a>

AWS Batch fornece visibilidade das imagens de máquina da Amazon (AMIs) que seus ambientes de computação usam.

## Visualizando o status da AMI
<a name="viewing-ami-status"></a>

Você pode visualizar o status das AMIs usadas em seus ambientes de computação por meio do AWS Batch console ou usando o comando [https://docs.aws.amazon.com/cli/latest/reference/batch/describe-compute-environments.html](https://docs.aws.amazon.com/cli/latest/reference/batch/describe-compute-environments.html) describe-compute-environments.

------
#### [ Console ]

No AWS Batch console, as informações de status da AMI aparecem em dois locais com os seguintes valores de status:
+ **Mais recente ** — Usando a AMI mais recente suportada pelo AWS Batch.
+ **Atualização disponível ** — Uma atualização está disponível.

**nota**  
As informações de status da AMI aparecem somente para AWS Batch AMIs gerenciadas. O status não aparece quando as imagens são especificadas em `imageId` (obsoletas) ou no `imageIdOverride` modelo de lançamento padrão. O status não aparece quando o ambiente computacional tem um modelo de execução substituído. Para obter mais informações sobre a seleção de AMI, consulte[Ordem de seleção da AMI](ami-selection-order.md).

A página de ambientes de computação exibe uma ** coluna de status da imagem ** em lote que mostra o geral `batchImageStatus` de cada ambiente de computação. Se um ambiente computacional tiver várias AMIs e qualquer AMI tiver a ** Atualização disponível**, o console mostrará a ** Atualização disponível ** para todo o ambiente computacional.

**nota**  
O status aparece depois que o ambiente computacional começa a ser dimensionado para qualquer tipo de ** imagem. **

Na página de detalhes do ambiente de computação, a ** seção de configuração do ** Ec2 da ** guia Recursos de ** computação mostra o status da imagem ** em lote ** para cada tipo de ** imagem ** no ambiente computacional. Se um tipo de ** imagem ** tiver várias AMIs e qualquer AMI tiver ** Atualização disponível**, o console mostrará ** Atualização disponível ** para esse tipo de ** ** imagem.

**nota**  
O status aparece para cada tipo de ** imagem ** somente depois que o ambiente computacional começa a escalar instâncias para esse tipo de ** imagem específico. **

------
#### [ CLI ]

Quando você chama [ describe-compute-environments](https://docs.aws.amazon.com/cli/latest/reference/batch/describe-compute-environments.html), a resposta inclui o `batchImageStatus` campo que fornece visibilidade da AMI com os seguintes valores:
+ `LATEST`— Usando a AMI mais recente suportada pelo AWS Batch.
+ `UPDATE_AVAILABLE`— Uma atualização está disponível.

**nota**  
O `batchImageStatus` campo aparece somente para AWS Batch AMIs gerenciadas. Ela não aparece quando as AMIs personalizadas são especificadas em `imageId` (descontinuadas) ou no modelo `imageIdOverride` de execução padrão. O status não aparece quando o ambiente computacional tem um modelo de execução substituído. Para obter mais informações sobre como AWS Batch seleciona AMIs, consulte. [Ordem de seleção da AMI](ami-selection-order.md)  
O campo aparece de forma independente para cada um `Ec2Configuration` e somente depois que o ambiente computacional começar a escalar instâncias usando esse campo. `imageType`

```
{
    "computeEnvironments": [
        {
            "computeEnvironmentName": "my-compute-environment",
            "computeResources": {
                "ec2Configuration": [
                    {
                        "imageType": "ECS_AL2023"
                    },
                    {
                        "imageType": "ECS_AL2023_NVIDIA",
                        "batchImageStatus": "UPDATE_AVAILABLE"
                    }
                ]
            }
        }
    ]
}
```

------

## Atualizando versões da AMI
<a name="updating-ami-versions"></a>

Quando AWS Batch indica que uma atualização da AMI está disponível, você pode atualizar seu ambiente de computação para usar as AMIs mais novas atualizando o ambiente computacional com ** a opção Atualizar AMI para a versão ** mais recente definida como true.

Você não precisa especificar novos IDs de AMI — seleciona AWS Batch automaticamente as AMIs compatíveis mais recentes ao definir ** Atualizar AMI para a versão mais recente. **

**Importante**  
A atualização das AMIs aciona uma atualização de [ infraestrutura](infrastructure-updates.md), não uma atualização de escalabilidade. Isso significa AWS Batch substituir as instâncias existentes por novas instâncias que usam a AMI atualizada. O processo de atualização leva mais tempo do que uma atualização de escalabilidade e pode interromper trabalhos em execução, dependendo da configuração da política de atualização.

**Importante**  
Se sua estratégia de alocação `BEST_FIT` for, você precisará realizar uma [ blue/green atualização](blue-green-updates.md).

------
#### [ Console ]

Para atualizar AMIs usando o AWS Batch console:

1. Abra o AWS Batch console em [ https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. No painel de navegação, escolha **Ambientes**.

1. Selecione a opção ao lado do ambiente computacional que mostra o status da AMI com uma atualização. Você deve selecionar um ambiente computacional antes que as opções do ** menu ** Ações estejam disponíveis.

1. Escolha ** Atualizar agora ** (pelo status da AMI) ou ** Ações ** > ** Editar ** para abrir o modal de atualização.

1. No modal de atualização da AMI, revise as versões atuais da AMI e seus status.

1. Escolha ** Confirmar ** ou ** Salvar ** para iniciar a atualização da infraestrutura.

O status do ambiente computacional muda para `UPDATING` durante a atualização da infraestrutura. Você pode monitorar o progresso no console do .

------
#### [ CLI ]

Para atualizar as AMIs usando a AWS CLI, use o `update-compute-environment` comando.

```
aws batch update-compute-environment \
    --compute-environment my-compute-environment \
    --compute-resources updateToLatestImageVersion=true
```

Esse comando aciona uma atualização de infraestrutura que substitui instâncias por novas instâncias usando as AMIs compatíveis mais recentes AWS Batch.

------

## Considerações personalizadas sobre a AMI
<a name="custom-ami-considerations"></a>

Se seu ambiente de computação usa AMIs personalizadas, ou seja, AMIs especificadas em `ComputeResources.imageId` (obsoletas)`Ec2Configuration.imageIdOverride`, o modelo de execução padrão ou as substituições do modelo de execução não podem fornecer informações de status para essas AMIs. AWS Batch 
+ **Visibilidade do status ** — as AMIs personalizadas mostram ** "**-" como seu status de imagem ** em ** lote no console e não incluem o `batchImageStatus` campo nas respostas da API.
+ **Gerenciamento manual ** — Você é responsável por manter e atualizar AMIs personalizadas. Mantenha-se informado sobre os patches de segurança e software do seu provedor de AMI e atualize suas AMIs personalizadas adequadamente.
+ **Gerenciamento do EC2 ** — Use o console ou as APIs do Amazon EC2 para gerenciar o ciclo de vida personalizado da AMI, incluindo a criação de novas versões e a descontinuação das antigas.

Para obter mais informações sobre como gerenciar AMIs personalizadas, consulte[Recursos de computação de AMIs](compute_resource_AMIs.md).

## Práticas recomendadas para atualizações de AMI
<a name="ami-update-best-practices"></a>

Esta seção se aplica às AMIs personalizadas e padrão.
+ **Monitoramento regular ** — verifique regularmente o status da AMI de seus ambientes de computação para identificar quando as atualizações estão disponíveis. Para AMIs padrão, elas `batchImageStatus` serão exibidas quando uma atualização estiver disponível. Para AMIs personalizadas, você precisará usar outros recursos, como boletins AWS de segurança.
+ **Janelas de manutenção ** — Agende atualizações da AMI durante as janelas de manutenção quando a interrupção do trabalho for aceitável, pois as atualizações da infraestrutura substituem as instâncias existentes.
+ **Estratégia de repetição de tarefas ** — configure estratégias de repetição de tarefas para lidar com tarefas que possam ser interrompidas durante as atualizações da infraestrutura. Para obter mais informações, consulte [Repetições de trabalho automatizadas](job_retries.md).
+ **Configuração da política de atualização ** — configure as políticas de atualização apropriadas para controlar como as tarefas em execução são tratadas durante as atualizações da infraestrutura. Para obter mais informações, consulte [Realizar atualizações da infraestrutura](infrastructure-updates.md).
+ **Teste ** — teste as atualizações da AMI em ambientes de desenvolvimento antes de aplicá-las aos ambientes de computação de produção.