kwoodson.yedit

// vim: ft=asciidoc

= Référentiel yedit :toc: macro :toc-title:

toc::[]

== Rôle Ansible : Yedit

Ce référentiel contient un module Ansible pour modifier des fichiers yaml.

Je n'ai pas trouvé de bonne méthode pour éditer des fichiers yaml et les gérer par configuration avec Ansible. Ceci est ma tentative.

== Installation

Vous pouvez installer via Ansible Galaxy :

$ ansible-galaxy install kwoodson.yedit

Si vous faites cela, vous devriez également ajouter un fichier requirements.yml afin que d'autres utilisateurs de votre playbook sachent quelles dépendances installer :

---
- src: kwoodson.yedit

Vous pouvez ensuite le référencer dans un play en l'importer avant utilisation :

  roles:
    - kwoodson.yedit
    - rôle-qui-utilise-yedit

== Exemples

Parfois, il est nécessaire de gérer des fichiers .yml. [source,yaml]

• hosts: localhost gather_facts: no roles:

  • kwoodson.yedit tasks:

  • name: gérer des fichiers yaml yedit: src: /tmp/test.yaml key: a.b.c value: d: e: f: ceci est un test

  • name: obtenir une valeur spécifique yedit: src: /tmp/test.yaml state: list key: a.b.c.d.e.f register: yeditout

  • debug: var=yeditout

== Développement

Étant donné qu'il s'agit d'un rôle, il suffit de le copier dans n'importe quel répertoire de rôles reconnu par Ansible. Pour plus de détails, consultez la documentation d'Ansible :

• http://docs.ansible.com/ansible/latest/index.html[Documentation Ansible]
• http://docs.ansible.com/ansible/devel/playbooks_reuse_roles.html#embedding-modules-and-plugins-in-roles[Incorporation de modules et plugins dans les rôles]
• http://docs.ansible.com/ansible/latest/intro_configuration.html#module-utils[module_utils]

== Documentation

La documentation complète est disponible en ligne https://github.com/kwoodson/ansible-role-yedit/blob/master/library/yedit.py#L15[ici].