Concluindo uma atualização

Context

Depois de executar um upgrade de cluster do Automation Suite, algumas alterações são necessárias para garantir que um novo nó ingresse no cluster corretamente. Para automatizar as alterações, recomendamos usar o script upgradeUiPathAS.sh .

Esta página fornece instruções sobre como substituir a Custom Script Extension (CSE) nos recursos de computação para que novos nós possam ser adicionados ao seu cluster ao atualizar para uma nova versão do Automation Suite.

O processo descrito nas seções a seguir baixa os scripts necessários para realizar algumas pequenas modificações nos recursos do Azure, bem como para validar alguns pré-requisitos. Os scripts são encontrados nas pastas <targetVersion> e Modules . Se o processo falhar, você será perguntado se deseja manter os arquivos.

Depois de garantir que os pré-requisitos sejam válidos, os objetos CustomScriptExtension são atualizados em todos os nossos recursos de computação para que os nós recém-adicionados usem o Automation Suite <targetVersion>. Por fim, os arquivos nos nós iniciais do cluster são substituídos, para também corresponder aos arquivos do <targetVersion>.

Preparação

Pré-requisitos

Certifique-se de atender aos seguintes requisitos:

• Você deve adicionar a Identidade de Serviço Gerenciado (MSI) associada à implantação (chamada como <basename>-MSI) como uma identidade atribuída pelo usuário a todos os scalesets/máquinas virtuais na implantação. Para fazer isso, vá para Scaleset/máquina virtual > Identidade > Atribuído pelo usuário > Adicionar. As versões mais recentes dos modelos do Automation Suite já podem ter isso adicionado.
• Você deve conceder aos direitos MSI existentes para ler/gravar/gerenciar segredos no cofre de chaves implantado (chamado como <basename>-VAULT). Para fazer isso, vá para o cofre de chaves, clique em Políticas de acessoe depois em Adicionar, selecione todas as operações secretas, escolha o MSI e depois em Adicionar.
• 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.
  Observação:

  Ao atualizar o Automation Suite 2022.10 para o Automation Suite 2023.4 ou posterior 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. Este parâmetro não é necessário em novas instalações.
• Após o processo de atualização, exporte o novo conteúdo do arquivo cluster_config.json para um segredo do Azure Key Vault chamado clusterConfig no Key Vault de implantação (para obter mais detalhes, consulte o item da lista anterior). Use o valor do campo FixedRKEAddress como o IP do Balanceador de carga interno. Para fazer isso, execute um comando semelhante ao seguinte:

  az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)

• Na máquina que executa o script de atualização, você deve estar conectado ao Azure e definir o contexto para a assinatura correta. A conta deve ter a função Owner no grupo de recursos em que o cluster foi implementado.

Considerações e recomendações

Antes de iniciar a operação de atualização, certifique-se de levar em consideração as seguintes recomendações:

• Recomendamos fortemente atualizar para a versão mais recente do SO RHEL compatível com o Automation Suite. Para obter detalhes, consulte Uma olhada rápida nos perfis de implantação.
• Antes de iniciar a operação de atualização, você pode criar dois contêineres chamados logs e flags na conta de armazenamento de implantação (chamada <basename>st). Se você não os criar, o script de atualização pode fazer isso por você.
• Se os scalesets do servidor implantado não tiverem um disco Ceph anexado, o script criará um e o anexará ao scaleset do servidor.
• O processo de atualização altera o modelo VMSS, mas não o aplica a instâncias mais antigas.
• Para obter detalhes sobre os erros de atualização que você pode encontrar, consulte Manual: atualização online e Automatizado: atualização online.

Execução

Para executar com êxito a atualização para uma nova versão do Automation Suite, execute as seguintes etapas:

1. Baixe o script upgradeUiPathAS.sh aqui.
2. Navegue até o caminho onde você baixou o script e execute o seguinte comando: chmod +x ./upgradeUiPathAS.sh.
3. Execute o processo de atualização no modo interativo ou não interativo em um ambiente Linux:

   • Opção A: Para executar o processo em modo interativo, use o seguinte comando:

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     O script solicita que você forneça uma série de parâmetros durante a execução. Para obter detalhes sobre os parâmetros necessários, consulte Implantação do Automation Suite no Azure.

   • Opção B: Para executar o processo em modo não interativo, siga os seguintes passos:

     1. Crie uma pasta <targetVersion> ao lado do script baixado.
     2. Dentro da pasta <targetVersion> , crie um arquivo chamado paramValues.json com a seguinte estrutura:
        { "param1":"value1", "param2":"value2" }.

        Para obter detalhes sobre os parâmetros necessários, consulte Implantação do Automation Suite no Azure.

     3. Execute o script upgradeUiPathAS.sh:

        sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true

        Observação: certifique-se de substituir {ASversion} pela versão do Automation Suite nos comandos mencionados anteriormente. A versão do Automation Suite pode ser diferente da versão do modelo do Azure.

Parâmetros

Você pode encontrar descrições dos parâmetros necessários para atualizar para uma versão específica do Automation Suite no arquivo cluster_config.json . Você pode encontrar o arquivo cluster_config.json neste link.