Configuração das máquinas

Como configurar o disco

Importante:

• Para evitar a perda de dados, certifique-se de que a infraestrutura que você usa não exclua automaticamente discos de clusters na reinicialização ou desligamento do cluster. Se essa capacidade estiver habilitada, certifique-se desabilitá-la.
• To ensure a smooth and uninterrupted SSH session, we strongly recommend that you follow the steps in Installation best practices before configuring the disks and installing Automation Suite.

Você pode configurar e particionar os discos usando o script configureUiPathDisks.sh . Para obter detalhes, consulte as seções a seguir.

Requisitos do disco

Antes da instalação, você deve particionar e configurar o disco usando o LVM, para que seu tamanho possa ser alterado facilmente e sem nenhuma migração de dados ou perda de dados.

Particionamento do disco

A estrutura de particionamento padrão em máquinas RHEL não é adequada para a instalação do Kubernetes. Isso ocorre porque a infraestrutura do Kubernetes geralmente é instalada na partição /var. Por padrão, a partição var é alocada apenas 8 GiB de espaço.

Observação:

• O formato aceito para o disco é ext4 ou xfs.
• Todas as partições devem ser criadas usando o LVM. Isso é para garantir que os dados do cluster possam residir em um disco diferente, mas ainda possam ser exibidos de forma coerente. Isso também ajuda a estender o tamanho da partição no futuro sem o risco de migração de dados ou perda de dados.
• Todos os pods e registros de aplicativos são armazenados no diretório /var/log/pods. Certifique-se de que a capacidade deste diretório seja de pelo menos 8 GiB. Também recomendamos configurar logrotate para rodar os logs em um intervalo que varia de diário a semanal.

Para o sistema operacional RHEL, você precisa garantir que tenha os seguintes tamanhos mínimos de pontos de montagem na máquina.

Online

Rótulo do disco	Partição	Tamanho	Finalidade
Disco do cluster	/var/lib/rancher	190 GiB	A pasta Rancher armazena imagens e camadas de contêineres
	/var/lib/kubelet	56 GiB	A pasta Kubelet armazena configurações do Kubernetes em runtime, como segredos, configmaps e emptyDir
	/opt/UiPathAutomationSuite	20 GiB	Binário do instalador
Disco do etcd	/var/lib/rancher/rke2/server/db	16 GiB	Banco de dados distribuído para Kubernetes
Armazenamento de blocos	/datadisk	512 GiB	Abstração de armazenamento em bloco
Objectstore1	N/A	512 GiB	Objectstore no cluster

¹ This refers to the in-cluster objectstore and is not applicable if you use external objectstore.

Observação:

Recomendamos que você não use o disco do OS para qualquer um dos propósitos acima, para garantir que os processos recebam sua quota devida de recursos.

Offline

Observação:

Os requisitos para offline são os mesmos que para online, exceto para a máquina em que você executa a instalação pela primeira vez, que precisa dos seguintes requisitos.

O espaço extra é necessário para descompactar o pacote offline.

Rótulo do disco	Partição	Tamanho	Finalidade
Disco do cluster	/var/lib/rancher	190 GiB	A pasta Rancher armazena imagens e camadas de contêineres
	/var/lib/kubelet	56 GiB	A pasta Kubelet armazena configurações do Kubernetes em runtime, como segredos, configmaps e emptyDir
	/opt/UiPathAutomationSuite	20 GiB	Binário do instalador
Disco do etcd	/var/lib/rancher/rke2/server/db	16 GiB	Banco de dados distribuído para Kubernetes
Armazenamento de blocos	/datadisk	512 GiB	Abstração de armazenamento em bloco
Objectstore1	N/A	512 GiB	Objectstore no cluster
UiPath Bundle Disk	/uipath	512 GiB	Pacote isolado

¹ This refers to the in-cluster objectstore and is not applicable if you use external objectstore.

Observação:

Recomendamos que você não use o disco do OS para qualquer um dos propósitos acima, para garantir que os processos recebam sua quota devida de recursos.

Observação:

Os discos de dados e do etcd devem ser discos físicos separados. Isso isola fisicamente os discos de dados e do etcd de outras atividades e cargas de trabalho do cluster, ao mesmo tempo em que aprimora o desempenho e a estabilidade do cluster.

Consulte a seção a seguir para obter detalhes sobre como usar o script de exemplo para particionar e configurar o disco antes da instalação.

Como usar o script para configurar o disco

Como baixar o script

Observação:

Para instalações offline, você deve realizar esta etapa em uma máquina com acesso à Internet e às máquinas isoladas nas quais o Automation Suite está implantado. Copie o arquivo da máquina online para a primeira máquina de destino.

Você pode usar o script configureUiPathDisks.sh para configurar e particionar o disco.

For download instructions, see configureUiPathDisks.sh.

Execução do script

Você pode usar o script configureUiPathDisks.sh para os seguintes propósitos:

• configurar os discos e pontos de montagem para uma nova instalação de cluster do Automation Suite;
• redimensionar o disco de dados após a instalação.

Para tornar o script executável, execute:

chmod +x ./configureUiPathDisks.sh

Para mais detalhes sobre o uso do script, execute:

sudo ./configureUiPathDisks.sh --help
***************************************************************************************
Utility to configure the disk for UiPath Automation Suite Installation.
Run this script to configure the disks on new machine or to extend the size of datadisk
Arguments
  -n|--node-type                  NodeType, Possible values: agent, server. Default to server.
  -i|--install-type               Installation mode, Possible values: online, offline. Default to online.
  -c|--cluster-disk-name          Device to host rancher and  kubelet. Ex: /dev/sdb.
  -e|--etcd-disk-name             Device to host etcd, Not required for agent node. Ex: /dev/sdb.
  -R|--ceph-raw-disk-name         Device to host ceph OSD, Not required for agent node. Ex: /dev/sdm
  -l|--data-disk-name             Device to host datadisk, Not required for agent node. Ex: /dev/sdc.
  -b|--bundle-disk-name           Device to host the uipath bundle.
                                    Only required for offline installation on 1st server node.
  -k|--robot-package-disk-name    Device to host robot package cache folder
                                    Only required for Automation Suite Robots dedicated node when 'packagecaching' is enabled
  -P|--robot-package-path         Path to robot package cache folder
                                    (defaults to '/uipath_asrobots_package_cache' if not set)
  -f|--complete-suite             Installing complete product suite or any of these products:
                                    aicenter, apps, taskmining, documentunderstanding.
                                    This will configure the datadisk volume to be 2TiB instead of 512Gi.
  -p|--primary-server             Is this machine is first server machine? Applicable only for airgap install.
                                    This is the machine on which UiPath AutomationSuite bundle will be installed.
                                    Default to false.
  -x|--extend-data-disk           Extend the datadisk. Either attach new disk or resize the exiting datadisk.
  -r|--resize                     Used in conjunction of with --extend-data-disk to resize the exiting volume,
                                    instead of adding new volume.
  -d|--debug                      Run in debug.
  -h|--help                       Display help.
ExampleUsage:
  configureUiPathDisks.sh --node-type server --install-type online \
    --cluster-disk-name /dev/sdb --etcd-disk-name /dev/sdc \
    --data-disk-name /dev/sdd
  configureUiPathDisks.sh --data-disk-name /dev/sdh \
    --extend-data-disk
***************************************************************************************

Como configurar o disco para uma configuração de produção pronta para alta disponibilidade de vários nós

Online

Nós de servidor

Para configurar o disco em uma configuração online de produção pronta para alta disponibilidade de vários nós, execute o seguinte comando em todas as máquinas do servidor:

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
  --etcd-disk-name name_of_etcd_disk \
  --data-disk-name name_of_data_disk

Nós de agente

Para configurar o disco em uma configuração online de produção pronta para alta disponibilidade de vários nós, execute o seguinte comando em todas as máquinas de agente:

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
  --node-type agent

Offline

Primeiro nó do servidor

Em uma instalação offline, você precisa carregar as imagens do produto no registro do docker. Para isso, é necessário armazenamento adicional na forma de um disco separado. Esse disco será usado para descompactar pacotes de produtos e carregar imagens no registro do Docker. É necessário estar presente apenas em uma máquina.

Defina o sinalizador --primary-server em uma das primeiras máquinas do servidor ou na máquina na qual o instalador do Fabric e de serviço será executado.

Para configurar o disco em uma configuração offline de produção pronta para alta disponibilidade de vários nós, execute o seguinte comando em uma das outras máquinas do servidor:

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
  --etcd-disk-name name_of_etcd_disk \
  --data-disk-name name_of_data_disk \
  --bundle-disk-name name_of_uipath_bundle_disk \
  --primary-server \
  --install-type offline

Nós adicionais do servidor

Nos nós de servidor, você não precisa do disco do pacote. Portanto, você não precisa fornecer o --primary-server e --bundle-disk-name.

Para configurar o disco em uma configuração offline de produção pronta para alta disponibilidade de vários nós, execute o seguinte comando nas outras máquinas do servidor:

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
  --etcd-disk-name name_of_etcd_disk \
  --data-disk-name name_of_data_disk \
  --install-type offline

Nós de agente

Nos nós de servidor, você não precisa do disco do pacote. Portanto, você não precisa fornecer o --primary-server e --bundle-disk-name.

Para configurar o disco em uma configuração offline de produção pronta para alta disponibilidade de vários nós, execute o seguinte comando nas outras máquinas de agente.

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
  --node-type agent \
  --install-type offline

Como configurar o disco do Objectstore

Você pode expandir o tamanho do armazenamento para o objectstore no cluster executando o seguinte script:

./configureUiPathDisks.sh --ceph-raw-disk-name name_ceph_raw_disk

Observação:

• An Azure known issue incorrectly marks the Azure disk as non-SSD. If Azure is your cloud provider, and you want to configure the Objectstore disk, follow the instructions in Troubleshooting.
• A escalabilidade vertical dos discos existentes não é suportada. Para aumentar o tamanho do seu armazenamento no cluster pós-instalação, adicione novos discos raw.

Como estender a pós-instalação do disco de dados

Para estender o disco de dados, você pode anexar o novo disco físico ou redimensionar o disco existente.

Como adicionar um novo disco

Para estender o disco de dados usando o disco recém-anexado, execute o seguinte comando nas máquinas servidoras:

./configureUiPathDisks.sh --data-disk-name name_of_data_disk \
  --extend-data-disk

Como redimensionar o disco existente

Para estender o disco de dados redimensionando o disco existente, execute o seguinte comando nas máquinas do servidor:

./configureUiPathDisks.sh --extend-data-disk --resize

Como validar montagens no disco

1. Realize as etapas a seguir para validar se /etc/fstab está configurado corretamente para lidar com a reinicialização do sistema.

   Observação:

   Certifique-se de que os pontos de montagem do disco do etcd e de dados sejam adicionados no arquivo fstab.

   Se você tiver uma partição de disco separada para /var/lib/rancher e /var/lib/kubelet, então fstab também deve conter essas duas pastas. Certifique-se também de incluir a opção nofail nessas entradas fstab para que não afete a inicialização da VM em caso de falhas.

2. Valide se os discos estão montados corretamente executando o seguinte comando:

   mount -afv
   

3. Você deve obter a seguinte resposta:

   /datadisk                              : already mounted
   /var/lib/rancher/rke2/server/db        : already mounted
   /var/lib/rancher                       : already mounted
   /var/lib/kubelet                       : already mounted
   

Configuring kernel and OS level settings

A página a seguir ajuda os administradores do Linux no gerenciamento de configurações no nível do sistema operacional e do kernel antes de realizar uma instalação do Automation Suite.

Normalmente, essas configurações são gerenciadas por meio de uma ferramenta de configuração de gerenciamento dedicada, como o Puppet. Certifique-se de que as alterações que você faz estejam de acordo com o processo de controle de seu ambiente para fins de consistência e documentação.

Importante:

Certifique-se de concluir as seguintes etapas antes de iniciar a instalação, pois configurações incorretas no nível do sistema operacional e do kernel podem levar a erros não intuitivos. A verificação dessas configurações específicas muitas vezes pode evitar esses erros.

Ajuste das configurações do sysctl

As seguintes configurações sysctl são necessárias na máquina:

• Habilitar Encaminhamento de IP
• desativação da filtragem de caminho reverso

Você pode fazer isso executando o seguinte comando:

cat <<EOF >>"/etc/sysctl.d/99-sysctl.conf"
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.conf.all.rp_filter=0
EOF

Observação:

O nf-call-iptables é necessário para a maioria das implantações do Kubernetes. O Kubernetes cria redes virtuais internas para o cluster. Isso permite que cada pod tenha seu próprio endereço IP, que é usado em conjunto com os serviços de nome internos para facilitar a comunicação de serviço a serviço. O cluster não funciona sem o nf-call-iptables habilitado. Para obter detalhes, consulte a documentação oficial do Kubernetes.

Para aplicar as configurações, execute o seguinte comando:

sysctl --system

Configuração de ajustes de fapolicy

Importante:

Essa etapa é opcional e se aplica apenas se você usar fapolicy. Nesse caso, é necessária uma política específica do RKE2.

Para gerar a política RKE2, use o seguinte comando:

cat <<-EOF >>"/etc/fapolicyd/rules.d/69-rke2.rules"
allow perm=any all : dir=/var/lib/rancher/
allow perm=any all : dir=/opt/cni/
allow perm=any all : dir=/run/k3s/
allow perm=any all : dir=/var/lib/kubelet/
allow perm=any all : dir=/root/.local/share/helm
EOF

Observação:

Certifique-se de que a alteração seja comunicada à sua equipe do Linux e passe pelos processos de gerenciamento de configuração apropriados.

Configuração dos ajustes de noexec e nosuid

Os discos usados para a montagem /var não devem ter noexec ou nosuid definidos. A ferramenta de disco cria automaticamente essas montagens sem essas propriedades.

Importante:

Se um administrador do Linux definir manualmente essas propriedades, a instância torna-se não funcional.

For more details on disk configuration, see Disk requirements.

Como habilitar portas

Certifique-se de ter as seguintes portas habilitadas em seu firewall para cada origem.

Porta	Protocol	Origem	Finalidade	Requisitos
22	TCP	Jump Server/máquina cliente	Para SSH (instalação, depuração de gerenciamento de cluster)	Não abra esta porta para a internet. Permita o acesso à máquina cliente ou ao jump server.
80	TCP		Apenas instalação offline: necessário para enviar notificações de email do sistema.
443	TCP	Todos os nós em um cluster + balanceador de carga	Para HTTPS (acessando o Automation Suite)	Essa porta deve ter conectividade de entrada e saída de todos os nós do cluster e do balanceador de carga.
587	TCP		Apenas instalação offline: necessário para enviar notificações de email do sistema.
2379	TCP	Todos os nós em um cluster	Porta do cliente do etcd	Não deve expor à internet. O acesso entre os nós deve ser suficiente em um endereço IP privado.
2380	TCP	Todos os nós em um cluster	Porta do par do etcd	Não deve expor à internet. O acesso entre os nós deve ser suficiente em um endereço IP privado.
6443	TCP	Todos os nós em um cluster	Para acessar a API do Kube usando HTTPS, e obrigatório para associação de nó	Essa porta deve ter conectividade de entrada e saída de todos os nós do cluster.
8472	UDP	Todos os nós em um cluster	Necessário para Cilium.	Não deve expor à internet. O acesso entre os nós deve ser suficiente em um endereço IP privado.
9090	TCP	Todos os nós no cluster	Usado pelo Cilium para monitorar e lidar com falhas de pod.	Essa porta deve ter conectividade de entrada e saída de todos os nós do cluster.
9345	TCP	Todos os nós em um cluster + balanceador de carga	Para acessar a API do Kube usando HTTPS, necessário para associação de nó	Essa porta deve ter conectividade de entrada e saída de todos os nós do cluster e do balanceador de carga.
10250	TCP	Todos os nós em um cluster	kubelet / servidor de métricas	Não deve expor à internet. O acesso entre os nós deve ser suficiente em um endereço IP privado.
30071	TCP	Todos os nós em um cluster	A porta NodePort para comunicação interna entre nós em um cluster	Não deve expor à internet. O acesso entre os nós deve ser suficiente em um endereço IP privado.

Importante:

Expor a porta 6443 fora do limite do cluster é obrigatório se houver uma conexão direta com a API do Kerberos.

A porta 9345 é usada pelos nós para descobrir nós existentes e ingressar no cluster na implantação de vários nós. Para manter os mecanismos de descoberta de alta disponibilidade em funcionamento, recomendamos expô-los por meio do balanceador de carga com verificação de integridade.

Certifique-se também de ter conectividade de todos os nós com o SQL Server.

Não exponha o SQL Server em uma das portas reservadas do Istio, pois isso pode causar falhas de conexão.

Se você tiver um firewall configurado na rede, certifique-se de que ele tenha essas portas abertas e permita o tráfego de acordo com os requisitos mencionados acima.

Installing the required RPM packages

Para instalar e validar os pacotes RPM necessários, você pode usar qualquer uma das seguintes ferramentas

• the install-uipath.sh manual installer. In online environments, it installs and validates all RPM packages by default.
• o instalador interativo installUiPathAS.sh . Ele valida todos os pacotes RPM por meio do instalador install-uipath.sh .
• the validateUiPathASReadiness.sh script:
  • para validar os pacotes RPM, execute: validateUiPathASReadiness.sh validate-packages;
  • para instalar os pacotes RPM em uma instalação online, execute: validateUiPathASReadiness.sh install-packages;
  • para instalar os pacotes RPM em uma instalação off-line, execute: validateUiPathASReadiness.sh install-packages --install-type offline.

For a list of RPM package requirements, see Hardware and software requirements.

Opcional: configuração do servidor proxy

To configure a proxy, you need to perform additional configuration steps while setting up your environment with the prerequisites and during the advanced configuration phase of installation time.

As etapas a seguir são obrigatórias ao configurar o ambiente.

Observação:

Atualmente, não aceitamos o proxy HTTPS com certificados autoassinados. Certifique-se de usar um certificado público confiável se estiver configurando o proxy.

Etapa 1: habilitação de portas na rede virtual

Certifique-se de ter as seguintes regras habilitadas em seu grupo de segurança de rede para a rede virtual fornecida.

Origem	Destino	Rota por proxy	Porta	Description
Rede Virtual	Sql	Não	Porta do SQL Server	Obrigatório para o SQL Server.
Rede Virtual	Load balancer	Não	9345 6443	Obrigatório para adicionar novos nós ao cluster.
Rede Virtual	Cluster(sub-rede)	Não	Todas as portas	Obrigatório para comunicação em um intervalo de IP privado.
Rede Virtual	alm.<fqdn>	Não	443	Obrigatório para login e uso do cliente do ArgoCD durante a implantação.
Rede Virtual	Servidor de Proxy	Sim	Todas as portas	Obrigatório para rotear o tráfego para o servidor proxy.
Rede Virtual	NameServer	Não	Todas as portas	A maioria dos serviços de nuvem, como o Azure e o AWS, usa isso para buscar os metadados da VM e considera isso um IP privado.
Rede Virtual	MetaDataServer	Não	Todas as portas	A maioria dos serviços em nuvem, como o Azure e o AWS, usa o endereço IP 169.254.169.254 para buscar metadados da máquina.

Etapa 2: adição da configuração de proxy a cada nó

Ao configurar os nós, você precisa adicionar a configuração de proxy a cada nó que faz parte do cluster. Esta etapa é obrigatória para rotear o tráfego de saída do nó por meio do servidor proxy.

1. Adicione a seguinte configuração em /etc/environment:

   http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server>
   

2. Adicione a seguinte configuração em /etc/wgetrc:

   http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server>
   

   Parâmetros obrigatórios	Description
   http_proxy	Usado para rotear solicitações de saída HTTP a partir do nó. Este deve ser o FQDN e a porta do servidor proxy.
   https_proxy	Usado para rotear solicitações de saída HTTPS a partir do nó. Este deve ser o FQDN e a porta do servidor proxy.
   no_proxy	Lista de hosts separados por vírgulas, endereços IP que você não deseja rotear por meio do servidor proxy. Este deve ser um intervalo de sub-rede privada, host do servidor SQL, endereço do servidor nomeado, endereço do servidor de metadados: alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>. metadata server address – A maioria dos serviços em nuvem, como o Azure e a AWS, faz uso do endereço IP 169.254.169.254 para buscar metadados de máquina. named server address – A maioria dos serviços em nuvem, como o Azure e a AWS, faz uso disso para resolver consultas DNS. Se você usar o AI Center com um Orchestrator externo, deve adicionar o domínio externo do Orchestrator à lista no_proxy.

3. Verifique se as configurações de proxy estão definidas corretamente executando o seguinte comando:

   curl -v $HTTP_PROXY
   curl -v <fixed_rke_address>:9345
   

   Importante:

   Once you meet the proxy server requirements, make sure to continue with the proxy configuration during installation. Follow the steps in Optional: Configuring the proxy server to ensure the proxy server is set up properly.