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
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
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 instância do Amazon EC2 que o servidor estava usando quando o Chef Automate 1 foi executado. Uma nova instância será criada para executar o servidor do Chef Automate 2.
Atualizar para o Chef Automate 2 (console)
Faça login no AWS Management Console e abra o AWS OpsWorks console em https://console.aws.amazon.com/opsworks/
. No painel de navegação à esquerda, selecione AWS OpsWorks for Chef Automate.
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.
Se o servidor for elegível para a atualização, escolha Start upgrade (Iniciar atualização).
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).
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).
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)
-
(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 atributoCHEF_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. -
Execute o comando a seguir, substituindo
server_name
pelo nome de um servidor. AWS OpsWorks for Chef Automate Para atualizar para o Chef Automate 2 em vez de executar a manutenção de rotina do sistema, adicione o atributo do mecanismoCHEF_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 --regionregion
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.
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
. UmStatus
deUNDER_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).
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
-
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
Os IDs de backup estão no formato
ServerName-YYYYMMDDHHMMSSSSSS
. Procure as seguintes propriedades do Chef Automate 1 nos resultados."Engine": "Chef" "EngineVersion": "12.17.33"
-
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-idServerName-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 AWS Management Console, e retornado nos resultados do describe-servers comando. 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
-
Restaurar um AWS OpsWorks for Chef Automate servidor a partir de um backup
-
DescribeServers na Referência de API do AWS OpsWorks
-
StartMaintenance na Referência de API do AWS OpsWorks