mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
b25f0f3cd2
* New module: shutdown
* Add symlink to plugin
* Fix
Signed-off-by: Amin Vakil <info@aminvakil.com>
* Fix
* Fix
* Add seealso
* Fix seealso
* Add future-import, metaclass boilerplate
* Change pre_shutdown_delay to delay
* Cleanup before executing shutdown
* Fix
* Remove unused connect_timeout paramater
* Improve documentation
* Remove deprecated function and calling it
* Remove double calling delay function
* Remove unneeded call in check delay function
* Make check mode more realistic
* Remove extra blank line
* Remove unnecessary imports and fix copyright year
* Add shutdown_command and integration test
* Fix integration test
* Don't fail on local AND enabled check_mode
* Add copyright
* Skip ubuntu1804 as systemd-sysv is not installed on container
* Ignore ubuntu 18 on task
* Readd integration tests
* Do not run integration test on ubuntu 18
* Improve integration test and add delay, msg testing
* Fix ubuntu 18 integration test
* Remove unnecessary condition
(cherry picked from commit c475effeed)
68 lines
2 KiB
Python
68 lines
2 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
# Copyright: (c) 2020, Ansible Project
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
|
|
DOCUMENTATION = r'''
|
|
module: shutdown
|
|
short_description: Shut down a machine
|
|
notes:
|
|
- C(PATH) is ignored on the remote node when searching for the C(shutdown) command. Use I(search_paths)
|
|
to specify locations to search if the default paths do not work.
|
|
description:
|
|
- Shut downs a machine.
|
|
version_added: "1.1.0"
|
|
options:
|
|
delay:
|
|
description:
|
|
- Seconds to wait before shutdown. Passed as a parameter to the shutdown command.
|
|
- On Linux, macOS and OpenBSD, this is converted to minutes and rounded down. If less than 60, it will be set to 0.
|
|
- On Solaris and FreeBSD, this will be seconds.
|
|
type: int
|
|
default: 0
|
|
msg:
|
|
description:
|
|
- Message to display to users before shutdown.
|
|
type: str
|
|
default: Shut down initiated by Ansible
|
|
search_paths:
|
|
description:
|
|
- Paths to search on the remote machine for the C(shutdown) command.
|
|
- I(Only) these paths will be searched for the C(shutdown) command. C(PATH) is ignored in the remote node when searching for the C(shutdown) command.
|
|
type: list
|
|
elements: path
|
|
default: ['/sbin', '/usr/sbin', '/usr/local/sbin']
|
|
|
|
seealso:
|
|
- module: ansible.builtin.reboot
|
|
author:
|
|
- Matt Davis (@nitzmahone)
|
|
- Sam Doran (@samdoran)
|
|
- Amin Vakil (@aminvakil)
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
- name: Unconditionally shut down the machine with all defaults
|
|
community.general.shutdown:
|
|
|
|
- name: Delay shutting down the remote node
|
|
community.general.shutdown:
|
|
delay: 60
|
|
|
|
- name: Shut down a machine with shutdown command in unusual place
|
|
community.general.shutdown:
|
|
search_paths:
|
|
- '/lib/molly-guard'
|
|
'''
|
|
|
|
RETURN = r'''
|
|
shutdown:
|
|
description: C(true) if the machine has been shut down.
|
|
returned: always
|
|
type: bool
|
|
sample: true
|
|
'''
|