Concluindo uma atualização

Contexto

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.
• Certifique-se de que sua versão RHEL para os conjuntos de escalonamento de máquinas virtuais (servidor, agente etc.) esteja atualizada e corresponda à versão para a qual você está atualizando.
• 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.
• 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 posterior, 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>

• Após o processo de atualização, exporte o novo conteúdo do arquivo cluster_config.json para um segredo do cofre de chaves do Azure chamado clusterConfig no cofre de chaves de implantação (para obter 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 veementemente atualizar para a versão mais recente do sistema operacional RHEL compatível com o Automation Suite. Para obter mais detalhes, consulte .
• 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 e .

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.