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]

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

Полная документация доступна по адресу https://github.com/kwoodson/ansible-role-yedit/blob/master/library/yedit.py#L15[здесь].