ansible-wifi

Un rôle Ansible simple pour installer et configurer wpa_supplicant sur des systèmes de type Debian.

Exigences

• un utilisateur avec des permissions sudo

Installer le rôle via Ansible Galaxy

Exécution typique :

$ ansible-galaxy install layereight.wifi

Si vous souhaitez installer une version spécifique dans une collection avec d'autres rôles en utilisant un fichier de rôle :

$ ansible-galaxy install -r roles.yml

roles.yml

- name: layereight.wifi
  src: layereight.wifi
  version: "1.3.0"

• voir aussi la documentation d'Ansible Galaxy et l' introduction à Ansible Galaxy

Variables de rôle

obligatoires

• wifi_ssid : Le SSID de votre Wifi.

• wifi_psk : Le mot de passe de votre Wifi.

optionnelles

• wifi_country

  • par défaut : "DE"
  • description : Code de pays pour le pays dans lequel le dispositif Wifi fonctionne actuellement.

• wifi_control_interface_access_group

  • par défaut : root
  • description : Utilisé potentiellement pour permettre aux utilisateurs non-root d'utiliser l'interface de contrôle. voir wpa_supplicant pour plus d'informations

• wifi_apt_cache_valid_time

  • par défaut : 86400
  • description : Nombre de secondes pendant lesquelles le cache APT est valide.

• wifi_rfkill_unblock

  • par défaut : true
  • description : Débloquer l'interface wifi en utilisant rfkill lorsque ce paramètre est réglé sur true.

• wifi_disable_dhcpcd_workaround

  • par défaut : false
  • description : dhcpcd interfère avec la configuration normale des interfaces pour wpa_supplicant. Cette solution contourne désactivera dhcpcd pour l'interface donnée wifi_disable_dhcpcd_workaround_interface ainsi que le hook de wpa_supplicant.

• wifi_disable_dhcpcd_workaround_interface

  • par défaut : wlan0
  • description : L'interface réseau pour laquelle nous appliquerons le wifi_disable_dhcpcd_workaround.

Exemple de Playbook

Exécution typique de playbook :

$ ansible-playbook -i inventory wifi.yml

inventory

[wifihosts]
myhost ansible_host=192.168.0.101 ansible_user=myuser ansible_ssh_pass=password 

wifi.yml

- hosts: wifihosts
  
  roles:
    - layereight.wifi
  
  vars:
    wifi_ssid: "mon_nom_de_wifi"
    wifi_psk: "mon_mot_de_passe_wifi"