Ansible role: rpi_network

This role does the following:

• Configures wireless adapters (built in and external USB) to have persistent names (wlan0, wlan1 etc.) based on MAC addresses
• Sets up wireless adapter to get IP address from DHCP
• Sets up wired ethernet adapter to get IP address from DHCP
• Sets up wired ethernet adapter to get additional static IP address
• Sets up default IP route via configured default gateway

Requirements

NOTE: Role requires Fact Gathering by ansible!

One of the following distros (or derivatives) required:

• Debian | Raspberry Pi OS | Raspbian | Minibian
  • jessie
  • stretch
  • bullseye

Role Variables

ATTENTION! If rpi_network_wireless is set to true, then make sure you override the vault_rpi_network_wifi_APs var as it contains a sensitive data for your wireless networks, such as WPA passphrase and network ESSID...

It is highly recommended to encrypt with [ansible-vault][ansible-vault-link].

Before running any playbook which uses this role, add the following to ansible.cfg:

[defaults]
vault_password_file = .vault.key

Dependencies

None

Example Playboouk

- hosts: rpi_3
  gather_facts: yes

  vars_files:
  - vars/vault.yml  # Use of ansible-vault is strongly encouraged for storing sensitive info

  roles:
  - role: drew1kun.rpi_network
    rpi_network_LAN_ip: 10.0.0.1
    rpi_network_LAN_netmask: 255.255.255.0
    rpi_network_LAN_gw: 10.0.0.254
    rpi_network_wifi_APs:
    - id_str: home
      hidden: no
      essid: "{{ vault_rpi_bootstrap__rpi_network_wifi_APs[0].essid }}"
      passphrase: "{{ vault_rpi_bootstrap__rpi_network_wifi_APs[0].passphrase }}"
      priority: 10
    when: ansible_os_family == 'Debian'

vars/vault.yml:

vault_rpi_bootstrap__rpi_network_wifi_APs:
# only sensitive stuff goes here:
- essid: YourSensitiveESSID
  passphrase: YourSecureWPA_Passphrase

License

MIT

Author Information

Andrew Shagayev | e-mail