Atualize um AWS OpsWorks for Chef Automate servidor para o Chef Automate 2 - AWS OpsWorks

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 ou por meio do Premium AWS 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 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 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)

  1. Faça login no AWS Management Console e abra o AWS OpsWorks console em https://console.aws.amazon.com/opsworks/.

  2. No painel de navegação à esquerda, selecione AWS OpsWorks for Chef Automate.

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

  4. Se o servidor for elegível para a atualização, escolha Start upgrade (Iniciar atualização).

  5. 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).

  6. 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).

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

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

  3. 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).

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

    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"
  2. 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 AWS Management Console, e retornado nos resultados do describe-servers comando.

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