Manual: instalação do Automation Suite

A tabela a seguir lista as etapas que você deve executar para a instalação do Automation Suite:

Etapas	Instalação de nó único	Instalação de vários nós	Modo Lite
Pré-requisito	✅	✅	✅
Etapa 1: aceitar o contrato de licença	✅	✅	✅
Etapa 2: instalar a infraestrutura na primeira máquina de servidor	✅	✅	✅
Etapa 3: instalar a infraestrutura nas outras máquinas de servidor	❌	✅	✅
Etapa 4: instalar a infraestrutura em todas as máquinas de agente	❌	✅	✅
Etapa 5: Hidratação do registro no cluster para instalações offline	✅	✅	✅
Step 6: Completing the installation	✅	✅	✅

Pré-requisito

Configure a variável de ambiente KUBECONFIG para apontar para o arquivo de configuração do RKE2 Kubernetes e atualize a variável de ambiente PATH para incluir o diretório de ferramentas do RKE2 usando os seguintes comandos de exportação:

export KUBECONFIG=/etc/rancher/rke2/rke2.yaml 
export PATH=$PATH:/var/lib/rancher/rke2/bin

Etapa 1: aceitar o contrato de licença

Antes de executar a instalação, certifique-se de ler o contrato de licença.

Para aceitar o contrato de licença, escolha um dos seguintes métodos:

• Opção 1 (Variável de ambiente) — Defina a variável de ambiente LICENSE_AGREEMENT como accept executando o seguinte comando:

  export LICENSE_AGREEMENT=accept
  

• Opção 2 (Parâmetro Inline) — Anexe --accept-license-agreement em cada execução de uipathctl.

Etapa 2: instalar a infraestrutura na primeira máquina de servidor

Para instalar a infraestrutura na primeira máquina de servidor, navegue até a pasta do instalador e execute o seguinte comando:

cd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

Observação:

• O parâmetro -k instala a infraestrutura na primeira máquina de servidor.
• Após a instalação da infraestrutura, a máquina de servidor se torna um nó no cluster do Automation Suite.

Etapa 3: instalar a infraestrutura nas outras máquinas de servidor

Para expandir o cluster do Automation Suite, instale a infraestrutura nas máquinas de servidor adicionais.

Para fazer isso, execute o seguinte comando em todas as máquinas do servidor adicionais:

cd /opt/UiPathAutomationSuite/<version>/installer
 
./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j server --accept-license-agreement

Observação:

O parâmetro -j server adiciona as máquinas como nós de servidor ao cluster existente do Automation Suite. O sinalizador fixed_rke_address no arquivo cluster_config.json conecta o cluster existente do Automation Suite.

Etapa 4: instalar a infraestrutura em todas as máquinas de agente

Se você tiver máquinas de agente adicionais, deverá instalar a infraestrutura nessas máquinas e adicioná-las como nós de agente ao cluster do Automation Suite.

Para isso, execute o seguinte comando em todas as máquinas dos agentes:

cd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j agent --accept-license-agreement

Observação:

O parâmetro do servidor -j adiciona as máquinas como nós do servidor ao cluster existente do Automation Suite. O sinalizador fixed_rke_address no arquivo cluster_config.json conecta o cluster existente do Automation Suite.

Etapa 5: Hidratação do registro no cluster para instalações offline

Essa etapa é necessária apenas se você usar o registro no cluster para instalações offline.

Para semear o registro no cluster do registro temporário, execute o seguinte comando:

cd /opt/UiPathAutomationSuite/<version>/installer
./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json

Se você estiver configurando o Automation Suite com projetos modernos do Document Understanding habilitado, use a opção --serial com o comando hidr-registry para evitar problemas de falta de memória:

./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json --serial

Step 6: Completing the installation

Neste ponto, todos os nós devem estar interconectados para estabelecer a infraestrutura para instalar o Automation Suite.

Para concluir a instalação, siga as seguintes etapas:

1. Verifique se todos os nós estão disponíveis no primeiro nó do servidor, executando o seguinte comando:

   kubectl get nodes
   

   A saída do comando mencionado acima deve ter uma aparência semelhante à mostrada na imagem a seguir. Observe que o número total de nós deve corresponder à soma de nós de servidor e agente.

   

2. Crie os pré-requisitos necessários para a instalação dos componentes compartilhados, executando o seguinte comando:

   ./bin/uipathctl prereq create /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json
   

   Eles são principalmente buckets de armazenamento de objetos e bancos de dados SQL. Os bancos de dados SQL necessários para a instalação serão criados no servidor SQL se sql.create_db key estiver definido no arquivo de configuração. Os buckets de armazenamento de objetos serão criados no provedor de nuvem se a chave object_storage.create_bucket for definida no arquivo de configuração.

3. Valide os pré-requisitos exigidos pela instalação de componentes compartilhados, executando o seguinte comando:

   ./bin/uipathctl prereq run /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json
   

4. Após verificar a infraestrutura, instale os componentes compartilhados e os serviços executando o seguinte comando:

   ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions ./versions/helm-charts.json