Automatizado: atualização online

O Ansible é usado para automatizar a atualização de todo o cluster do Automation Suite, executando algumas operações em uma máquina do cluster.

In the following illustration, the Server 1 node (or Ansible host node) uses Ansible to orchestrate the upgrade of entire Automation Suite cluster.

Preparação

Importante:

Before upgrading, make sure you have prepared your environment for using the uipathctl.sh script. For details, see Using uipathctl.sh.

Certifique-se de ter 10 GiB de espaço livre na pasta /opt/UiPathAutomationSuite em todos os nós. Se não tiver espaço suficiente, você pode aumentar a capacidade dessa pasta ou remover todos os arquivos de instalador anteriores, exceto por cluster_config.json. Sempre é possível baixar o instalador anterior novamente.

Para verificar o espaço disponível, execute o comando a seguir: df -h /opt/UiPathAutomationSuite.

Para se preparar para a atualização, siga as seguintes etapas:

1. Log into the server node that you previously identified as the Ansible host node via SSH.

2. Seja um usuário da raiz.

   sudo su -
   

3. Crie uma pasta de instalação no diretório /opt/UiPathAutomationSuite.

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer
   

4. Download sf-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
   

5. Descompacte sf-installer.zip.

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .
   

6. Forneça as permissões necessárias para o instalador.

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer .
   

7. Gere o arquivo cluster_config.json mais recente no nó do host Ansible.

   Observação:

   For details on how to configure the cluster_config.json parameters, see Advanced installation experience.

   • Se você tiver o cluster_config.json antigo, gere o arquivo de configuração a partir do cluster:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
     

   • Se você não tiver o arquivo cluster_config.json antigo, gere qualquer substituição de algum valor padrão que você pode ter feito no momento da instalação da versão anterior:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -o ./cluster_config.json
     

Execução

Importante:

Se algum erro ou problema ocorrer durante ou após a atualização, você pode reverter para a versão anterior, contanto que tenha configurado um backup anteriormente.

For instructions, see Rollback on error.

Configuring the backup

Para configurar o backup, execute as seguintes etapas:

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2021.10, follow the instructions in the 2021.10 guide.

2. Log into the server node that you previously identified as the Ansible host node via SSH.

3. Verifique se todos os volumes desejados têm backups no cluster:

   /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
   

   Observação:

   O backup pode levar algum tempo, portanto, aguarde aproximadamente 15 a 20 minutos e verifique o backup dos volumes novamente.

Após a criação do backup, continue com as próximas etapas.

Putting the cluster in maintenance mode

Colocar o cluster no modo de manutenção encerrará o controlador de ingresso e todos os serviços da UiPath, bloqueando todo o tráfego de entrada para o cluster do Automation Suite.

Importante:

This operation will cause downtime, and your business automation will be suspended during the entire upgrade process.

1. Para colocar o cluster no modo de manutenção, execute:

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode
   

2. Para verificar se o cluster está no modo de manutenção, execute:

   ./configureUiPathAS.sh is-maintenance-enabled
   

   Importante:

   Create a backup of your SQL Server after enabling maintenance mode so that no further transactions are recorded in your SQL database.

Como atualizar o cluster

Para atualizar o cluster do Automation Suite, execute as seguintes etapas:

1. Conecte-se ao host Ansible via SSH e torne-se um usuário da raiz.

2. Para executar as etapas de atualização em todos os nós, execute o seguinte comando com os parâmetros básicos. Para um controle mais granular, consulte a seção de parâmetros.

   Observação:

   Make sure you have updated cluster_config.json generated as described in the Preparation steps.

   ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type online --steps all --accept-license-agreement
   

   Importante:

   O processo de atualização requer a migração do Canal CNI para o Cilium CNI. A atualização automatizada executa esta etapa automaticamente e reinicia todos os nós no cluster para concluir a migração.

   Depois que os nós forem reiniciados, aguarde alguns minutos para garantir que todos os serviços estejam online novamente. Você pode fazer login no ArgoCD para monitorar o status de todos os aplicativos.

   Importante:

   If you get the following error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

Parâmetros básicos

Parâmetro	Valor
--install-type	Valores possíveis: online e offline. Como esta página fornece instruções para um ambiente online, escolha o valor online.
--steps	Possíveis valores são: all, infra, fabric e services. Denota cada etapa do processo de instalação e atualização. all - Um superconjunto de todas as outras etapas, que atualiza todo o Automation Suite. infra – Atualiza o Kubernetes e outros componentes de infraestrutura no Automation Suite em todos os nós. fabric – Atualiza todos os componentes de malha e compartilhados do Automation Suite. services – Atualiza todos os serviços do produto UiPath instalados no Automation Suite. Se ocorrer um erro durante a atualização, você pode usar esses pontos de verificação para retomar a operação de atualização em vez de tentar novamente desde o início.
--cluster-config	arquivo cluster_config.json, que define os parâmetros, configurações e preferências aplicadas aos serviços UiPath implantados via Automation Suite.

Parâmetros Avançados

Parâmetro	Valor
--ansible-username	Especifique o nome de usuário a ser usado para conexões SSH para todos os nós. O padrão é o usuário atual. Se você usar um nome de usuário diferente para todos os nós, em vez de usar esse parâmetro, defina o nome de usuário para todos os nós em inventory.ini e passe-o para o script. Exemplo: Ao executar o script, você está logado com o nome de usuário myadminuser. No entanto, se quiser usar o nome de usuário testadmin para conectar via SSH, você deve fornecer testadmin para este parâmetro.
--inventory	Especifique um arquivo de inventário Ansible existente. Se não for especificado, um será gerado automaticamente a partir do cluster existente com a configuração básica. Em determinados cenários, nos quais você quer ter um controle mais granular, é recomendado fornecer seu próprio arquivo de inventário. Um exemplo desse tipo seria se você quiser usar um nome de usuário SSH diferente ou uma chave SSH para todos os nós em cluster. For details, see Generating the Ansible inventory.ini file.

Observação:

Depois de atualizado, o modo de manutenção será desabilitado automaticamente.

Depois de realizar a atualização, você pode adotar as seguintes etapas adicionais.

• Para verificar se o Automation Suite está íntegro, execute:

  kubectl get applications -n argocd
  

• If you experience issues with image vulnerabilities or storage consumption after performing an upgrade, delete the images from the old installer. For details, see the Troubleshooting section.

Enabling the backup post-upgrade

Observação:

Make sure Automation Suite is up and running and your automation continues as expected before proceeding with the next steps.

Antes de iniciar a atualização do cluster, o script de atualização cria automaticamente um backup do cluster e o desabilita temporariamente. Pode ser do seu interesse habilitar o backup manualmente após o término da atualização.

Para habilitar o backup, execute o comando a seguir de qualquer nó de servidor:

# replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh resume-scheduled-backups