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á.
# Atualize um AWS OpsWorks for Chef Automate servidor para o Chef Automate 2
**Importante**
AWS OpsWorks O Chef Automate chegou ao fim da vida útil em 5 de maio de 2024 e foi desativado para clientes novos e existentes. Recomendamos que os clientes existentes migrem para o Chef SaaS ou uma solução alternativa. Se você tiver dúvidas, pode entrar em contato com a AWS Support equipe no [AWS re:POST](https://repost.aws/) ou por meio do Premium [AWS Support](https://aws.amazon.com/support).
## Pré-requisitos para a atualização para o Chef Automate 2
Antes de começar, certifique-se de entender os novos recursos adicionados ao Chef Automate 2 e os recursos não compatíveis com o Chef Automate 2. Para obter informações sobre os recursos novos e não compatíveis no Chef Automate 2, consulte a [documentação do Chef Automate 2](https://automate.chef.io/docs/upgrade/#considerations) no site do Chef.
Um servidor que executa o Chef Automate 1 deve conter, pelo menos, uma execução de manutenção bem-sucedida após 1º de novembro de 2019 para se tornar elegível para atualização.
Como acontece com qualquer operação de manutenção em seu AWS OpsWorks for Chef Automate servidor, o servidor fica off-line durante a atualização. Programe um período de inatividade de até 3 horas durante o processo de atualização.
Você precisa das credenciais de entrada deste servidor para o site do painel do Chef Automate. Ao concluir a atualização, acesse o painel do Chef Automate e verifique se os nós e as informações da configuração não foram alteradas.
**Importante**
Quando você estiver pronto para atualizar seu AWS OpsWorks for Chef Automate servidor para o Chef Automate 2, use apenas as instruções aqui para atualizar. Como AWS OpsWorks for Chef Automate automatiza muitos dos processos de atualização, como a criação de backup, não siga as instruções de atualização no site do Chef.
## Sobre o processo de atualização
Durante o processo de atualização, o backup do servidor é feito antes de começar a atualização e após concluir a atualização. Os seguintes backups serão criados:
+ Um backup do servidor quando ainda estiver executando o Chef Automate 1 (versão 12.17.33).
+ Um backup do servidor após a atualização ter sido concluída e o servidor estiver executando o Chef Automate 2 (versão 2019-08).
O processo de atualização encerra a EC2 instância da Amazon que o servidor estava usando quando executou o Chef Automate 1. Uma nova instância será criada para executar o servidor do Chef Automate 2.
## Atualizar para o Chef Automate 2 (console)
1. Faça login no Console de gerenciamento da AWS e abra o OpsWorks console em [https://console.aws.amazon.com/opsworks/](https://console.aws.amazon.com/opsworks/).
1. No painel de navegação à esquerda, selecione **AWS OpsWorks for Chef Automate**.
1. Escolha um servidor para visualizar a página das propriedades. Um banner azul no topo da página indica se o servidor é elegível para a atualização para o Chef Automate 2.
**nota**
Um servidor que executa o Chef Automate 1 deve conter, pelo menos, uma execução de manutenção bem-sucedida após 1º de novembro de 2019 para se tornar elegível para atualização.
1. Se o servidor for elegível para a atualização, escolha **Start upgrade (Iniciar atualização)**.
1. Aguarde até três horas pela atualização. Durante o processo de atualização, a página de propriedades exibe o status do servidor como **Under maintenance (Em manutenção)**.
1. Quando a atualização é concluída, a página de propriedades exibe as duas mensagens a seguir: **Successfully upgraded to Automate 2 (Atualização para o Automate 2 concluída com êxito)** e **Maintenance completed successfully (Manutenção concluída com êxito)**. O status do servidor deve ser **HEALTHY (Íntegro)**.
1. Faça login no painel do Chef Automate com as credenciais existentes e verifique se os nós estão relatando corretamente.
## Atualizar para o Chef Automate 2 (CLI)
1. (Opcional) Se você não tiver certeza de quais dos seus AWS OpsWorks for Chef Automate servidores estão qualificados para atualização, execute o comando a seguir. Certifique-se de adicionar o `--region` parâmetro se quiser listar AWS OpsWorks for Chef Automate servidores em uma região da AWS diferente da sua região padrão da AWS.
```
aws opsworks-cm describe-servers
```
Nos resultados, procure o valor de `true` para o atributo `CHEF_MAJOR_UPGRADE_AVAILABLE`. Isso indica que o servidor está qualificado para a atualização para o Chef Automate 2. Anote os nomes dos AWS OpsWorks for Chef Automate servidores que estão qualificados para atualização.
1. Execute o comando a seguir, *server\$1name* substituindo-o pelo nome de um AWS OpsWorks for Chef Automate servidor. Para atualizar para o Chef Automate 2 em vez de executar a manutenção de rotina do sistema, adicione o atributo do mecanismo `CHEF_MAJOR_UPGRADE`, conforme exibido no comando. Adicione o parâmetro `--region` se o servidor de destino não estiver na região da AWS padrão. É possível atualizar somente um servidor por comando.
```
aws opsworks-cm start-maintenance --server-name server_name --engine-attributes Name=CHEF_MAJOR_UPGRADE,Value=true --region region
```
Se AWS OpsWorks for Chef Automate não for possível atualizar o servidor por algum motivo, esse comando resultará em uma exceção de validação.
1. Aguarde até três horas pela atualização. Você pode verificar o status de atualização periodicamente ao executar o comando a seguir.
```
aws opsworks-cm describe-servers --server-name server_name
```
Nos resultados, procure o valor de `Status`. Um `Status` de `UNDER_MAINTENANCE` indica que a atualização ainda está em andamento. Uma atualização bem-sucedida retornará mensagens semelhantes às mensagens a seguir.
```
2019/10/24 00:27:56 UTC Successfully upgraded to Automate 2.
2019/10/23 23:50:38 UTC Upgrading Chef server from Automate 1 to Automate 2
```
Se a atualização não for bem-sucedida, reverte AWS OpsWorks for Chef Automate automaticamente seu servidor para o Chef Automate 1.
Se a atualização tiver sido bem-sucedida, mas o servidor não estiver funcionando da mesma forma como antes da atualização (por exemplo, se os nós gerenciados não estiverem relatando), é possível reverter o servidor manualmente. Para obter informações sobre a reversão manual, consulte [Reverta um AWS OpsWorks for Chef Automate servidor para o Chef Automate 1 (CLI)](#opscm-a2upgrade-rollback-cli).
## Reverta um AWS OpsWorks for Chef Automate servidor para o Chef Automate 1 (CLI)
Se o processo de atualização falhar, reverte AWS OpsWorks for Chef Automate automaticamente seu servidor para o Chef Automate 1. Se a atualização foi bem-sucedida, mas o servidor não está funcionando da mesma forma que antes da atualização, você pode reverter seu AWS OpsWorks for Chef Automate servidor para o Chef Automate 1 manualmente usando o. AWS CLI
1. Execute o comando a seguir para exibir o `BackupId` do último backup realizado no servidor antes de tentar realizar a atualização. Adicione o parâmetro `--region` se o servidor estiver em uma região da AWS diferente da região da AWS padrão.
```
aws opsworks-cm describe-backups server_name
```
O backup IDs está no formato*ServerName-yyyyMMddHHmmssSSS*. Procure as seguintes propriedades do Chef Automate 1 nos resultados.
```
"Engine": "Chef"
"EngineVersion": "12.17.33"
```
1. Execute o comando a seguir, usando o ID do backup retornado na etapa 1 como o valor de `--backup-id`.
```
aws opsworks-cm restore-server --server-name server_name --backup-id ServerName-yyyyMMddHHmmssSSS
```
Aguarde entre 20 minutos e 3 horas para restaurar o servidor, dependendo da quantidade de dados armazenados no servidor. Durante a operação de restauração, o servidor apresentará um status de `RESTORING`. Esse status é exibido na página de propriedades do servidor no Console de gerenciamento da AWS, e retornado nos resultados do **describe-servers** comando.
1. Após a restauração ter sido concluída, o console exibirá a mensagem **Restore completed successfully (Restauração concluída com êxito)**. Seu AWS OpsWorks for Chef Automate servidor está on-line e o mesmo de antes de você iniciar o processo de atualização.
## Consulte também
+ [Manutenção do sistema em AWS OpsWorks for Chef Automate](opscm-maintenance.md)
+ [Restaurar um AWS OpsWorks for Chef Automate servidor a partir de um backup](opscm-chef-restore.md)
+ [https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_DescribeServers.html](https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_DescribeServers.html) na *Referência de API do OpsWorks *
+ [https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_StartMaintenance.html](https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_StartMaintenance.html) na *Referência de API do OpsWorks *