volant lock
Enregistre la version de Volant, le runtime géré et les collections et rôles installés dans volant.lock, et compare une machine à ce fichier.
volant lock écrit volant.lock : la version de Volant, le runtime géré et une empreinte de chaque collection et de chaque rôle installés. Deux machines avec le même dépôt, ou un job de CI et un collègue, apprennent qu’elles diffèrent avant une exécution plutôt que pendant.
volant lock [--check]Le fichier se trouve à côté de l’ansible.cfg en vigueur, sinon dans le répertoire de travail. C’est du TOML, trié, et le même arbre donne les mêmes octets :
format = 1volant = "0.4.2"core_version = "2.19"runtime = { python = "3.13.16", ansible_core = "2.19.12", sha256 = "..." }
[[collection]]name = "community.general"version = "11.2.0"sha256 = "..."
[[role]]name = "geerlingguy.nginx"version = "3.2.0"sha256 = "..."core_versionvaut2.19, le seul profil qui existe.runtimen’apparaît que si le runtime géré est installé. Sonsha256est celui du manifeste depuis lequel le runtime a été installé.- Les collections sont celles du chemin des collections, et les rôles ceux du chemin des rôles. Quand un nom figure dans deux chemins, le premier l’emporte, comme le chargeur le choisit.
- Un
sha256couvre les chemins relatifs triés de l’arbre et le contenu de chaque fichier, sans les répertoires__pycache__ni les fichiers*.pyc. Lemeta/.galaxy_install_infod’un rôle, qui contient sa date d’installation, est laissé de côté. - Non enregistrés : quels modules tournent en natif (cela découle de la version de Volant), et les réglages d’
ansible.cfgouANSIBLE_*, qui sont des choix et non une dérive.
volant lock n’installe rien. Il écrit le fichier à partir de ce qui est installé et affiche wrote <path>.
N’écrit rien ; affiche chaque différence avec le fichier, une par ligne, et sort avec 1 quand il y en a une. Un fichier illisible est une erreur, code 1.
Pendant une exécution
Section intitulée « Pendant une exécution »Quand volant.lock existe, volant playbook compare l’arbre installé au fichier avant la première connexion, là où tournent les vérifications préalables. Chaque différence donne un avertissement, [WARNING]: volant.lock: <difference>, et l’exécution continue. Avec --locked, ou [volant] locked = true, une différence arrête l’exécution avec le code 4 et la liste des différences, avant qu’un hôte soit contacté. Un fichier illisible donne un avertissement, ou le même refus sous --locked. Un listage (--list-tasks et les autres) saute la vérification.