3.3. CLI を使用したコレクションのインストール
コレクションは、Playbook、ロール、モジュール、およびプラグインなど、Ansible コンテンツのディストリビューション形式です。
コレクションは、Ansible Galaxy、ブラウザーまたはコマンドラインを使用してインストールできます。
前提条件
- 1 つ以上の 管理対象ノード へのアクセスとアクセス権。
コントロールノード (このシステムから Red Hat Ansible Core は他のシステムを設定) へのアクセスおよびパーミッション。
コントロールノードでは、
-
ansible-coreパッケージおよびrhel-system-rolesパッケージがインストールされている。 - 管理対象ノードが記載されているインベントリーファイルがある。
-
手順
RPM パッケージからコレクションをインストールします。
# dnf install rhel-system-roles
インストールが完了すると、ロールは redhat.rhel_system_roles.<role_name> として利用できます。また、各ロールのドキュメントは /usr/share/ansible/collections/ansible_collections/redhat/rhel_system_roles/roles/<role_name>/README.md で確認できます。
検証手順
インストールを確認するには、localhost で check モードで kernel_settings ロールを実行します。Ansible package モジュールに必要な --become パラメーターも使用する必要があります。ただし、パラメーターはシステムを変更しません。
以下のコマンドを実行します。
$ ansible-playbook -c local -i localhost, --check --become /usr/share/ansible/collections/ansible_collections/redhat/rhel_system_roles/tests/kernel_settings/tests_default.yml
コマンド出力の最後の行には、値 failed=0 が含まれている必要があります。
localhost の後のコンマは必須です。リストにホストが 1 つしかない場合でも、追加する必要があります。これがないと、ansible-playbook は localhost をファイルまたはディレクトリーとして識別します。
関連情報
-
ansible-playbookの man ページ -
ansible-playbookコマンドの-iオプション
