automation-suite
2022.10
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia de instalação do Automation Suite

Última atualização 3 de dez de 2024

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 -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# 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}/installercp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
  5. Descompacte sf-installer.zip.
    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip sf-installer.zip -d .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 .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.jsoncd /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.jsoncd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh config get -o ./cluster_config.json
    • Se você estiver atualizando o Automation Suite de uma versão anterior e agora ativar o Process Mining também, deverá atualizar o sql_connection_string_template_sqlalchemy_pyodbc. Abaixo está um exemplo.
      "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server""sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
Importante: se você implantou anteriormente sua instalação de nó único usando qualquer versão de modelo do Azure anterior a 2022.10.3 e agora deseja atualizar para uma versão mais recente do Automation Suite, defina o sinalizador zone_resilience como false no cluster_config.json arquivo em /opt/UiPathAutomationSuite/Installer.

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/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-modecd /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./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./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 argocdkubectl 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, siga as instruções descritas na documentação Backup e restauração do cluster.

Concluindo uma atualização com um modelo de implantação

Após executar uma atualização de cluster do Automation Suite, as implantações de modelo do Azure e do AWS exigem algumas alterações para garantir que um novo nó ingresse corretamente no cluster por meio de operações de dimensionamento. Para automatizar as alterações, recomendamos usar os scripts dedicados. Para obter instruções, consulte os documentos do modelo de implantação do Azure e os documentos do modelo de implantação da AWS.

Considerações especiais

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 como 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 desse campo para o endereço IP da primeira instância do servidor antes de executar o comando upgrade. O cluster_config.json carregado no cofre de chaves deve continuar a ter o endereço IP do ILB, pois o nó não está íntegro e o tráfego não será balanceado para ele.

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.