aboutsummaryrefslogtreecommitdiffstats
path: root/roles/linux_laptop
diff options
context:
space:
mode:
Diffstat (limited to 'roles/linux_laptop')
-rw-r--r--roles/linux_laptop/README.md43
-rw-r--r--roles/linux_laptop/defaults/main.yml2
2 files changed, 44 insertions, 1 deletions
diff --git a/roles/linux_laptop/README.md b/roles/linux_laptop/README.md
new file mode 100644
index 0000000..598170e
--- /dev/null
+++ b/roles/linux_laptop/README.md
@@ -0,0 +1,43 @@
+Linux Laptop
+============
+
+Description
+-----------
+
+The `linux_laptop` role performs various setup tasks for Linux laptops,
+such as configuring power-saving tuneables and creating a WiFi connection
+using certificate-based authentication.
+
+For WiFi authentication to work, you'll need a RADIUS server configured with
+the [freeradius](../freeradius/) role.
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable | Default | Description
+-----------------------------------------|-----------------------------|------------
+`linux_laptop_access_group` | `role-linux-desktop-access` | FreeIPA group allowed to login to GDM (will be created)
+`linux_laptop_wifi_ssid` |   | SSID of local WiFi network
+`linux_laptop_wifi_ip` | `{{ ip }}` | Static IPv4 address for WiFi connection
+`linux_laptop_wifi_prefix` | `{{ vlan.cidr }}` prefix | Network prefix for WiFi connection
+`linux_laptop_wifi_gateway` | `{{ vlan.gateway }}` | Gateway for WiFi connection
+`linux_laptop_wifi_domain` | `{{ domain }}` | Default DNS domain for WiFi connection
+`linux_laptop_wifi_dns_servers` | `{{ vlan.dns_servers }}` | DNS serers for WiFi connection
+`linux_laptop_wlan_device` | `wlan0` | Wireless network interface name
+`linux_laptop_dirty_writeback_centisecs` | 6000 | [Disk writeback interval](https://www.kernel.org/doc/html/latest/admin-guide/sysctl/vm.html#dirty-writeback-centisecs)
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- hosts: linux_laptops
+ roles:
+ - role: linux_laptop
+ vars:
+ linux_laptop_access_group: laptop-users
+ linux_laptop_wifi_ssid: exampleorg-wifi
+````
diff --git a/roles/linux_laptop/defaults/main.yml b/roles/linux_laptop/defaults/main.yml
index adaa6b2..b003835 100644
--- a/roles/linux_laptop/defaults/main.yml
+++ b/roles/linux_laptop/defaults/main.yml
@@ -3,7 +3,7 @@ linux_laptop_wifi_ssid: '{{ wifi_ssid }}'
linux_laptop_wifi_ip: '{{ ip }}'
linux_laptop_wifi_prefix: "{{ vlan.cidr | ansible.utils.ipaddr('prefix') }}"
linux_laptop_wifi_gateway: '{{ vlan.gateway }}'
-linux_laptop_wifi_domain: '{{ ansible_domain }}'
+linux_laptop_wifi_domain: '{{ domain }}'
linux_laptop_wifi_dns_servers: '{{ vlan.dns_servers }}'
linux_laptop_wlan_device: wlan0
linux_laptop_dirty_writeback_centisecs: 6000