Concluindo uma atualização

Conclua as etapas de atualização do cluster no Automation Suite no Azure, incluindo a substituição da extensão de Script personalizada após a 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.

Como o processo funciona

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 gerenciada (MSI) associada à implantação (nomeada como <basename>-MSI) como uma identidade atribuída ao usuário a todos os conjuntos de dimensionamento/máquinas virtuais na implantação. Para fazer isso, acesse Scaleset/máquina virtual > Identidade > Usuário Atribuído > Adicionar. Versões mais recentes dos modelos do Automation Suite podem já ter isso adicionado.

• Você deve conceder os direitos de MSI existentes para ler/gravar/gerenciar segredos no cofre de chaves implantado (nomeado como <basename>-VAULT). Para fazer isso, vá para o keyvault, selecione Políticas de acesso e, em seguida, Adicionar, selecione todas as Operações Secretas, escolha o MSI e, em seguida, 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.

• Se o Process Mining estiver habilitado e você quiser usar a versão mais recente do Airflow, certifique-se de fornecer a string de conexão do PostgreSQL para o banco de dados AutomationSuite_Airflow .

  Consulte Requisitos de SQL para o Process Mining para obter mais informações.

  Observação:

  Isso só é aplicável se você atualizar para o Automation Suite 2023.10.9 ou superior.

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 detalhes, consulte Requisitos de hardware e software.

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

• Ao executar uma atualização para um cluster implantado com modelos do Azure, pode ocorrer um erro semelhante ao mostrado na imagem a seguir:

  

  Isso ocorre devido à maneira que o balanceador de carga do Azure funciona. Para corrigir o problema, modifique o campo fixed_rke_address no arquivo cluster_config.json . Você deve alterar o valor deste campo para o endereço IP da primeira instância do servidor antes de executar o comando de atualização. O cluster_config.json carregado para o cofre de chaves deve continuar a ter o endereço IP do ILB, pois o nó não é íntegro e o tráfego não será balanceado para ele.

Execução

Para realizar com sucesso uma atualização para uma nova versão do Automation Suite, siga 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 um modo interativo, use o seguinte comando:

  sh upgradeUiPathAS.sh --targetVersion {ASversion}
  

  O script pede 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 um modo não interativo, siga as seguintes etapas:
  a. Crie uma pasta <targetVersion> ao lado do script baixado.
  b. 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.
  c. 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 acima. 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.