kwoodson.yedit

// vim: ft=asciidoc

= yedit リポジトリ :toc: macro :toc-title:

toc::[]

== Ansible ロール: Yedit

このリポジトリには、yamlファイルを変更するためのansibleモジュールが含まれています。

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[こちら]にあります。