Etapa 13: geração de cluster_config.json

Geração do cluster_config.json na primeira máquina

O arquivo cluster_config.json define os parâmetros, configurações e preferências aplicadas a produtos da UiPath® implantados via Automation Suite. Você pode criar o cluster_config.json manualmente ou usar o instalador interativo, que faz várias perguntas obrigatórias e gera o arquivo para você. Sempre é possível editar o arquivo gerado para atualizar a configuração.

Execução do instalador interativo para gerar cluster_config.json

Para gerar o arquivo cluster_config.json, navegue até a pasta do instalador e execute o seguinte comando:

cd /opt/UiPathAutomationSuite/<version>/installer

./installUiPathAS.sh

O comando mencionado acima inicia o fluxo interativo, que faz uma série de perguntas necessárias para a configuração do Automation Suite.

Para gerar o arquivo de configuração, siga as seguintes etapas:

1. Aceite o contrato de licença para começar a configurar o Automation Suite.
2. No Menu principal, selecione seu modo de implantação. Suas opções são:

   • Implantação de nó único — Recomendada para fins de demonstração e avaliação;

   • Implantação de vários nós – Recomendada para uso em produção.

   
3. Em Configuração de implantação, selecione seu tipo de ambiente. Suas opções são:

   • Online — Requer acesso à Internet;

   • Isolado – Também conhecido como offline; não requer acesso à Internet.

4. Escolha sua seleção de produtos. Suas opções são:
   • Completo (todos os produtos)
   • Selecione os produtos

   Para obter detalhes sobre as opções de seleção de produtos, consulte Requisitos de hardware e software.

5. Se você escolheu Selecionar produtos na etapa anterior, indique os produtos que deseja instalar. Suas opções são:
   • Action Center
   • AI Center
   • Apps
   • Automation Hub
   • Automation Ops
   • Automation Suite Robots
   • Data Service
   • Document Understanding
   • Insights
   • Orchestrator
   • Process Mining
   • Task Mining
   • Test Manager

   Observação:

   Alguns produtos do Automation Suite têm dependências adicionais entre eles. Ao selecionar os produtos que você deseja instalar, certifique-se de considerar . Tentar instalar um produto sem suas dependências resultaria em erro.

   Além disso, alguns produtos do Automation Suite exigem um nó de agente dedicado. Antes de continuar, certifique-se de atender aos requisitos de hardware.

   Se você optar por uma configuração Ativa/Passiva ou Ativa/Ativa, certifique-se de que os produtos que você habilitar sejam compatíveis. Para obter detalhes, consulte Disaster Recovery - Ativo/Passivo e Ativo/Ativo.

6. Para instalar o AI Center, você deve executar as seguintes etapas adicionais:
   1. Especifique se o AI Center requer um Orchestrator externo.
      • Se o AI Center não exigir um Orchestrator externo, continue para a Etapa 7.
      • Se o AI Center exigir um Orchestrator externo, continue para a Etapa 6.b.
   2. Copie o certificado do Orchestrator para a máquina virtual. Para obter mais informações sobre isso, consulte a página Copiar o certificado do Orchestrator .
   3. Especifique o URL do Orchestrator para o AI Center. Exemplo: https://orchestrator.example.com.
   4. Especifique o URL de identidade do AI Center. Exemplo: https://orchestrator.example.com/identity.
   5. Especifique o caminho para o arquivo de certificado do Orchestrator. Exemplo: /opt/UiPathAutomationSuite/UiPath_Installer/orch.cer.
   6. Especifique o caminho para o arquivo de certificado de identidade. Exemplo: /opt/UiPathAutomationSuite/UiPath_Installer/identity.cer.
   7. Em instalações online, especifique a chave de API de medição.
      Observação: metering_api_key é a chave de API do Document Understanding da conta de nuvem do AI Center.
7. Confirme sua seleção de produto para determinar os requisitos mínimos de hardware e software.
8. Insira o FQDN do conjunto de automação.
9. Especifique se você gostaria de trazer seu próprio objectstore para os produtos selecionados. É altamente recomendável usar um objectstore externo. Se você selecionar Não, optará pelo armazenamento de objetos padrão. Se selecionar Sim, escolha uma das seguintes opções:
   • Conta de armazenamento do Azure – indique se deseja usar identidade gerenciada com base em sua conta de armazenamento do Azure, forneça os seguintes detalhes correspondentes à sua escolha e especifique se deseja que os contêineres sejam provisionados automaticamente para todos os produtos selecionados:
     • Se Sim, forneça o nome da conta de armazenamento do Azure e o sufixo do ponto de extremidade e sua ID de cliente;
     • Se No, forneça o nome da conta de armazenamento do Azure e o sufixo do ponto de extremidade e sua chave de conta do Azure;
   • AWS S3 – Forneça o prefixo e o sufixo para os nomes dos buckets, a região da AWS onde os buckets estão hospedados, a chave de acesso e a chave secreta da conta S3 e especifique se deseja que os buckets sejam provisionados automaticamente para todos os produtos selecionados.
   • Outro armazenamento compatível com S3 – Especifique o prefixo e o sufixo para os nomes dos buckets, o FQDN do servidor S3, a porta S3, a chave de acesso e a chave secreta para a conta S3 e especifique se deseja que os buckets sejam provisionados automaticamente para todos os produtos selecionados.

   Observação:

   Muitos objetos S3 requerem o CORS definido para todo o tráfego do cluster do Automation Suite. Você deve configurar a política CORS no nível do objectstore para permitir o FQDN do cluster.

10. Especifique se deseja trazer seu próprio registro do Docker externo compatível com OCI.

    • Ao selecionar Não, você opta pelo registro interno padrão do Docker.

    • Ao selecionar Sim, você deve fornecer os seguintes detalhes sobre o registro que deseja usar: URL do registro com porta, nome de usuário, senha e senha de extração.

11. Especifique se você deseja trazer seu próprio High Availability Add-on externo (HAA).

    • Se você selecionar Não, optará pelo padrão no cluster HAA.

    • Se você selecionar Sim (configuração padrão), optará pelo HAA instalado em máquinas externas e deve fornecer os seguintes detalhes sobre seu HAA externo: FQDN, senha, porta e configuração TLS.

12. Especifique se você deseja usar a autenticação do Kerberos para conexões SQL.
13. Insira o FQDN do SQL Server. Siga o prompt para inserir a porta de conexão, nome de usuário e senha.
    Observação:

    O Process Mining requer um segundo SQL Server. Se você instalar o Process Mining, certifique-se de fornecer a URL do SQL Server do warehouse, o nome do banco de dados, o prompt de conexão, o nome de usuário e a senha.

    Para obter detalhes sobre os requisitos de hardware que o segundo SQL Server deve atender, consulte Requisitos do SQL para o Process Mining. Para obter mais informações sobre como configurar bancos de dados SQL para o Process Mining, consulte Configuração específica do Process Mining.

    Importante:

    Para Process Mining no Automation Suite 2023.10.9 ou superior, usar o PostgreSQL para o banco de dados Airflow é a opção recomendada. Se você optar por usar um banco de dados PostgreSQL, precisará adicionar manualmente a string de conexão airflow.metadata_db_connection_str para o banco de dados AutomationSuite_Airflow no cluster_config.json.

    Consulte Requisitos de SQL para configuração específica do Process Mining e do Process Mining para obter mais informações.

14. Especifique se você deseja que o instalador crie automaticamente os bancos de dados necessários.
15. Forneça os certificados de CA para qualquer software de servidor externo que requer comunicação TLS segura; caso contrário, a instalação falhará. Se você não habilitou a comunicação TLS, configure os certificados após a instalação.
    Observação:

    O instalador aceita apenas certificados DER codificados em Base64 no formato PEM . Se os servidores externos tiverem CAs diferentes, você pode concatenar todos os certificados públicos em um único arquivo.
16. Após definir os parâmetros de configuração, o instalador gera automaticamente a configuração. Você pode editar os parâmetros de configuração diretamente no terminal.
    Observação:

    Agora você pode editar diretamente ocluster_config.json para configurações avançadas na pasta UiPathAutomationSuite.

    Para uma implantação Disaster recovery - Ativa/Passiva, agora você deve executar as seguintes etapas:

    1. Instale e configure o cluster primário. Para obter detalhes, consulte Experiência de instalação avançada.

    2. Instale e configure o cluster primário. Para obter detalhes, consulte Disaster Recovery - Instalando o cluster secundário.

    3. Retome a instalação seguindo as instruções nesta página.

Observação: no final do processo de configuração, o arquivo cluster_config.json é gerado no local /opt/UiPathAutomationSuite/cluster_config.json. Observe que todas as nossas instruções de instalação pressupõem que você armazena cluster_config.json nessa pasta.

Copiando cluster_config.json para todas as outras máquinas

Para instalar o Automation Suite, o arquivo cluster_config.json deve estar disponível em todas as máquinas. Após gerar o arquivo de configuração na primeira máquina, você deve copiá-lo para as outras máquinas em vez de gerá-lo novamente. Gerar novamente o arquivo de configuração pode resultar em discrepâncias que podem causar uma falha na instalação.

Para copiar o arquivo de configuração da primeira máquina para as outras máquinas, execute o seguinte comando. Certifique-se de substituir username e node_dns pelos valores relevantes para a máquina de destino.

scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node_dns>:/opt/UiPathAutomationSuite

Se você não tiver acesso direto para copiar os arquivos para a pasta /opt/UiPathAutomationSuite, pode transferi-los para seu diretório inicial e depois movê-los para o local desejado.