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.

Na ilustração a seguir, o nó Servidor 1 (ou nó host Ansible) usa Ansible para orquestrar a atualização de todo o cluster do Automation Suite.

Preparação

Importante:

Antes de atualizar, certifique-se de preparar seu ambiente para usar o script uipathctl.sh . Para obter detalhes, consulte Uso do 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. Faça login no nó do servidor que você identificou anteriormente como o nó de host do Ansible 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. Baixe sf-installer.zip e copie para /opt/UiPathAutomationSuite/{version}/installer. Para fazer o download das instruções, consulte 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: para mais detalhes sobre como configurar os parâmetros cluster_config.json , consulte Experiência de instalação avançada.

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

Para instruções, consulte Reverter erro.

Configuring the backup

Para configurar o backup, execute as seguintes etapas:

1. Certifique-se de ter habilitado o backup no cluster. Você deve criar o backup usando a mesma versão do instalador que você usou para a implantação atual. Para obter instruções, consulte a documentação de backup e restauração correspondente à versão do Automation Suite da qual você planeja atualizar. Por exemplo, se você planeja atualizar do Automation Suite 2021.10, siga as instruções do guia 2021.10.
2. Faça login no nó do servidor que você identificou anteriormente como o nó de host do Ansible 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 novamente o backup dos volumes.

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: Essa operação causará tempo de inatividade, e a automação de negócios será suspensa durante todo o processo de atualização.

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: Crie um backup do seu Servidor SQL após ativar o modo de manutenção para que transações adicionais não sejam registradas no seu banco de dados SQL.

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: Certifique-se de ter atualizado o cluster_config.json gerado conforme descrito nas etapas de preparação.

   ./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:

   Se você receber o seguinte erro, siga as instruções em Downgrade do Ceph da versão 16.2.6 para a 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. Para obter detalhes, consulte Geração do arquivo Ansible Inventory.ini.

Observação: quando a atualização for concluída, o modo de manutenção será desativado 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

• Se você tiver problemas com vulnerabilidades de imagem ou consumo de armazenamento após realizar uma atualização, exclua as imagens do instalador antigo. Para obter detalhes, consulte a seção Solução de problemas.

Enabling the backup post-upgrade

Observação: Certifique-se de que o Automation Suite esteja funcionando e que sua automação corresponda às expectativas antes de prosseguir para as próximas etapas.

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