kwoodson.yedit

// vim: ft=asciidoc

= Repozytorium Yedit :toc: macro :toc-title:

toc::[]

== Rola Ansible: Yedit

To repozytorium zawiera moduł ansible do modyfikacji plików yaml.

Nie znalazłem dobrego sposobu na edytowanie plików yaml i zarządzanie ich konfiguracją za pomocą ansible. To jest moja próba.

== Instalacja

Możesz zainstalować przez Ansible Galaxy:

$ ansible-galaxy install kwoodson.yedit

Jeśli to zrobisz, powinieneś także dodać requirements.yml, aby inni użytkownicy twojego playbooka wiedzieli, jakie zależności zainstalować:

---
- src: kwoodson.yedit

Następnie możesz odwołać się do niego w playbooku, importując go przed użyciem:

  roles:
    - kwoodson.yedit
    - rola-która-używa-yedit

== Przykłady

Czasami konieczne jest zarządzanie plikami .yml. [source,yaml]

• hosts: localhost gather_facts: no roles:

  • kwoodson.yedit tasks:

  • name: zarządzaj plikami yaml yedit: src: /tmp/test.yaml key: a.b.c value: d: e: f: to jest test

  • name: pobierz konkretną wartość yedit: src: /tmp/test.yaml state: list key: a.b.c.d.e.f register: yeditout

  • debug: var=yeditout

== Rozwój

Jako że jest to rola, wystarczy skopiować ją do dowolnego katalogu ról rozpoznawanego przez Ansible. Szczegóły znajdziesz w http://docs.ansible.com/ansible/latest/index.html[ dokumentacji Ansible]:

• http://docs.ansible.com/ansible/devel/playbooks_reuse_roles.html#embedding-modules-and-plugins-in-roles[Osadzanie modułów i wtyczek w rolach]
• http://docs.ansible.com/ansible/latest/intro_configuration.html#module-utils[module_utils]

== Dokumentacja

Pełna dokumentacja jest dostępna w https://github.com/kwoodson/ansible-role-yedit/blob/master/library/yedit.py#L15[ tym miejscu].