Concluindo uma atualização

Depois de executar uma atualização de cluster do Automation Suite, algumas alterações são necessárias para garantir que um novo nó ingresse no cluster corretamente por meio de operações de expansão. Para automatizar as alterações, recomendamos usar o script upgrade_wrapper.py .

Preparação

Pré-requisitos

Certifique-se de atender aos seguintes requisitos:

• O Python 3.8 ou mais recente deve ser instalado na máquina na qual você executa o script. Para obter detalhes, consulte a documentação do Python.
• Os pacotes Python são necessários para o script. Você pode instalar esses pacotes usando o seguinte comando pip. Para mais detalhes, consulte a documentação do pip.

  pip install wget requests boto3

• boto3 os clientes devem poder se autenticar na AWS porque ocorrem alterações de implantação por meio deles. Você pode fornecer credenciais como variáveis de ambiente ou por meio de um perfil padrão usando um arquivo de credencial compartilhado. O usuário deve ter a permissão para realizar as ações descritas na seção Comportamento do script.

• Certifique-se de que sua versão RHEL para o Grupo de Escala Automática (Servidor, Agente etc.) esteja atualizada e corresponda à versão para a qual você está atualizando.

• Certifique-se de revisar o arquivo cluster_config.json e alterar quaisquer valores booleanos marcados como string ("true"/"false") para valores booleanos reais (true/false). Por exemplo:
  • para habilitar a resiliência de zona, use "zone_resilience": true.
  • para permitir que o instalador crie os bancos de dados, use "sql.create_db": true.
• Ao atualizar o Automation Suite 2022.10 para o Automation Suite 2023.4 ou mais recente com o Orchestrator ativado em ambas as versões, é necessário definir o sinalizador orchestrator.block_classic_executions como true no arquivo cluster_config.json. O sinalizador tem o objetivo de expor seu consentimento com o bloqueio de execuções de pastas clássicas. Ignorar o sinalizador gera uma falha na operação de atualização. Esse parâmetro não é necessário em novas instalações.
• Se você atualizar para o Automation Suite 2023.10 ou posterior e o Insights estiver habilitado em ambos os ambientes, é necessário definir o sinalizador insights.external_object_storage.bucket_name para o mesmo bucket usado para platform no arquivo cluster_config.json. Ignorar o sinalizador gera uma falha na operação de atualização. Esse parâmetro não é necessário em novas instalações.
• Se você atualizar para o Automation Suite 2023.10 ou mais recente, certifique-se de preencher os seguintes campos no cluster_config.json se sql.create_db estiver definido como true:

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>

Considerações do script

Ao executar o script upgrade_wrapper.py , leve em consideração o fato de que ele executa as seguintes operações:

• Baixa na pasta atual as dependências necessárias;
• Extrai informações da pilha de implantação do Automation Suite;

• Cria uma nova pilha contendo:

  • Um novo Launch Template para cada Grupo de Auto Scaling presente na implantação inicial com as alterações necessárias para o fluxo de instalação da nova versão;
  • Uma política IAM anexada à função IAM usada pelos nós do Automation Suite que permite a operação DescribeStackResource na pilha atual;
    Observação: a política é implantada somente se uma função personalizada do IAM não foi fornecida no momento da implantação. Caso contrário, você deve conceder a permissão cloudformation:DescribeStackResource na pilha recém-implantada para a função IAM usada pelos nós do Automation Suite.
• Atualiza o Auto Scaling Group para usar os Launch Templates criados na nova pilha;
• Atualiza o parâmetro SSM contendo a URL do instalador (opcional, dependendo da versão inicial do modelo de implantação);

• Substitui o instalador antigo usado na implantação inicial por aquele usado para atualização em todos os nós por meio de um comando de execução do SSM. Isso é necessário para preservar a funcionalidade dos documentos SSM já existentes na implantação inicial;

  Observação: o documento SSM de atualização de AMI pode não funcionar mais após a atualização do modelo de execução. A função IAM usada pelos documentos SSM deve ser atualizada com a permissão ec2:CreateLaunchTemplateVersion e as permissões ec2:RunInstances nos modelos de lançamento recém-criados.
• Limpa os arquivos baixados.

Execução

Para concluir uma atualização com êxito, execute as seguintes etapas:

1. Baixe o script upgrade_wrapper.py aqui.
2. Execute o script em um modo interativo ou não interativo:
   • Opção 1: Se você executar o script em modo interativo, use o seguinte comando: python3 upgrade_wrapper.py

   • Opção 2: se você executar o script em um modo não interativo, ele preencherá automaticamente as seguintes variáveis de ambiente:

     • A variável AS_VERSION é preenchida com a versão do Automation Suite que você usou para o upgrade;
     • Os nomes de parâmetros em letras maiúsculas são necessários para uma versão específica. Você pode verificar os parâmetros no objeto upgrade_matrix.json definindo as dependências necessárias para esse processo. Por exemplo, para passar a região de implantação necessária para a versão 2022.10.1, você deve definir a variável de ambiente AS_DEPLOYMENT_REGION.