Etapa 8: configuração dos discos

Antes de executar uma instalação do Automation Suite, você deve particionar e configurar o disco usando LVM para que seja possível alterar seu tamanho facilmente e sem nenhuma migração ou perda de dados.

Partição dos discos

A estrutura de particionamento padrão em máquinas RHEL não é adequada para instalar o Kubernetes. Isso ocorre porque a infraestrutura do Kubernetes geralmente é instalada na partição /var, que recebe apenas 8 GB de espaço por padrão.

Observação:

• O formato aceito para os discos é ext4 ou xfs.
• Você deve criar todas as partições usando LVM para garantir que os dados do cluster possam residir em um disco diferente, mas ainda sejam exibidos de forma coerente. Isso também ajuda a estender o tamanho da partição no futuro sem o risco de migração 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 GB. Também recomendamos configurar logrotate para rodar os logs em um intervalo que varia de diário a semanal.

Os requisitos de disco para instalações online e offline são os mesmos, exceto pelo espaço extra necessário para descompactar o pacote UiPath® offline.

Para o sistema operacional RHEL, certifique-se de ter os seguintes tamanhos mínimos de pontos de montagem na máquina.

Rótulo do disco	Servidor	Agente	Partição	Tamanho	Finalidade
Disco do cluster	✅	✅	/var/lib/rancher	190 GB	Armazena as imagens e camadas do contêiner.
			/var/lib/kubelet	56 GB	Armazena configurações do Kubernetes em runtime, como segredos, configmaps e emptyDir.
			/opt/UiPathAutomationSuite	10 GB	Armazena o binário do instalador.
Disco do etcd	✅	❌	/var/lib/rancher/rke2/server/db	16 GB	Armazena o banco de dados distribuído para o Kubernetes
Armazenamento de blocos	✅	❌	/datadisk/insights	15 GB	Obrigatório para o Insights.
			/datadisk/monitoring	50 GB	Necessário para as ferramentas de monitoramento.
			/datadisk/registry 1	200 GB	Obrigatório para o registro do Docker.
			/datadisk/objectstore 2	10 GB	Obrigatório para ceph-mon.
Objectstore 2	✅	❌	N/A	512 GB	Obrigatório para objectstore no cluster.
AI Center3	✅	✅	N/A	51 GB no mínimo e 105 GB recomendados para 1 pipeline de treinamento.	Necessário apenas se você instalar o AI Center.
Disco do pacote UiPath®	✅	❌	/uipath	512 GB	Necessário apenas para instalações offline para armazenar o pacote offline

¹ Isso se refere ao registro do Docker no cluster e não é aplicável se você usar um registro externo.

² Isso se refere ao objectstore no cluster e não é aplicável se você usar um objectstore externo.

³ Isso se refere ao armazenamento necessário para o pipeline de treinamento do AI Center. O disco é necessário apenas nas máquinas nas quais você planeja executar o pipeline de treinamento do AI Center e no nó dedicado do Task Mining. Recomendamos conectar esse disco nas máquinas de agentes.

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.

Como usar o script para configurar os discos

Como baixar o script

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

Para obter instruções de download, consulte configureUiPathDisks.sh.

Execução do script

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

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

Para tornar o script executável, execute o seguinte comando:

chmod +x ./configureUiPathDisks.sh

Para fornecer as permissões necessárias para o script, execute o seguinte comando:

chmod +x configureUiPathDisks.sh

Para obter mais detalhes sobre o uso do script, execute o seguinte comando:

sudo ./configureUiPathDisks.sh --help

Como configurar o disco do cluster em todas as máquinas

Para configurar o disco do cluster, execute o seguinte comando em todas as máquinas:

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk

Como configurar o disco etcd em todas as máquinas do servidor

Para configurar o disco etcd, execute o seguinte comando em todas as máquinas do servidor:

./configureUiPathDisks.sh --etcd-disk-name name_of_etcd_disk

Importante:

A configuração do disco etcd deve ser executada apenas após concluir a configuração do disco do cluster.
A ordem de configuração deve ser preservada, porque o disco etcd é montado dentro do disco do cluster.
Se esta etapa for executada antes de configurar o disco do cluster, ela poderá levar à perda de dados após uma reinicialização da máquina, pois o kernel monta automaticamente os discos em sequência, primeiro o disco do cluster e depois o disco etcd.

Como configurar o disco de dados em todas as máquinas do servidor

Para configurar o disco de dados, você deve identificar o disco específico a ser usado. Execute o comando lsblk para listar todos os dispositivos de bloco, seus tamanhos e pontos de montagem. Use o tamanho do disco para identificar o disco relevante (para o sinalizador --volume , o disco de dados de 512 GB deve ser usado).

Execute o seguinte comando em todas as máquinas do servidor e forneça os sinalizadores necessários com base em seus requisitos:

./configureUiPathDisks.sh --volume name_of_data_disk

Bandeira	Valor
-v	--volume
--docker-registry	Opcional. Necessário apenas se o registro externo não estiver disponível.
--monitoring	Opcional.Se o sinalizador não for passado durante a primeira execução, ele criará automaticamente a partição para monitoramento (armazenamento do Prometheus). No entanto, o sinalizador é necessário na execução subsequente, durante o redimensionamento da partição de monitoramento juntamente com o sinalizador --resize.
--objectstore	Opcional. Necessário apenas se o objectstore externo não estiver disponível.
--insights	Opcional. Se o sinalizador não for passado durante a primeira execução, ele criará automaticamente a partição para o Insights. No entanto, é necessário na execução subsequente, durante o redimensionamento da partição do Insights juntamente com o sinalizador --resize.
--resize <int>	Opcional. Se o valor inteiro for fornecido, o componente selecionado será redimensionado, desde que haja espaço suficiente disponível. Caso contrário, todo o disco é consumido para expandir a partição selecionada. É obrigatório indicar exatamente uma partição que deve ser redimensionada.
--robot-package-cache	Caminho para o local no nó do Automation Suite Robots para baixar o pacote para o cache. Isso deve ser executado apenas no nó do Automation Suite Robots.

Você também pode usar o comando para redimensionar a partição selecionada com a ajuda do sinalizador --resize , conforme mostrado no exemplo a seguir:

./configureUiPathDisks.sh --volume /dev/sde --docker-registry --resize 300

O exemplo mostra como anexar o disco /dev/sde ao disco de dados existente e como redimensionar a partição de registro do Docker para 300 GB.

Como configurar o disco do objectstore em todas as máquinas do servidor

Esta etapa só é necessária se o objectstore externo não estiver disponível.

Você pode adicionar ou expandir seu tamanho de armazenamento para o objectstore no cluster executando o seguinte script em todos os nós do servidor:

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

Observação:

• Um problema conhecido do Azure marca incorretamente o disco do Azure como não SSD. Se o Azure for seu provedor de nuvem e você quiser configurar o disco do Objectstore, siga as instruções em Solução de problemas.
• 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.

Configuração do disco do AI Center em máquinas selecionadas

Para configurar o disco do AI Center, execute o seguinte comando nas máquinas em que você planeja executar os pipelines de treinamento:

./configureUiPathDisks.sh --aicenter-disk-name name_of_aicenter_disk_to_partition

Para estender o armazenamento do AI Center:

• Se você quiser adicionar um novo disco do AI Center, execute o seguinte comando na máquina em que você planeja adicionar o disco:

  ./configureUiPathDisks.sh --aicenter-storage-extend name_of_new_aicenter_disk_to_attach
  

• Se você tiver expandido o disco existente do AI Center, execute o seguinte comando na máquina em que o disco subjacente do AI Center é expandido:

  ./configureUiPathDisks.sh --aicenter-storage-extend
  

Configuração do disco de hospedagem para o cache do pacote do Automation Suite UiPath Robot

Essa etapa é necessária para configurações de nó único sem um agente dedicado do Automation Suite UiPath Robot.

Para hospedar o cache do pacote do Automation Suite UiPath Robot no nó do servidor, você precisa criar um disco de pelo menos 10 GB:

./configureUiPathDisks.sh --volume name_of_data_disk --robot-package-cache

Observação:

É recomendável que seja feito backup do disco pelo LVM.

Configurando o disco do pacote no primeiro nó do servidor para o registro no cluster

Essa etapa é necessária nos seguintes cenários:

• Ao executar uma instalação offline (isolada);
• Quando um registro externo não estiver disponível.

Para configurar o disco do pacote, execute o comando a seguir apenas no primeiro nó do servidor:

./configureUiPathDisks.sh --bundle-disk-name name_of_bundle_disk

Como validar montagens no disco

Observação:

Certifique-se de adicionar todos os pontos de montagem ao arquivo fstab e de incluir a opção nofail nessas entradas fstab para que não afete a inicialização da VM em caso de falha.

Para validar se /etc/fstab está configurado corretamente e pode lidar com uma reinicialização do sistema, siga as seguintes etapas, execute o seguinte comando:

mount -afv

Você deve obter a seguinte saída:

# Servers
/datadisk/monitoring              : already mounted
/datadisk/insights                : already mounted
/var/lib/rancher/rke2/server/db   : already mounted

# Servers or agents
/opt/UiPathAutomationSuite        : already mounted
/var/lib/rancher                  : already mounted
/var/lib/kubelet                  : already mounted

# In case of an offline environment, only on the primary server node
/uipath                           : already mounted

# Additional mount point is require if customer is installing offline with internal registry
/datadisk/registry                : already mounted

# Additional mount point is require if customer is using in-cluster objectstore
/datadisk/objectstore             : already mounted