Configure wifi by config_light

Instead of the Customization 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 Quick start guide. The playbook pb-wifi-basic.yml created in the Quick start guide 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 Quick start guide (19-48).

contrib/example-wifi-basic-cl/pb-wifi-basic-cl.yml

- name: Configure wireless network in the mounted system image
  hosts: images.example.com

  connection: ssh
  remote_user: admin
  become: true
  become_user: root
  become_method: ansible.builtin.sudo

  vars:
    cl_dird: "{{ playbook_dir }}/conf-light"
    cl_assemble_validate: ansible-lint -x 205 %s
    cl_loaderconf_modules: "{{ cimage_loaderconf_modules }}"
    cl_loaderconf_data: "{{ cimage_loaderconf_data }}"
    cl_loaderconf_sysctl: "{{ cimage_loaderconf_sysctl }}"
    cl_wpasupconf_global: []
    cl_wpasupconf_wlan0: "{{ cimage_wpasupconf_data| selectattr('dev', 'eq', 'wlan0')|first }}"

    cimage_sanity: false
    cimage_install: false
    cimage_debug: true
    cimage_debug_classified: true

    cimage_mount_path: /mnt3

    cimage_loaderconf_modules: [wlan, wlan_wep, wlan_ccmp, wlan_tkip, wlan_amrr, rtwn, if_rtwn_usb]
    cimage_loaderconf_data:
      - hw.usb.template=3
      - umodem_load="YES"
      - boot_multicons="YES"
      - boot_serial="YES"
      - beastie_disable="YES"
      - loader_color="NO"
      - legal.realtek.license_ack=1
    cimage_loaderconf_sysctl: []
    cimage_rcconf_data:
      - { key: wlans_rtwn0, value: '"wlan0"' }
      - { key: ifconfig_wlan0, value: '"WPA SYNCDHCP"' }

    cimage_wpasupconf_data:
      - dev: wlan0
        network:
          - conf:
              - { key: ssid, value: '"my_access_point"' }
              - { key: psk, value: '"my_password"' }
              - { key: disabled, value: "0" }
    cimage_wpasupconf_link: true
    cimage_wpasupconf_link_dev: wlan0

  roles:
    - vbotka.config_light

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

contrib/example-wifi-basic-cl/conf-light/states.d/wpasup-conf.yml

---
wpasup_conf:
  state: link
  force: true
  path: "{{ cimage_mount_path }}/etc/wpa_supplicant.conf"
  src: wpa_supplicant.conf.wlan0

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

 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 Quick start guide

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 Quick start guide.