.. _example_016:

016 Multiple inventory constructed
----------------------------------

Extending example :ref:`example_015`.

.. contents::
   :local:
   :depth: 1

.. index:: inventory ansible.builtin.constructed; Example 016
.. index:: single: option compose; Example 016
.. index:: single: compose; Example 016
.. index:: single: option groups; Example 016
.. index:: single: groups; Example 016

Use case
^^^^^^^^

Create inventory groups using the inventory plugin `ansible.builtin.constructed`_ after the two
`inventory plugin vbotka.freebsd.iocage`_ configuration files.

Tree
^^^^

::

  shell> tree .
  .
  ├── ansible.cfg
  ├── hosts
  │   ├── 02_iocage.yml
  │   ├── 04_iocage.yml
  │   └── 99_constructed.yml
  └── pb-test.yml

Synopsis
^^^^^^^^

* The `inventory plugin vbotka.freebsd.iocage`_ gets the jails (managed nodes):

  * ``test_111:113`` from the host ``iocage_02`` 
  * ``test_131:133`` from the host ``iocage_04`` 

  and creates the inventory groups ``test_02`` and ``test_04``.

* The inventory plugin `ansible.builtin.constructed`_ creates the inventory groups:

  * ``test`` comprising hosts starting ``'test'``
  * ``test_up`` comprising running hosts starting ``'test'``.

Requirements
^^^^^^^^^^^^

* `inventory plugin vbotka.freebsd.iocage`_
* jails created in :ref:`example_010`

Notes
^^^^^

* The inventory files in the directory ``hosts`` are evaluated in the alphabetical order.
* See :ref:`example_015`
* The `inventory plugin vbotka.freebsd.iocage`_ doesn't provide the option `use_vars_plugins`_.
* See :ref:`example_019`.

Jails at iocage_02
^^^^^^^^^^^^^^^^^^

.. code-block:: console

   [iocage_02]# iocage list -l

.. literalinclude:: out/out-01.txt
   :language: bash

Jails at iocage_04
^^^^^^^^^^^^^^^^^^

.. code-block:: console

   [iocage_04]# iocage list -l

.. literalinclude:: out/out-02.txt
   :language: bash

ansible.cfg
^^^^^^^^^^^

.. literalinclude:: ansible.cfg
   :language: ini

Inventory hosts
^^^^^^^^^^^^^^^

.. literalinclude:: hosts/02_iocage.yml
   :language: yaml
   :caption:

.. literalinclude:: hosts/04_iocage.yml
   :language: yaml
   :caption:

.. literalinclude:: hosts/99_constructed.yml
   :language: yaml
   :caption:

Playbook pb-test.yml
^^^^^^^^^^^^^^^^^^^^

.. literalinclude:: pb-test.yml
   :language: yaml

Playbook output - Display groups
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: console

   (env) > ansible-playbook pb-test.yml -i hosts

.. literalinclude:: out/out-03.txt
   :language: yaml
   :force:


.. _ansible.builtin.constructed: https://docs.ansible.com/ansible/latest/collections/ansible/builtin/constructed_inventory.html
.. _inventory plugin vbotka.freebsd.iocage: https://galaxy.ansible.com/ui/repo/published/vbotka/freebsd/content/inventory/iocage/
.. _use_vars_plugins: https://docs.ansible.com/ansible/latest/collections/ansible/builtin/constructed_inventory.html#parameter-use_vars_plugins