.. _ug_example_001:

Configure wifi by config_light
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Instead of the :ref:`ug_tasks`, it's possible to use Ansible role `vbotka.config_light`_ to
configure the image. This example configures exactly the same parameters of the wireless network as
the example in :ref:`qg`. The playbook ``pb-wifi-basic.yml`` created in the :ref:`qg` will be used
to attach a memory disk and mount the partition.

* Current directory ::

    shell> ls -1
    conf-light
    hosts
    pb-wifi-basic-cl.yml
    pb-wifi-basic.yml

* Install the role `vbotka.config_light`_ ::

    shell> ansible-galaxy install vbotka.config_light

* Create the playbook ``pb-wifi-basic-cl.yml`` for single host images.example.com (2). Configure
  connection (4-5) and privilege escalation (6-8). Configure the directory (11) with the
  configuration files and reuse the configuration (13-17) already prepared in :ref:`qg` (19-48).

.. literalinclude:: ../../contrib/example-wifi-basic-cl/pb-wifi-basic-cl.yml
  :caption: `contrib/example-wifi-basic-cl/pb-wifi-basic-cl.yml`_
  :lines: 27-77
  :language: yaml
  :emphasize-lines: 2,4-8,11,13-17
  :linenos:

* Create the configuration files in the directory ``cl_dird`` ::

    shell> tree conf-light/
    conf-light/
    ├── files.d
    │   ├── loaderconf.yml
    │   ├── rcconf.yml
    │   └── wpasupconf.yml
    ├── handlers.d
    ├── packages.d
    ├── services.d
    └── states.d
        └── wpasupconf.yml

.. seealso:: How to configure `Files in vbotka.config_light`_

.. literalinclude:: ../../contrib/example-wifi-basic-cl/conf-light/files.d/loaderconf.yml
  :caption: `contrib/example-wifi-basic-cl/conf-light/files.d/loaderconf.yml`_
  :language: yaml
  :emphasize-lines: 2
  :linenos:

.. seealso:: The template `templates/loader.conf.j2`_

.. literalinclude:: ../../contrib/example-wifi-basic-cl/conf-light/files.d/rcconf.yml
  :caption: `contrib/example-wifi-basic-cl/conf-light/files.d/rcconf.yml`_
  :language: yaml
  :emphasize-lines: 2
  :linenos:

.. literalinclude:: ../../contrib/example-wifi-basic-cl/conf-light/files.d/wpasupconf.yml
  :caption: `contrib/example-wifi-basic-cl/conf-light/files.d/wpasupconf.yml`_
  :language: yaml
  :emphasize-lines: 2
  :linenos:

.. seealso:: The template `templates/wpa_supplicant.conf.wlan0.j2`_

.. literalinclude:: ../../contrib/example-wifi-basic-cl/conf-light/states.d/wpasup-conf.yml
  :caption: `contrib/example-wifi-basic-cl/conf-light/states.d/wpasup-conf.yml`_
  :language: yaml
  :emphasize-lines: 2
  :linenos:

* Create the inventory. Change the IP address (2) and fit the paths to Python (8) and Perl (9) if
  necessary

.. code-block:: sh
   :emphasize-lines: 2,8-9
   :linenos:

    shell> cat hosts
    images.example.com ansible_host=<ip-address>

    [images]
    images.example.com

    [images:vars]
    ansible_python_interpreter=/usr/local/bin/python3.11
    ansible_perl_interpreter=/usr/local/bin/perl

* Mount the image using the playbook prepared in :ref:`qg` ::

   shell> ansible-playbook pb-wifi-basic.yml -t cimage_mount

* Test the syntax ::

    shell> ansible-playbook pb-wifi-basic-cl.yml --syntax-check

* See what variables will be included ::

    shell> ansible-playbook pb-wifi-basic-cl.yml -t cl_debug -e cl_debug=true

* Run the playbook ::

    shell> ansible-playbook pb-wifi-basic-cl.yml

* Umount the partition and detach the memory disk ::

   shell> ansible-playbook pb-wifi-basic.yml -t cimage_umount

* Write the customized image to a disk and boot the system. See the details in :ref:`qg`.

.. _vbotka.config_light: https://galaxy.ansible.com/vbotka/config_light
.. _Files in vbotka.config_light: https://ansible-config-light.readthedocs.io/en/latest/guide.html#files

.. _contrib/example-wifi-basic-cl/pb-wifi-basic-cl.yml: https://raw.githubusercontent.com/vbotka/ansible-freebsd-custom-image/master/contrib/example-wifi-basic-cl/pb-wifi-basic-cl.yml
.. _contrib/example-wifi-basic-cl/conf-light/files.d/loaderconf.yml: https://raw.githubusercontent.com/vbotka/ansible-freebsd-custom-image/master/contrib/example-wifi-basic-cl/conf-light/files.d/loaderconf.yml
.. _contrib/example-wifi-basic-cl/conf-light/files.d/rcconf.yml: https://raw.githubusercontent.com/vbotka/ansible-freebsd-custom-image/master/contrib/example-wifi-basic-cl/conf-light/files.d/rcconf.yml
.. _contrib/example-wifi-basic-cl/conf-light/files.d/wpasupconf.yml: https://raw.githubusercontent.com/vbotka/ansible-freebsd-custom-image/master/contrib/example-wifi-basic-cl/conf-light/files.d/wpasupconf.yml
.. _contrib/example-wifi-basic-cl/conf-light/states.d/wpasup-conf.yml: https://raw.githubusercontent.com/vbotka/ansible-freebsd-custom-image/master/contrib/example-wifi-basic-cl/conf-light/states.d/wpasup-conf.yml

.. _templates/loader.conf.j2: https://raw.githubusercontent.com/vbotka/ansible-config-light/master/templates/loader.conf.j2
.. _templates/wpa_supplicant.conf.wlan0.j2: https://raw.githubusercontent.com/vbotka/ansible-config-light/master/templates/wpa_supplicant.conf.wlan0.j2