automation-suite
2022.10
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Guia de instalação do Automation Suite
Last updated 1 de nov 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 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. Baixe sf-infra.tar.gz e copie para /uipath/{version}. Para baixar instruções, consulte sf-infra.tar.gz.
    cp /path/to/sf-infra.tar.gz /uipath/{version}cp /path/to/sf-infra.tar.gz /uipath/{version}
  7. Baixe sf.tar.gz e copie para /uipath/{version}. Para baixar instruções, consulte sf-infra.tar.gz.
    cp /path/to/sf.tar.gz /uipath/{version}cp /path/to/sf.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
    • 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"

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.

Hydrating Docker-registry

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}/sf.tar.gz --offline-tmp-folder /uipath/tmpcd /opt/UiPathAutomationSuite/{version}/installer

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

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 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}/sf-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}/sf-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 sf.tar.gz , contendo as imagens de contêiner do Fabric e de serviços. Recomenda-se armazená-lo em /uipath/{version}/sf.tar.gz

--offline-infra-bundle

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

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

  • Após atualizar para o Automation Suite 2022.10.13 ou mais recente, você pode limpar as imagens de versão anteriores após a atualização a partir do registro do Docker no cluster. Para obter instruções, consulte Como excluir imagens do instalador antigo após a atualização.

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.

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.