Étape 8 : configuration des disques

Référence pour le partitionnement de disque et la configuration LVM requise avant l'installation d'Automation Suite.

Avant d'effectuer une installation d'Automation Suite, vous devez partitionner et configurer le disque à l'aide de LVM, afin de pouvoir modifier sa taille facilement et sans aucune migration ou perte de données.

Partitionner les disques

La structure de partitionnement par défaut sur les machines RHEL n'est pas adaptée à l'installation de Kubernetes. En effet, l'infrastructure Kubernetes est généralement installée sous la partition /var, qui ne se voit allouer que 8 Go d'espace par défaut.

Remarque :

• Le format pris en charge pour les disques est ext4 ou xfs.
• Vous devez créer toutes les partitions à l'aide de LVM pour vous assurer que les données du cluster peuvent résider sur un disque différent mais toujours être visualisées de manière cohérente. Cela permet également d'étendre la taille de la partition à l'avenir sans risque de migration ou de perte de données.
• Tous les pods et les journaux d'application sont stockés dans le répertoire /var/log/pods . Assurez-vous que la capacité de ce répertoire est d'au moins 8 Go. Nous vous recommandons également de configurer logrotate de façon à effectuer une rotation des journaux à un intervalle situé entre un jour et une semaine.
• Si vous utilisez une configuration RKE2 à nœud unique avec stockage dans le cluster, il est obligatoire de fournir au moins 512 Go supplémentaires d’espace disque pour le stockage des sauvegardes de données Ceph. Ce disque est requis lors de l’installation, mais le CronJob de sauvegarde qui l’utilise doit être configuré après l’installation complète du cluster. Pour de plus amples informations, consultez la section Effectuer des opérations post-installation.

Les prérequis de disque sont les mêmes pour les installations en ligne et hors ligne, à l’exception de l’espace supplémentaire nécessaire pour décompresser le bundle UiPath® hors ligne.

Pour le système d'exploitation RHEL, assurez-vous que vous disposez des tailles de point de montage minimales suivantes sur la machine.

Libellé du disque	Server	Agent (Agent)	Partition	Taille	Objectif
Disque de cluster Si vous activez les projets modernes Document Understanding, la taille minimale est de 400 Go.	✅	✅	/var/lib/rancher	190 Go 334 Go minimum lorsque les projets modernes Document Understanding sont activés	Stocke les images et les couches du conteneur.
			/var/lib/kubelet	56 Go	Stocke les configurations Kubernetes de runtimes telles que les clés secrètes, les configmaps et emptyDir.
			/opt/UiPathAutomationSuite	10 GB	Stocke le fichier binaire du programme d'installation.
disque etcd	✅	❌	/var/lib/rancher/rke2/server/db	16 Go	Stocke la base de données distribuée pour Kubernetes
DataDisk	✅	❌	/datadisk/insights	15 Go	Obligatoire pour Insights.
			/datadisk/monitoring	50 Go	Obligatoire pour les outils de surveillance.
			/datadisk/registry 1	200 Go	Requis pour le registre Docker.
			/datadisk/objectstore 2	10 GB	Obligatoire pour ceph-mon.
Magasin d'objets  2	✅	❌	S/O	512 GB	Obligatoire pour le magasin d’objets intégré au cluster.
AI Center3	✅	✅	S/O	51 Go minimum et 105 Go recommandés pour 1 pipeline d'entraînement.	Obligatoire uniquement si vous installez AI Center.
Disque de bundle UiPath®	✅	❌	/uipath	512 GB	Requis uniquement pour les installations hors ligne afin de stocker le bundle hors ligne
Sauvegarde Ceph	✅	❌	/backup	512 GB	Requis uniquement pour la configuration RKE2 à nœud unique avec stockage intégré au cluster, pour stocker les sauvegardes de données Ceph.

¹ Cela fait référence au registre Docker intégré au cluster et ne s'applique pas si vous utilisez un registre externe.

² Cela fait référence au magasin d'objets intégré au cluster et ne s'applique pas si vous utilisez un magasin d'objets externe.

³ Cela fait référence au stockage requis par le pipeline d’entraînement AI Center. Le disque est requis uniquement sur les machines sur lesquelles vous prévoyez d'exécuter le pipeline d'entraînement AI Center. Nous vous recommandons d’associer ce disque aux machines agent.

Remarque :

Nous vous recommandons de ne pas utiliser le disque du système d’exploitation pour les finalités détaillées ci-dessus, afin de vous assurer que les processus obtiennent leur juste partage de ressources.

Utilisation de uipathctl pour configurer les disques

Nous vous recommandons d'utiliser uipathctl pour configurer les disques. Les exemples suivants utilisent uipathctl, mais vous pouvez utiliser vos propres outils à la place.

Téléchargement de uipathctl

uipathctl fait partie du package d’installation as-installer.zip . Pour utiliser uipathctl, procédez comme suit :

1. Téléchargez as-installer.zip et enregistrez-le dans un emplacement temporaire. Pour obtenir des instructions de téléchargement, consultez as-installer.zip.

2. Extrayez le contenu en exécutant la commande suivante :

   unzip as-installer.zip -d installer
   

Pour plus de détails sur l'utilisation de uipathctl pour configurer les disques, exécutez la commande suivante :

./bin/uipathctl rke2 disk --help

Configuration du disque de cluster sur toutes les machines

Pour identifier le disque correct, exécutez lsblk pour répertorier tous les périphériques de bloc et leurs tailles, puis comparez la sortie avec les tailles de disques de cluster dans la table des exigences matérielles. Le disque doit être suffisamment volumineux pour pouvoir prendre en charge les trois points de montage répertoriés dans le tableau.

Pour configurer le disque de cluster, exécutez la commande suivante sur toutes les machines :

./bin/uipathctl rke2 disk --cluster-disk-name <name_of_cluster_disk>

Configuration du disque etcd sur toutes les machines serveur

Pour configurer le disque etcd, exécutez la commande suivante sur toutes les machines serveur :

./bin/uipathctl rke2 disk --etcd-disk-name name_of_etcd_disk

Important :

La configuration du disque etcd ne doit être effectuée qu’après avoir terminé la configuration du disque de cluster.

L'ordre de configuration doit être conservé, car le disque etcd est monté à l'intérieur du disque de cluster.

Si cette étape est exécutée avant de configurer le disque de cluster, cela peut entraîner une perte de données après le redémarrage d'une machine, car le noyau monte automatiquement les disques en séquence, d'abord le disque de cluster, puis le disque etcd.

Configuration du disque de données sur toutes les machines serveur

Pour configurer le disque de données, vous devez identifier le disque spécifique à utiliser. Exécutez la commande lsblk pour répertorier tous les périphériques de bloc, leurs tailles et leurs points de montage. Utilisez la taille du disque pour identifier le disque concerné (pour l'indicateur --volume , le disque de données de 512 Go doit être utilisé).

Exécutez la commande suivante sur toutes les machines serveur et fournissez les indicateurs nécessaires en fonction de vos besoins :

./bin/uipathctl rke2 disk --volume name_of_data_disk

Drapeau	Valeur (Value)
-v|--volume	Exemple de nom de disque : /dev/sde Vous avez besoin du nom du disque lors du partitionnement des disques qui hébergent les différents montages pour la surveillance, Insights, le magasin d'objets et le registre. Il est obligatoire d'indiquer le nom du disque lors de la première configuration du disque. S'il n'est pas fourni lors de l'exécution suivante, tout disque existant associé à uipathdatavg est utilisé pour créer la partition du composant sélectionné.
--docker-registry	Facultatif. Obligatoire uniquement si le registre externe n'est pas disponible.
--monitoring	Indicateur facultatif. La partition de surveillance (Stockage Prometheus) est obligatoire, elle est donc automatiquement créée même si l'indicateur n'est pas spécifiquement transmis lors de la première exécution. Cependant, l’indicateur est requis lors de l’exécution suivante, lors du redimensionnement de la partition de surveillance avec l’indicateur --size.
--objectstore	Indicateur facultatif. Obligatoire uniquement si le magasin d'objets externe n'est pas disponible. Lorsqu'il est utilisé, il crée également la partition datadisk requise pour ceph-mon. Pour plus de détails, consultez la section Partitionner les disques.
--insights	Indicateur facultatif. La partition Insights est automatiquement créée même si l'indicateur n'est pas spécifiquement transmis lors de la première exécution. La configuration du stockage d'Insights est requise lors de l'installation de l'infrastructure pour vous permettre d'activer la post-installation d'Insights. Cependant, l'indicateur est requis lors de l'exécution suivante, lors du redimensionnement de la partition Insights avec l'indicateur --size.
--size <int>	Facultatif. Si la valeur entière est fournie, le composant sélectionné est redimensionné, à condition que suffisamment d'espace soit disponible. Sinon, tout le disque est utilisé pour développer la partition sélectionnée. Il est obligatoire d'indiquer précisément une partition qui doit être redimensionnée. L'option --size n'est pas requise lors de la configuration du disque. Il peut être utilisé après la configuration pour étendre la taille du disque.
--robot-package-cache	Chemin d'accès à l'emplacement sur le nœud Automation Suite Robots pour télécharger le package à mettre en cache. Cette opération doit être effectuée uniquement sur le nœud Automation Suite Robots.

Vous pouvez également utiliser la commande pour redimensionner la partition sélectionnée à l'aide de l'indicateur --size , comme illustré dans l'exemple suivant :

./bin/uipathctl rke2 disk --docker-registry --size 300

Configuration du disque du magasin d'objets sur toutes les machines serveur

Cette étape est obligatoire uniquement si le magasin d'objets externe n'est pas disponible.

Vous pouvez ajouter ou augmenter la taille de stockage du magasin d'objets intégré au cluster en exécutant le script suivant sur tous les nœuds de serveur :

./bin/uipathctl rke2 disk --ceph-raw-disk-name name_ceph_raw_disk

Remarque :

• Un problème connu d’Azure marque à tort le disque Azure comme non-SSD. Si Azure est votre fournisseur Cloud et que vous souhaitez configurer le disque magasin d'objets, consultez Résolution des problèmes.
• La mise à l'échelle verticale des disques existants n'est pas prise en charge. Pour augmenter la taille de votre stockage intégré au cluster après l'installation, ajoutez de nouveaux disques bruts.

Configuration du disque AI Center sur les machines sélectionnées

Pour configurer le disque AI Center, exécutez la commande suivante sur les machines sur lesquelles vous prévoyez d'exécuter les pipelines d'entraînement :

./bin/uipathctl rke2 disk --aicenter-disk-name name_of_aicenter_disk_to_partition

Pour augmenter le stockage d'AI Center :

• Si vous souhaitez ajouter un nouveau disque AI Center, exécutez la commande suivante sur la machine à laquelle vous prévoyez d’ajouter le disque :

  ./bin/uipathctl rke2 disk --aicenter-storage-extend name_of_new_aicenter_disk_to_attach
  

• Si vous avez développé le disque AI Center existant, exécutez la commande suivante sur la machine où le disque AI Center sous-jacent est développé :

  ./bin/uipathctl rke2 disk --aicenter-storage-extend
  

Configuration du disque d'hébergement pour le cache du package Automation Suite Robot

Cette étape est requise pour les configurations à nœud unique sans agent Automation Suite Robot dédié.

Pour héberger le cache du package Automation Suite Robot sur le nœud du serveur, vous devez créer un disque d'au moins 10 Go :

./bin/uipathctl rke2 disk --volume name_of_data_disk --robot-package-cache

Remarque :

Il est recommandé que le disque soit sauvegardé par LVM.

Configuration du disque de bundle sur le premier nœud de serveur pour le registre de cluster

Cette étape est requise dans les scénarios suivants :

• Lors de l'exécution d'une installation hors ligne (physiquement isolée) ;
• Lorsqu'un registre externe n'est pas disponible.

Pour configurer le disque de bundle, exécutez la commande suivante uniquement sur le premier nœud de serveur :

./bin/uipathctl rke2 disk --bundle-disk-name name_of_bundle_disk

Configuration du disque de sauvegarde Ceph sur le nœud du serveur

Cette étape est requise uniquement pour les configurations RKE2 à nœud unique avec stockage intégré au cluster afin de sauvegarder le cluster Automation Suite.

Exécutez la commande suivante sur le nœud du serveur :

./bin/uipathctl rke2 disk --backup-disk-name <disk-name>

Validation des montages de disque

Remarque :

Assurez-vous d'ajouter tous les points de montage au fichier fstab et d'inclure l'option nofail dans ces entrées fstab afin qu'elle n'affecte pas le démarrage de la machine virtuelle en cas d'échec.

Pour vérifier que /etc/fstab est correctement configuré et peut gérer un redémarrage du système, effectuez les étapes suivantes et exécutez la commande suivante :

mount -afv

Vous devriez obtenir la sortie suivante :

# 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