poweroff
Poweroff
A role for powering off hosts.
By default the role will fail if the host is already down. If however
poweroff_strict is set to false, hosts will first be pinged and only
reachable hosts will be powered off.
Requirements
- Hosts should be bootstrapped for ansible usage (have python,...)
- Root privileges, eg
become: yes
Role Variables
| Variable | Description | Default value |
|---|---|---|
poweroff_strict |
Don't ignore offline/unreachable hosts | true |
poweroff_ping_delay |
Delay before pinging hosts (seconds) | 0 |
poweroff_ping_timeout |
Timeout when pinging hosts (seconds) | 30 |
poweroff_ping_port |
Port to ping | 22 |
poweroff_message |
Reboot message for the logs | 'Power off by Ansible' |
poweroff_interval |
Interval between poweroff and next task? | 'no' |
poweroff_interval_seconds |
Seconds to pause after poweroff | 0 |
Attention:
All boolean values can be used with either 'yes'/'no' or true/false.
This allows you to alter their value from the command line (-e "bool=yes")
without problems.
Dependencies
None.
Example Playbook
Performing a basic poweroff:
---
- hosts: servers
roles:
- { role: GROG.poweroff,
become: yes,
poweroff_message: 'Test poweroff role'
}
Contributing
All assistance, changes or ideas welcome!
Author
By G. Roggemans
License
MIT