Ansible Navigator Creator ガイド

手順

1. Red Hat Ansible Automation Platform SKU を割り当てます。

   $ subscription-manager attach --pool=<sku-pool-id>

   Copy to Clipboard Toggle word wrap

2. RHEL 8 のリポジトリーを有効にします。

   $ sudo subscription-manager repos --enable ansible-automation-platform-2.1-for-rhel-8-x86_64-rpms

   Copy to Clipboard Toggle word wrap

3. 自動化コンテンツナビゲーターをインストールします。

   $ dnf install ansible-navigator

   Copy to Clipboard Toggle word wrap

手順

1. 自動化コンテンツナビゲーター設定に含まれる自動化実行環境を確認します。

   $ ansible-navigator images

   Copy to Clipboard Toggle word wrap
   

   View larger image

   

2. 詳細については、詳しく調べたい自動化実行環境の番号を入力してください。

   

   View larger image

   

   インストールされている各自動化実行環境のパッケージおよびバージョン、および Ansible バージョンに含まれるコレクションを確認できます。

3. オプション: 使用する自動化実行環境を渡します。これはプライマリーであり、自動化コンテンツナビゲーターが使用する自動化実行環境です。

   $ ansible-navigator images --eei  registry.example.com/example-enterprise-ee:latest

   Copy to Clipboard Toggle word wrap

手順

1. 自動化コンテンツナビゲーターを起動します。

   $ ansible-navigator

   Copy to Clipboard Toggle word wrap

   オプション: コマンドラインから ansible-navigator inventory -i simple_inventory.yml と入力してインベントリーを表示します。

2. インベントリーを確認します。

    :inventory -i simple_inventory.yml
   
      TITLE            DESCRIPTION
   0│Browse groups    Explore each inventory group and group members members
   1│Browse hosts     Explore the inventory with a list of all hosts

   Copy to Clipboard Toggle word wrap

3. 0 を入力してグループを表示します。

     NAME               TAXONOMY                      TYPE
   0│general            all                           group
   1│nodes              all                           group
   2│ungrouped          all                           group

   Copy to Clipboard Toggle word wrap

   TAXONOMY フィールドには、選択したグループまたはノードが属するグループの階層の詳細が表示されます。

4. 調べるグループに対応する番号を入力します。

     NAME              TAXONOMY                        TYPE
   0│node-0            all▸nodes                       host
   1│node-1            all▸nodes                       host
   2│node-2            all▸nodes                       host

   Copy to Clipboard Toggle word wrap

5. 調べるホストに対応する番号を入力します。番号が 9 以上になる場合は、:<number> と入力します。

   [node-1]
   0│---
   1│ansible_host: node-1.example.com
   2│inventory_hostname: node-1

   Copy to Clipboard Toggle word wrap

手順

1. 自動化コンテンツナビゲーターを起動します。

   $ ansible-navigator

   Copy to Clipboard Toggle word wrap

2. コレクションを参照します。または、ansible-navigator collections と入力してコレクションを直接参照することもできます。

   $ :collections

   Copy to Clipboard Toggle word wrap
   

   View larger image

   

3. 確認するコレクションの数を入力します。

   :4

   Copy to Clipboard Toggle word wrap
   

   View larger image

   

4. 調べるモジュールに対応する番号を入力します。

   ANSIBLE.UTILS.IP_ADDRESS: Test if something in an IP address
    0│---
    1│additional_information: {}
    2│collection_info:
    3│  authors:
    4│  - Ansible Community
    5│  dependencies: {}
    6│  description: Ansible Collection with utilities to ease the management, manipulation,
    7│    and validation of data within a playbook
    8│  documentation: null
    9│  homepage: null
   10│  issues: null
   11│  license: []
   12│  license_file: LICENSE
   13│  name: ansible.utils
   14│  namespace: ansible
   15│  path:/usr/share/ansible/collections/ansible_collections/ansible/utils/
   16│  readme: README.md
   <... output truncated...>

   Copy to Clipboard Toggle word wrap

5. オプション: このモジュールのドキュメントの例に移動します。

   :{{ examples }}
   
   0│
   1│
   2│#### Simple examples
   3│
   4│- name: Check if 10.1.1.1 is a valid IP address
   5│  ansible.builtin.set_fact:
   6│    data: "{{ '10.1.1.1' is ansible.utils.ip_address }}"
   7│
   8│# TASK [Check if 10.1.1.1 is a valid IP address] *********************
   9│# ok: [localhost] => {
   10│#     "ansible_facts": {
   11│#         "data": true
   12│#     },
   13│#     "changed": false
   14│# }
   15│

   Copy to Clipboard Toggle word wrap

6. オプション: エディターでサンプルを開き、それを Playbook にコピーします。

   :open

   Copy to Clipboard Toggle word wrap
   

   View larger image

   

手順

1. 自動化コンテンツナビゲーターを起動します。

   $ ansible-navigator

   Copy to Clipboard Toggle word wrap

2. 対象のモジュールを確認します。または、ansible-navigator doc と入力してドキュメントにアクセスすることもできます。

   :doc ansible.utils.ip_address

   Copy to Clipboard Toggle word wrap

   ANSIBLE.UTILS.IP_ADDRESS: Test if something in an IP address
    0│---
    1│additional_information: {}
    2│collection_info:
    3│  authors:
    4│  - Ansible Community
    5│  dependencies: {}
    6│  description: Ansible Collection with utilities to ease the management, manipulation,
    7│    and validation of data within a playbook
    8│  documentation: null
    9│  homepage: null
   10│  issues: null
   11│  license: []
   12│  license_file: LICENSE
   13│  name: ansible.utils
   14│  namespace: ansible
   15│  path:/usr/share/ansible/collections/ansible_collections/ansible/utils/
   16│  readme: README.md
   <... output truncated...>

   Copy to Clipboard Toggle word wrap

3. このモジュールのドキュメント例に移動します。

   :{{ examples }}
   
   0│
   1│
   2│#### Simple examples
   3│
   4│- name: Check if 10.1.1.1 is a valid IP address
   5│  ansible.builtin.set_fact:
   6│    data: "{{ '10.1.1.1' is ansible.utils.ip_address }}"
   7│
   8│# TASK [Check if 10.1.1.1 is a valid IP address] *********************
   9│# ok: [localhost] => {
   10│#     "ansible_facts": {
   11│#         "data": true
   12│#     },
   13│#     "changed": false
   14│# }
   15│

   Copy to Clipboard Toggle word wrap

4. オプション: エディターでサンプルを開き、それを Playbook にコピーします。

   :open

   Copy to Clipboard Toggle word wrap
   

   View larger image

   

   エディターの設定方法の詳細は 「自動化コンテンツナビゲーターの一般設定」 を参照してください。

手順

1. 自動化コンテンツナビゲーターを起動します。

   $ ansible-navigator

   Copy to Clipboard Toggle word wrap

2. Playbook を実行します。

   $ :run

   Copy to Clipboard Toggle word wrap
3. オプション: ansible-navigator run simple-playbook.yml -i inventory.yml を入力して Playbook を実行します。

4. インベントリーおよびその他のコマンドラインパラメーターを確認または追加します。

   INVENTORY OR PLAYBOOK NOT FOUND, PLEASE CONFIRM THE FOLLOWING
   ─────────────────────────────────────────────────────────────────────────
      Path to playbook: /home/ansible-navigator_demo/simple_playbook.yml
      Inventory source: /home/ansible-navigator-demo/inventory.yml
     Additional command line parameters: Please provide a value (optional)
   ──────────────────────────────────────────────────────────────────────────
                                                              Submit Cancel

   Copy to Clipboard Toggle word wrap

5. Tab キーを押して Submit に移動し、Enter キーを押します。実行中のタスクが表示されるはずです。

   

   View larger image

   

6. プレイ結果にステップインするプレイの横に番号を入力します。9 を超える数字の場合は :<number> と入力します。

   

   View larger image

   

   自動化コンテンツナビゲーターで色を有効にしている場合は、失敗したタスクが赤で表示されることに注意してください。

7. タスクの結果を確認するタスクの横に番号を入力します。9 を超える番号の場合は :<number> と入力します。

   

   View larger image

   

8. オプション::doc と入力し、トラブルシューティングを支援するタスクで使用されるモジュールまたはプラグインのドキュメントを起動します。

   ANSIBLE.BUILTIN.PACKAGE_FACTS (MODULE)
     0│---
     1│doc:
     2│  author:
     3│  - Matthew Jones (@matburt)
     4│  - Brian Coca (@bcoca)
     5│  - Adam Miller (@maxamillion)
     6│  collection: ansible.builtin
     7│  description:
     8│  - Return information about installed packages as facts.
   <... output omitted ...>
    11│  module: package_facts
    12│  notes:
    13│  - Supports C(check_mode).
    14│  options:
    15│    manager:
    16│      choices:
    17│      - auto
    18│      - rpm
    19│      - apt
    20│      - portage
    21│      - pkg
    22│      - pacman
   
   <... output truncated ...>

   Copy to Clipboard Toggle word wrap

手順

1. 自動化コンテンツナビゲーターを起動します。

   $ ansible-navigator

   Copy to Clipboard Toggle word wrap

   オプション: コマンドラインから ansible-navigator config を入力し、Ansible 設定にアクセスします。

2. Ansible 設定を確認します。

    :config

   Copy to Clipboard Toggle word wrap
   

   View larger image

   

   一部の値は、自動化実行環境が機能するために必要な自動化実行環境の設定を反映しています。これらは、Ansible 設定ファイルでは設定できないデフォルト以外の設定として表示されます。

3. 調べる設定に対応する番号を入力します。番号が 9 以上になる場合は、:<number> と入力します。

   ANSIBLE COW ACCEPTLIST (current: ['bud-frogs', 'bunny', 'cheese']) (default:
    0│---
    1│current:
    2│- bud-frogs
    3│- bunny
    4│- cheese
    5│default:
    6│- bud-frogs
    7│- bunny
    8│- cheese
    9│- daemon

   Copy to Clipboard Toggle word wrap