.. _ug_example_003:

Example 3: Configure ...
^^^^^^^^^^^^^^^^^^^^^^^^

Create a playbook

.. code-block:: yaml
   :emphasize-lines: 1

   shell> cat playbook.yml
   - hosts: test_01
     become: true
     roles:
       - vbotka.freebsd_custom_image

Create *host_vars/test_01/XY-task1.yml*

.. code-block:: yaml
   :emphasize-lines: 1,3

   shell> cat host_vars/test_01/XY-task1.yml 
   XY_task1: true
   ...

.. note::
   * When ...
   * See ...


Configure ...

.. code-block:: sh
   :emphasize-lines: 1

   shell> ansible-playbook playbook.yml -t XY_task1

   TASK [vbotka.freebsd_custom_image : task1: Configure ...] **
   ok: [test_01] => (...)

The command is idempotent

.. code-block:: sh
   :emphasize-lines: 1

   shell> ansible-playbook playbook.yml -t XY_task1
   ...
   PLAY RECAP ******************************************************************
   test_01: ok=6 changed=0 unreachable=0 failed=0 skipped=4 rescued=0 ignored=0