Rheinwerk.yedit

// vim: ft=asciidoc

= Dépôt yedit :toc: macro :toc-title:

toc::[]

== Rôle Ansible : Yedit

Ce dépôt 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 via ansible. C'est ma tentative.

== Installation

Vous pouvez l'installer via Ansible Galaxy :

$ ansible-galaxy install kwoodson.yedit

Si vous faites cela, vous devriez également ajouter un 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'importante avant de l'utiliser :

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

== Exemples

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

• hosts: localhost gather_facts: no roles:

  • kwoodson.yedit tasks:

  • name: gérer les 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, voir 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 des Rôles]
• http://docs.ansible.com/ansible/latest/intro_configuration.html#module-utils[module_utils]

== Documentation

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