=================================== ssato.nw_test_existence_by_regex ===================================

.. image:: https://img.shields.io/travis/ssato/ansible-role-nw-test-existence-by-regex.png :target: https://travis-ci.org/ssato/ansible-role-nw-test-existence-by-regex :alt: [テストステータス]

.. image:: https://img.shields.io/ansible/role/44621.svg :target: https://galaxy.ansible.com/ssato/nw_test_existence_by_regex :alt: [Ansible Galaxy]

ネットワークノード内の対象オブジェクトの存在をテストするためのAnsibleロールです。

このロールは、変数rntebr_modeの値によって、次の3つのモードがあります（デフォルトはnormal）。

'normal'は、対象のネットワークノードでコマンドを実行し、正規表現パターンによって対象オブジェクトの存在をテストするモードです。変数rntebr_targets_should_be_foundの値がfalseの場合、対象が見つからないことをテストします。

'dump'は、対象のネットワークノードでコマンドを実行し、その結果を事前定義されたフォーマットのJSONファイルとして出力するモードです。

'dryrun'は、実際に対象のネットワークノードでコマンドを実行せずにこのロールを実行するモードです。与えられたパターンが期待通りに一致するかをテストするのに便利です。

要件

• あなたが使用する各Ansibleネットワークモジュールに必要なPythonモジュール

ロール変数

変数はあなたの使用ケースに合わせてカスタマイズする必要があります。

• rntebr_mode: 'dump' または 'dryrun' または 'normal'を含む他の文字列

  • 結果の出力をダンプしたい場合は 'dump' に設定
  • 正規表現パターンが参照データと一致するかをテストしたい場合は 'dryrun' に設定（参照データを自分で準備する必要があります）
  • 正規表現の一致を見つけることで対象オブジェクトの存在をテストしたい場合は 'normal' を含む他の文字列に設定

• rntebr_targets_patterns: コマンド実行の結果から対象オブジェクトを検索するための正規表現パターン

• rntebr_res: 'dryrun'モードでの結果を設定

• rntebr_dump_path: 'dump'モードでの出力ファイルパス

• rntebr_command: 'dryrun'モード以外の対象のネットワークノードで実行するコマンド

ほとんどの場合、他の変数をカスタマイズする必要はありません。

デフォルトの変数定義については、 defaults/main.yml を、テスト用のファイルについては tests/files/*evars*.yml を参照してください。

例プレイブック

tests/playbook.yml を参照してください。

ライセンス

MIT

著者

佐藤悟 Satoru SATOH ssato@Github <https://github.com/ssato>_

.. vim:sw=2:ts=2:et: