Roles Rôle « MySql Dbs »

22 octobre 2025 à 16:34

Ce rôle est chargé de gérer les bases de données et les accès utilisateur dans un serveur MySQL ou compatible. Facultativement, un script d’import initial peut être utilisé.

Tags internes

  • mysqldatabases : Mise en place des bases de données ;

Traitements spécifiques du jeu de tâches

Afin de permettre de filtrer les bases de données lorsque l’on souhaite limiter l’exécution (comme avec les tags), les noms de variable à fournir sont différents de ceux attendus par le rôle « MySql Dbs ».

Variable côté jeu de tâches Variable côté rôle
managed_databases databases

Le filtrage est effectué à l’aide de la variable only_databases à spécifier avec l’option -e. C’est une liste de nom de base de données, tel que déclaré dans dbs::name. Exemple :

{ "only_databases": [ "mydb1", "yourdb2" ]}

Les bases de données spécifiées dans les vhosts sont aussi intégrées. Voir CustomVhostsUsers.

Variables à fournir

Variable Type Requis Défaut Description
databases Liste d’objets dbs None Liste vide Bases de données à créer
mysqldbs Objet mysql None Liste vide Paramètres d’accès MySQL globaux

Type dbs

Propriété Type Requis Défaut Description
name Identifiant Oui Nom de la base de données à créer
collation MySQL Collation Non utf8mb4_unicode_ci/utf8_unicode_ci Codage de caractère et règles de comparaisons
import_script_src Chemin Vide Chemin local du script de base de données à importer à la création
import_script_remote Chemin Vide Chemin sur l’hôte configuré où copier le script à importer
users Liste d’objets dbuser Non Liste vide Liste des utilisateurs à créer
base_role Identifiant Non Vide Nom du rôle d’où provient le fichier à importer, lors de l’utilisation de ce rôle par un autre, pour résoudre le chemin local du script à importer

Les variables import_script_src et import_script_remote doivent être présentes ensemble pour l’importation initiale.

Les utilisateurs déclarés dans les listes users de chacune des bases de données doivent être présents de manière unique, les autorisations étant remplacées et non ajoutées.

Type dbuser

Propriété Type Requis Défaut Description
name Identifiant Oui Nom de l’utilisateur
host Motif SQL Non localhost Motif du nom d’hôte associé à l’utilisateur
password Chaîne Oui Mot de passe de l’utilisateur, en clair
privileges Chaîne Oui Privilèges à définir pour l’utilisateur, tel que défini par la syntaxe MySQL, voir l’argument priv du module mysql_user
tls Booléen Non Faux Nécessite l’établissement d’une connexion sécurisée

Type mysql

Propriété Type Requis Défaut Description
root_password Chaîne Oui Le mot de passe root définit
isMariaDB Booléen Oui Indique que le serveur est de type MariaDB