Roles Rôle « Filesystems »

Ce rôle est chargé de configurer les disques et les systèmes de fichiers.

#Tags internes

• filesystems : Exécuter toutes les opérations ;
• packages-only : N’exécuter que l’installation des paquets ;
• setup-only : N’exécuter que la configuration des paquets ;
• fs-only : N’exécuter quel les tâches d’initialisation des système de fichiers ;
• targets-only : N’exécuter que les partages iSCSI ;

#Variables à fournir

Variable	Type	Requis	Défaut	Description
fs_operations	Liste d’objects operation	Oui		Liste ordonnée des opérations
mdadm_host	Identifiant	Si md_raid utilisé	Absent	Nom d’hôte de la machine pour homehost
mdadm_admin	Email	Si md_raid utilisé	Absent	Adresse email de l’administrateur
iscsi_initiator_name	Identifiant iqn	Si iscsi utilisé	Absent	Identifiant de l’initiateur iscsi
iscsi_targets	Liste d’objets target	Non	Vide	Cibles iSCSI à initialiser

#Type abstrait operation

Propriété	Type	Requis	Défaut	Description
type	Identifiant	Oui		Type réel de l’opération

#Type table

Sous-type de operation, avec type à table. Pour la mise en place d’une table de partition.

Propriété	Type	Requis	Défaut	Description
device	Chemin	Oui		Chemin vers le périphérique de préférence utilisant un identifiant unique
format	Choix [gpt,msdos]	Oui		Type de table de partition

#Type partition

Sous-type de operation, avec type à partition. Pour la mise en place d’une partition.

Propriété	Type	Requis	Défaut	Description
device	Chemin	Oui		Chemin vers le périphérique de préférence utilisant un identifiant unique
number	Entier positif	Oui		Numéro de la partition
name	Texte	Non	Absent	Nom de la partition
part_type	ID, GUID ou Identifiant	Oui		Type GUID ou ID de la partition, ou type du système de fichier
start	Texte	Oui		Emplacement du début de la partition, voir man parted
end	Texte	Oui		Emplacement de la fin de la partition, voir man parted

#Type md_raid

Sous-type de operation, avec type à md_raid. Pour la mise en place d’un RAID logiciel.

Des options spécifiques pour mdadm peuvent être spécifiées.

Propriété	Type	Requis	Défaut	Description
device	Chemin	Oui		Chemin vers le périphérique raid par nom
level	Entier	Oui		Niveau de redondance RAID
count	Entier	Oui		Nombre de disques actifs
devices_patterns	Liste de motifs de chemin	Oui		Motifs des chemins vers les périphériques composants, suivant l’identifiant unique de préférence

#Type filesystem

Sous-type de operation, avec type à filesystem. Pour la mise en place d’un système de fichiers.

Propriété	Type	Requis	Défaut	Description
device	Chemin	Oui		Chemin vers le périphérique de préférence utilisant un identifiant unique
label	Texte	Non	Vide	Libellé du système de fichier
fs_type	Identifiant	Oui		Type de système de fichier
args	Dictionnaire de chaînes	Non	Vide	Options supplémentaire de la ligne de commande, sans les tirets dans le nom

#Type btrfs_volume

Sous-type de operation, avec type à btrfs_volume. Pour la mise en place d’un sous-volume sur un volume btrfs.

Propriété	Type	Requis	Défaut	Description
name	Chemin	Oui		Chemin interne du sous-volume, non précédé d’une barre oblique
device	Chemin	Oui		Chemin vers le périphérique de préférence utilisant un identifiant unique

#Type mount

Sous-type de operation, avec type à mount. Pour la configuration d’un point de montage.

Propriété	Type	Requis	Défaut	Description
mount	Chemin	Oui		Chemin du dossier où effectuer le montage, créé si non existant
device	Chemin	Oui		Chemin vers le périphérique de préférence utilisant un identifiant unique
mode	Choix [path,uuid,label,none]	Non	path	Mode de référence du périphérique dans fstab, ou non enregistré si ‘none’
options	Options mount	Oui		Options de montage telles qu’acceptées par mount
volume	Chemin	Non	Absent	Sous-volume du système de fichier à utiliser, pour btrfs
pass	Entier {0..2}	Non	1	Configuration de la passe de vérification, ignoré si mode == ‘none’
move_existing	Booléen	Non	Faux	Lorsque le point de montage existe déjà, déplacer le contenu dans le système de fichier, si vide
services	Liste d’identifiants	Non	Vide	Liste des services à arrêter pendant le déplacement du contenu

#Type iscsi

Sous-type de operation, avec type à iscsi. Pour la configuration d’un périphérique venant d’une cible iSCSI.

Propriété	Type	Requis	Défaut	Description
portal_ip	Adresse IP ou FQDN	Oui		Adresse IP ou nom du portail iSCSI
portal_port	Entier (1-65535)	Oui		Port de connexion au portail iSCSI
target	Identifiant iqn	Oui		Identifiant de la cible à laquelle se connecter

#Type volume_group

Sous-type de operation, avec type à volume_group. Pour la configuration d’un groupe de volume lvm.

Propriété	Type	Requis	Défaut	Description
name	Identifiant	Oui		Nom du groupe de volumes
devices_patterns	Liste de motifs de chemin	Oui		Motifs des chemins vers les périphériques composants, suivant l’identifiant unique de préférence

#Type logical_volume

Sous-type de operation, avec type à logical_volume. Pour la configuration d’un groupe de volume lvm.

Propriété	Type	Requis	Défaut	Description
name	Identifiant	Oui		Nom du volume logique
vg	Identifiant	Oui		Nom du groupe de volumes
size	Entier avec unité	Oui si extends absent		Taille du volume
extends	Entier ou pourcentage	Oui si size absent		Taille du volume en blocs ou pourcentage
thinpool	Booléen	Non	Faux	Le volume est conteneur de volume légers
chunk_size	Entier avec unité	Non	Absent	Taille des unités d’allocation du volume

Unité de pourcentage :

• Groupe de volumes : ‘%VG’
• Espace libre : ‘%FREE’

#Type target

Propriété	Type	Requis	Défaut	Description
wwn	Identifiant iqn	Oui		Identifiant de la cible à créer
attributes	Dictionnaire	Non	Absent	Attributs à définir sur la cible
state	Option [present, absent]	Non	present	État de la cible
disks	Liste d’objets disk	Oui		Disques exposés par la cible
initiators	Liste de chaînes ou d’objets initiator	Oui		Initiateurs ayant accès à la cible
portals	Liste d’objets portal	Oui		Portails à déclarer sur la cible

Remarque : Pour initiator, lorsqu’une chaîne de caractère est utilisée, elle est considérée équivalente à un objet initiator avec la valeur de la chaîne comme identifiant de l’initiateur.

#Type disk

Propriété	Type	Requis	Défaut	Description
type	Option [block, fileio, pscsi]	Oui		Type de stockage
path	Chemin	Oui		Emplacement du stockage réel
name	Identifiant	Oui		Nom interne du stockage
size	Entier	Non	Absent	Taille du fichier de stockage pour fileio
attributes	Dictionnaire	Non	Absent	Attributs à définir sur le disque
state	Option [present, absent]	Non	present	État du disque

Remarque : Pour le type fileio, le fichier de disque est créé en amont de la définition du stockage. Le fichier n’est jamais supprimé ni réduit. Il est en revanche agrandi si nécessaire.

#Type initiator

Propriété	Type	Requis	Défaut	Description
wwn	Identifiant iqn	Oui		Identifiant de l’initiateur autorisé
state	Option [present, absent]	Non	present	État de la cible

#Type portal

Propriété	Type	Requis	Défaut	Description
ip	Adresse IP	Oui		Adresse IP d’écoute
port	Entier (1-65535)	Oui		Port d’écoute TCP
state	Option [present, absent]	Non	present	État de la cible

Attention : Si le portail par défaut écoutant sur l’ip 0.0.0.0 et le port 3260 n’est pas souhaité, il est nécessaire d’explicitement le retirer des cibles