Automation Suite
2023.4
falso
Imagem de fundo do banner
Guia de instalação do Automation Suite no Linux
Última atualização 28 de fev de 2024

Automatizado: atualização offline

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. Certifique-se de ter selecionado o nó do servidor primário com o disco adicional do pacote do UiPath conectado em /uipath como seu nó de host do Ansible.
  2. Torne-se o usuário 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 as-installer.zip e copie para /opt/UiPathAutomationSuite/{version}/installer. Para fazer o download das instruções, consulte as-installer.zip.
    cp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installercp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installer
  5. Descompacte as-installer.zip:
    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip as-installer.zip -d .cd /opt/UiPathAutomationSuite/{version}/installer
    unzip as-installer.zip -d .
  6. Baixe as-infra.tar.gz e copie para /uipath/{version}. Para obter instruções de download, consulte as-infra.tar.gz.
    cp /path/to/as-infra.tar.gz /uipath/{version}cp /path/to/as-infra.tar.gz /uipath/{version}
  7. Baixe as.tar.gz e copie para /uipath/{version}. Para obter instruções de download, consulte as.tar.gz.
    cp /path/to/as.tar.gz /uipath/{version}cp /path/to/as.tar.gz /uipath/{version}
  8. Forneça as permissões necessárias ao instalador:
    chmod 755 -R /opt/UiPathAutomationSuite/{version}/installerchmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
  9. 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
    • 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. Para visualizar um exemplo de configuração, consulte Configuração específica do Orchestrator.
    • Ao atualizar o Automation Suite de uma versão anterior e, em conjunto, habilitar o Process Mining, será necessário atualizar sql_connection_string_template_sqlalchemy_pyodbc. Veja um exemplo abaixo.
      "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"
    • Se você atualizar o Automation Suite de uma versão anterior à 2023.4 e tiver o Apps habilitado, você deve criar o banco de dados SQL para o Apps e, em seguida, atualizar o arquivo cluster_config.json com a seguinte configuração:
      "apps": {
      "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
      "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
      }"apps": {
      "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
      "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
      }
      Observação:

      Use o arquivo cluster_config.json atualizado nas próximas etapas de atualização.

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.

Hidratação do registro do Docker

Para minimizar o tempo de inatividade necessário, hidrate docker-registry com imagens de contêiner para a nova versão de produtos antes da atualização.
Importante:
  • Certifique-se de não hidratar imagens de contêiner e/ou outras imagens infra mais que 10 horas antes da atualização.
  • Se você atualizar o Document Understanding e o Computer Vision, você deve baixar as imagens de base que correspondem à sua versão do Automation Suite atualizada (utilize a imagem de base que corresponde à sua versão do Pacote de ML) e hidratá-las no seu registro do docker antes da atualização para evitar interrupções nas suas habilidades de DU em execução.Para baixar os pacotes de instalação do Document Understanding e do Computer Vision, consulte Download dos pacotes de instalação.
Para hidratar docker-registry, execute o seguinte comando no primeiro nó do servidor:
cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/as.tar.gz --offline-tmp-folder /uipath/tmpcd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/as.tar.gz --offline-tmp-folder /uipath/tmp

Configuring the backup

Para configurar o backup, execute as seguintes etapas:

  1. Certifique-se de que você habilitou o backup no cluster. Você deve criar o backup usando a mesma versão do instalador usada para a implantação atual. Para obter instruções, consulte a documentação de backup e restauração correspondente à versão do Automation Suite que você planeja atualizar.Por exemplo, para atualizar o Automation Suite 2021.10, siga as instruções no 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.

Upgrading the cluster

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

  1. Conecte-se ao nó de host do Ansible via SSH e torne-se o usuário 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.
    # Please replace {version} with installer version, in all the below commands
    cd /opt/UiPathAutomationSuite/{version}/installer
    
    ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type offline --steps all --offline-infra-bundle /uipath/{version}/as-infra.tar.gz --accept-license-agreement# Please replace {version} with installer version, in all the below commands
    cd /opt/UiPathAutomationSuite/{version}/installer
    
    ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type offline --steps all --offline-infra-bundle /uipath/{version}/as-infra.tar.gz --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 off-line, escolha o valor offline .

--steps

Possíveis valores são: all, infra, fabric e services.

Denota cada etapa do processo de instalação e atualização.

  • allRecomendado: 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.
  • bundles – Carrega e hidrata o registro do docker hospedado no cluster do Automation Suite com a malha e as imagens do contêiner de serviços.
Importante: você deve carregar e hidratar o registro do Docker ao mesmo tempo em que atualiza o Kubernetes e os componentes da infraestrutura. Para executar as duas etapas simultaneamente, execute --steps bundles infra.
Não execute --steps bundles sozinho, pois isso danificará o cluster.
  • 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.

--offline-bundle

Caminho para o pacote offline as.tar.gz , contendo as imagens de contêiner do Fabric e de serviços. Recomenda-se armazená-lo em /uipath/{version}/as.tar.gz

--offline-infra-bundle

Caminho para o pacote off-line as-infra.tar.gz , contendo Kubernetes e pacotes de infraestrutura.

--cluster-config

cluster_config.json , que define os parâmetros, configurações e preferências aplicadas aos serviços da UiPath implantados por meio do 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:
Se a atualização falhar por qualquer motivo, mas o upload para o Docker Registry for bem-sucedido, nenhum novo upload será necessário. Você pode retomar o upgrade executando diretamente a instalação da malha ou do serviço: ./uipathctl.sh upgrade --install-type offline --steps {fabric | services}.

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

Após realizar a atualização, você pode seguir as seguintes etapas adicionais:

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

    kubectl get applications -n argocdkubectl get applications -n argocd
  • Ao atualizar de uma versão do Automation Suite anterior a 2023.4.0, verifique se o Apps está em execução e remova o MongoDB:

    ./configureUiPathAS.sh mongodb uninstall --force./configureUiPathAS.sh mongodb uninstall --force
  • Se você enfrentar um erro ao remover o MongoDB com o comando ./configureUiPathAS.sh mongodb uninstall --force, execute o seguinte comando:
    kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
    
    ./configureUiPathAS.sh mongodb uninstall --force
    
    kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
    
    ./configureUiPathAS.sh mongodb uninstall --force
    
    kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'
  • 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.

Was this page helpful?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Logotipo branco da Uipath
Confiança e segurança
© 2005-2024 UiPath. All rights reserved.