Instalação do Automation Suite

Esta página orienta você pelas instruções de instalação de alto nível do Automation Suite no AKS e no EKS.

Antes de começar, considere o seguinte:

• O conhecimento de gerenciamento de recursos em nuvem do Kubernetes, AWS e Azure é necessário para implantar e gerenciar o Automation Suite no AKS/EKS. Se você encontrar problemas na instalação e configuração do Automation Suite no AHS;EKS, entre em contato com a UiPath® Professional Services.
• Before choosing your deployment profile, see Deployment scenarios.
• The installation process generates self-signed certificates on your behalf. You should replace them with certificates signed by a trusted Certificate Authority (CA) as soon as installation completes. For instructions, see Managing the certificates.
• Automation Suite on AKS/EKS does not currently support Federal Information Processing Standard 140-2 (FIPS 140-2). If you require FIPS 140-2 for Automation Suite, you can deploy Automation Suite on FIPS 140-2-enabled RHEL machines. For details, see Security and compliance.

Etapa 1: provisionamento dos pré-requisitos da infraestrutura

Antes de instalar o Automation Suite , você deve configurar os recursos de Cloud no seu ambiente. Isso inclui:

• Cluster AKS ou EKS
• Armazenamento de objetos - Azure Blob ou Amazon S3
• Armazenamento de blocos
• Armazenamento de Arquivo
• Banco de Dados
• Cache
• Rede (por exemplo, VNETs/VPC, DNS, sub-redes, NSGs/grupos de segurança, gateway NAT, IP elástico e gateway de internet)
• Certificados
• Políticas de rede

For instructions on prerequisites, see Requirements.

Opcional: configuração do proxy

If you use a proxy server for internet-facing traffic, you must allow a list of URLs and use the no_proxy settings while configuring the proxy. For instructions on how to configure your proxy, see Configuring the proxy.

Etapa 2: download do software em sua máquina cliente

Você deve instalar o seguinte software em sua máquina de gerenciamento. Máquina de gerenciamento refere-se à máquina que você usa para operar seu cluster e que pode acessar seu cluster por meio do arquivo kubeconfig . Sua máquina de gerenciamento pode executar o Linux, Windows ou MacOS.

As seguintes ferramentas são necessárias para executar com êxito as verificações de pré-requisitos, a instalação e as etapas de pós-instalação em seu cluster por meio da máquina cliente.

Ferramenta	Description	Fazer download
uipathctl	Required. uipathctl is a UiPath command-line tool that allows you to run commands against Automation Suite Kubernetes hosted on Azure Kubernetes Service (AKS) and Amazon Elastic Kubernetes Service (EKS). Você pode usar uipathctl para verificar pré-requisitos em seu ambiente, instalar o Automation Suite, configurá-lo e gerenciá-lo a partir de um único CLI unificado. Para obter mais informações, incluindo uma lista completa de operações uipathctl , consulte a.	Download do uipathctl Executar o uipathctl
versions.json	Obrigatório. Necessário para executar verificações pré-requisitos e etapas de instalação.
kubectl	Opcional. Certifique-se de que kubectl corresponda à versão do seu cluster

Etapa 3: configuração do input.json

Você deve editar o arquivo input.json para fornecer as entradas necessárias para o instalador uipathctl e executar operações como configurar as strings de conexão SQL e os serviços UiPath que você gostaria de habilitar.

We provide different input.json template files for AKS and EKS. For instructions on how to configure input.json, see Configuring input.json.

Optionally, you can bring your own components that are part of the Automation Suite stack. For details on the components, see Automation Suite on EKS/AKS stack. For details on how to configure the component you bring, see Bring your own components.

Etapa 4: acessando seu cluster com o uipathctl

Ouipathctl requer acesso ao servidor KubeAPI para executar operações no nível do cluster, como implantação, criação de recursos, etc. Para acessar o servidor do KubeAPI, uipathctl usa o arquivo kubeconfig , que contém as credenciais de nível de administrador necessárias para acessar o cluster. Esse arquivo deve estar presente na pasta ~/.kube/config (local padrão) da sua máquina local (gerenciamento).

Opcionalmente, se você estiver interessado em armazenar o arquivo kubeconfig no local padrão, é possível fornecê-lo com a ajuda do sinalizador --kubeconfig durante cada execução de uipathctl.

Por exemplo, você pode usar seu método preferido para atualizar seu arquivo ~/.kube/config usando o AWS CLI ou o Azure CLI.

Etapa 5: verificação dos pré-requisitos da infraestrutura

As verificações de pré-requisitos garantem que a infraestrutura Cloud necessária seja provisionada adequadamente e esteja acessível pela máquina cliente antes de iniciar a instalação do Automation Suite .

O instalador pode gerar automaticamente as seguintes configurações em seu nome:

• Os bancos de dados SQL necessários para a instalação no servidor SQL, com base se a chave sql.create_db estiver definida no seu arquivo input.json .
• Os buckets de armazenamento de objetos necessários no seu provedor de Cloud se a chave external_object_storage.create_bucket estiver definida no arquivo de configuração.

Para permitir que o instalador gere essas configurações, execute o seguinte comando:

uipathctl prereq create input.json --versions versions.json

Importante:

The uipathctl prereq create command does not create the required SQL databases for Process Mining. You must manually create them by following the instructions in Bring your own database.

Para verificar os pré-requisitos com base nas entradas que você configurou no input.json, execute o seguinte comando:

uipathctl prereq run input.json --versions versions.json

To check the prerequisites for installation, run `` . By default, the command checks all the prerequisites. However, it also allows you to run strictly the checks that are relevant to you:

• Se quiser excluir componentes da execução, use o sinalizador --excluded. Por exemplo, se você não quiser verificar as strings de conexão de banco de dados, execute uipathctl prereq --excluded SQL. O comando executa todas as verificações de pré-requisitos, exceto para a relacionada a SQL.
• Se quiser incluir apenas determinados componentes na execução, use o sinalizador --included. Por exemplo, se você quiser apenas verificar o DNS e o objectstore, execute uipathctl prereq --included DNS,OBJECTSTORAGE.

Observação:

You can find the names of the components you can include or exclude from the prerequisite checks here. In the example, the first word on each outdented line represents the component name. For example: SQL, OBJECTSTORE, DNS, etc.

Importante:

Você pode receber uma mensagem de limitação do AKS, como Aguardado 1.0447523s devido à limitação do lado do cliente, não à prioridade e integridade. Nesse caso, aguarde alguns minutos para que o comando seja concluído totalmente ou tente executá-lo novamente.

For an output result example, see Output example: prerequisite check.

Etapa 6: instalação do Automation Suite

Observação:

To see which deployment scenarios are available for Automation Suite on AKS/AKS, see Deployment scenarios.

1. Após validar com sucesso os pré-requisitos, você pode prosseguir para instalar o Automation Suite executando o seguinte comando:

   uipathctl manifest apply input.json --versions versions.json
   

   For an output example, see Output example: Automation Suite installation.

2. Para executar novamente a instalação, use o mesmo comando da etapa 1, com todos os argumentos e sinalizadores.

3. Para validar se sua instalação foi bem-sucedida e se os serviços estão íntegros, execute o seguinte comando:

   uipathctl health check
   

Observação:

If you run into issues during installation, see Troubleshooting.