feat ✨: Enable Wake-on-LAN persistently

This commit introduces persistent Wake-on-LAN support for Proxmox VE via Ansible. It includes YAML configuration options for the interface, verification, and systemd service management, ensuring reliable functionality after Ansible role execution. The changes also address ignoring outputs and temporary files for a cleaner setup.

.gitignore

@@ -1,3 +1,24 @@
-# ---> Ansible
+# Ansible specific (optional - ignore temporary output or secrets)
 *.retry
+*.vault
+*.vault_pass
+*.secret
+*.log
 
+# VSCode settings
+.vscode/
+*.code-workspace
+
+# Windows system files
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+*.lnk
+
+# Backup files
+*~
+*.bak
+*.swp
+*.swo
+*.tmp

README.md

@@ -1,2 +1,29 @@
 # ansible_proxmox_WOL
 
+This Ansible role enables persistent Wake-on-LAN (WOL) on a Proxmox VE server.
+
+## Variables
+
+| Variable | Default | Description |
+|--------|---------|-------------|
+| wol_interface | eno1 | Network interface |
+| wol_mode | g | WOL mode (magic packet) |
+| wol_verify | true | Verify WOL status |
+
+
+## Requirements
+
+Use the physical NIC, not vmbr0, unless your NIC supports WOL through the bridge
+Common interfaces:  eno1, enp3s0, eth0
+Verify BIOS/UEFI:   Enable Wake on LAN
+Disable ErP / Deep Sleep
+
+## Example Playbook
+
+```yaml
+- hosts: proxmox
+  become: true
+  roles:
+    - role: ansible_proxmox_WOL
+      vars:
+        wol_interface: vmbr0

defaults/main.yml

@@ -0,0 +1,9 @@
+# Network interface to enable Wake-on-LAN on
+wol_interface: "eno1"
+
+# WOL mode:
+# g = magic packet (most common)
+wol_mode: "g"
+
+# Enable verification task
+wol_verify: true

handlers/main.yml

@@ -0,0 +1,9 @@
+---
+- name: Reload systemd
+  command: systemctl daemon-reexec
+
+- name: Enable and start WOL service
+  systemd:
+    name: wol.service
+    enabled: yes
+    state: started

tasks/main.yml

@@ -0,0 +1,32 @@
+---
+- name: Install required packages
+  apt:
+    name: ethtool
+    state: present
+    update_cache: yes
+
+- name: Create systemd service for Wake-on-LAN
+  template:
+    src: wol.service.j2
+    dest: /etc/systemd/system/wol.service
+    owner: root
+    group: root
+    mode: '0644'
+  notify:
+    - Reload systemd
+    - Enable and start WOL service
+
+- name: Enable WOL immediately (without reboot)
+  command: ethtool -s {{ wol_interface }} wol {{ wol_mode }}
+  changed_when: false
+
+- name: Verify Wake-on-LAN status
+  command: ethtool {{ wol_interface }}
+  register: wol_status
+  changed_when: false
+  when: wol_verify
+
+- name: Show WOL status
+  debug:
+    msg: "{{ wol_status.stdout_lines }}"
+  when: wol_verify

templates/wol.service.j2

@@ -0,0 +1,10 @@
+[Unit]
+Description=Enable Wake-on-LAN
+After=network.target
+
+[Service]
+Type=oneshot
+ExecStart=/sbin/ethtool -s {{ wol_interface }} wol {{ wol_mode }}
+
+[Install]
+WantedBy=multi-user.target