yedit

// vim: ft=asciidoc

= Репозиторий yedit :toc: macro :toc-title:

toc::[]

== Роль Ansible: Yedit

Этот репозиторий содержит модуль Ansible для изменения файлов yaml.

Я не нашел хорошего способа редактирования файлов yaml и их управления через Ansible. Это моя попытка.

== Установка

Вы можете установить через Ansible Galaxy:

$ ansible-galaxy install kwoodson.yedit

Если вы это сделаете, вы также должны добавить requirements.yml, чтобы другие пользователи вашего плейбука знали, какие зависимости нужно установить:

---
- src: kwoodson.yedit

Затем вы можете упоминать это в плейбуке, импортируя перед использованием:

  roles:
    - kwoodson.yedit
    - роль-использующая-yedit

== Примеры

Иногда необходимо управлять файлами .yml. [source,yaml]

• hosts: localhost gather_facts: no roles:

  • kwoodson.yedit tasks:

  • name: управлять файлами yaml yedit: src: /tmp/test.yaml key: a.b.c value: d: e: f: это тест

  • name: получить конкретное значение yedit: src: /tmp/test.yaml state: list key: a.b.c.d.e.f register: yeditout

  • debug: var=yeditout

== Разработка

Поскольку это роль, просто скопируйте ее в любую директорию ролей, распознаваемую Ansible. Для подробностей смотрите http://docs.ansible.com/ansible/latest/index.html[документация Ansible]:

• http://docs.ansible.com/ansible/devel/playbooks_reuse_roles.html#embedding-modules-and-plugins-in-roles[Встраивание модулей и плагинов в роли]
• http://docs.ansible.com/ansible/latest/intro_configuration.html#module-utils[module_utils]

== Документация

Полная документация доступна здесь.