mirror of https://github.com/ansible/ansible.git
utilities: Clean up parameter types and add seealso (#53063)
* utilities: Clean up parameter types and add seealso * Add inventory modules * Add more references, clarify with-loopspull/53449/head
Dag Wieers
7 years ago
committed by
GitHub
parent
77a03af394
commit
f47191674e
@ -1,81 +1,83 @@
|
|||||||
# -*- mode: python -*-
|
# -*- mode: python -*-
|
||||||
#
|
|
||||||
|
# Copyright: (c) 2012, Seth Vidal (@skvidal)
|
||||||
# Copyright: Ansible Team
|
# Copyright: Ansible Team
|
||||||
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
# 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
|
from __future__ import absolute_import, division, print_function
|
||||||
__metaclass__ = type
|
__metaclass__ = type
|
||||||
|
|
||||||
|
|
||||||
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
||||||
'status': ['stableinterface'],
|
'status': ['stableinterface'],
|
||||||
'supported_by': 'core'}
|
'supported_by': 'core'}
|
||||||
|
|
||||||
|
|
||||||
DOCUMENTATION = r'''
|
DOCUMENTATION = r'''
|
||||||
---
|
---
|
||||||
module: add_host
|
module: add_host
|
||||||
short_description: add a host (and alternatively a group) to the ansible-playbook in-memory inventory
|
short_description: Add a host (and alternatively a group) to the ansible-playbook in-memory inventory
|
||||||
description:
|
description:
|
||||||
- Use variables to create new hosts and groups in inventory for use in later plays of the same playbook.
|
- Use variables to create new hosts and groups in inventory for use in later plays of the same playbook.
|
||||||
Takes variables so you can define the new hosts more fully.
|
- Takes variables so you can define the new hosts more fully.
|
||||||
- This module is also supported for Windows targets.
|
- This module is also supported for Windows targets.
|
||||||
version_added: "0.9"
|
version_added: "0.9"
|
||||||
options:
|
options:
|
||||||
name:
|
name:
|
||||||
aliases: [ 'hostname', 'host' ]
|
|
||||||
description:
|
description:
|
||||||
- The hostname/ip of the host to add to the inventory, can include a colon and a port number.
|
- The hostname/ip of the host to add to the inventory, can include a colon and a port number.
|
||||||
|
type: str
|
||||||
required: true
|
required: true
|
||||||
|
aliases: [ host, hostname ]
|
||||||
groups:
|
groups:
|
||||||
aliases: [ 'groupname', 'group' ]
|
|
||||||
description:
|
description:
|
||||||
- The groups to add the hostname to, comma separated.
|
- The groups to add the hostname to.
|
||||||
required: false
|
type: list
|
||||||
|
aliases: [ group, groupname ]
|
||||||
notes:
|
notes:
|
||||||
- This module bypasses the play host loop and only runs once for all the hosts in the play, if you need it
|
- This module bypasses the play host loop and only runs once for all the hosts in the play, if you need it
|
||||||
to iterate use a with\_ directive.
|
to iterate use a with-loop construct.
|
||||||
- Windows targets are supported by this module.
|
- The alias C(host) of the parameter C(name) is only available on Ansible 2.4 and newer.
|
||||||
- The alias 'host' of the parameter 'name' is only available on >=2.4
|
- Since Ansible 2.4, the C(inventory_dir) variable is now set to C(None) instead of the 'global inventory source',
|
||||||
- Since Ansible version 2.4, the ``inventory_dir`` variable is now set to ``None`` instead of the 'global inventory source',
|
because you can now have multiple sources. An example was added that shows how to partially restore the previous behaviour.
|
||||||
because you can now have multiple sources. An example was added that shows how to partially restore the previous behaviour.
|
- Windows targets are supported by this module.
|
||||||
|
seealso:
|
||||||
|
- module: group_by
|
||||||
author:
|
author:
|
||||||
- "Ansible Core Team"
|
- Ansible Core Team
|
||||||
- "Seth Vidal (@skvidal)"
|
- Seth Vidal (@skvidal)
|
||||||
'''
|
'''
|
||||||
|
|
||||||
EXAMPLES = '''
|
EXAMPLES = r'''
|
||||||
- name: add host to group 'just_created' with variable foo=42
|
- name: Add host to group 'just_created' with variable foo=42
|
||||||
add_host:
|
add_host:
|
||||||
name: "{{ ip_from_ec2 }}"
|
name: '{{ ip_from_ec2 }}'
|
||||||
groups: just_created
|
groups: just_created
|
||||||
foo: 42
|
foo: 42
|
||||||
|
|
||||||
- name: add host to multiple groups
|
- name: Add host to multiple groups
|
||||||
add_host:
|
add_host:
|
||||||
hostname: "{{ new_ip }}"
|
hostname: '{{ new_ip }}'
|
||||||
groups:
|
groups:
|
||||||
- group1
|
- group1
|
||||||
- group2
|
- group2
|
||||||
|
|
||||||
- name: add a host with a non-standard port local to your machines
|
- name: Add a host with a non-standard port local to your machines
|
||||||
add_host:
|
add_host:
|
||||||
name: "{{ new_ip }}:{{ new_port }}"
|
name: '{{ new_ip }}:{{ new_port }}'
|
||||||
|
|
||||||
- name: add a host alias that we reach through a tunnel (Ansible <= 1.9)
|
- name: Add a host alias that we reach through a tunnel (Ansible 1.9 and older)
|
||||||
add_host:
|
add_host:
|
||||||
hostname: "{{ new_ip }}"
|
hostname: '{{ new_ip }}'
|
||||||
ansible_ssh_host: "{{ inventory_hostname }}"
|
ansible_ssh_host: '{{ inventory_hostname }}'
|
||||||
ansible_ssh_port: "{{ new_port }}"
|
ansible_ssh_port: '{{ new_port }}'
|
||||||
|
|
||||||
- name: add a host alias that we reach through a tunnel (Ansible >= 2.0)
|
- name: Add a host alias that we reach through a tunnel (Ansible 2.0 and newer)
|
||||||
add_host:
|
add_host:
|
||||||
hostname: "{{ new_ip }}"
|
hostname: '{{ new_ip }}'
|
||||||
ansible_host: "{{ inventory_hostname }}"
|
ansible_host: '{{ inventory_hostname }}'
|
||||||
ansible_port: "{{ new_port }}"
|
ansible_port: '{{ new_port }}'
|
||||||
|
|
||||||
- name: Ensure inventory vars are set to the same value as the inventory_hostname has (close to pre 2.4 behaviour)
|
- name: Ensure inventory vars are set to the same value as the inventory_hostname has (close to pre Ansible 2.4 behaviour)
|
||||||
add_host:
|
add_host:
|
||||||
hostname: charlie
|
hostname: charlie
|
||||||
inventory_dir: "{{inventory_dir}}"
|
inventory_dir: '{{ inventory_dir }}'
|
||||||
'''
|
'''
|
||||||
|
|||||||
@ -1,43 +1,45 @@
|
|||||||
#!/usr/bin/python
|
#!/usr/bin/python
|
||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
|
|
||||||
# Copyright 2012 Dag Wieers <dag@wieers.com>
|
# Copyright: (c) 2012, Dag Wieers <dag@wieers.com>
|
||||||
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
# 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
|
from __future__ import absolute_import, division, print_function
|
||||||
__metaclass__ = type
|
__metaclass__ = type
|
||||||
|
|
||||||
|
|
||||||
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
||||||
'status': ['stableinterface'],
|
'status': ['stableinterface'],
|
||||||
'supported_by': 'core'}
|
'supported_by': 'core'}
|
||||||
|
|
||||||
|
DOCUMENTATION = r'''
|
||||||
DOCUMENTATION = '''
|
|
||||||
---
|
---
|
||||||
module: fail
|
module: fail
|
||||||
short_description: Fail with custom message
|
short_description: Fail with custom message
|
||||||
description:
|
description:
|
||||||
- This module fails the progress with a custom message. It can be
|
- This module fails the progress with a custom message.
|
||||||
useful for bailing out when a certain condition is met using C(when).
|
- It can be useful for bailing out when a certain condition is met using C(when).
|
||||||
- This module is also supported for Windows targets.
|
- This module is also supported for Windows targets.
|
||||||
version_added: "0.8"
|
version_added: "0.8"
|
||||||
options:
|
options:
|
||||||
msg:
|
msg:
|
||||||
description:
|
description:
|
||||||
- The customized message used for failing execution. If omitted,
|
- The customized message used for failing execution.
|
||||||
fail will simply bail out with a generic message.
|
- If omitted, fail will simply bail out with a generic message.
|
||||||
required: false
|
type: str
|
||||||
default: "'Failed as requested from task'"
|
default: Failed as requested from task
|
||||||
notes:
|
notes:
|
||||||
- This module is also supported for Windows targets.
|
- This module is also supported for Windows targets.
|
||||||
|
seealso:
|
||||||
author: "Dag Wieers (@dagwieers)"
|
- module: assert
|
||||||
|
- module: debug
|
||||||
|
- module: meta
|
||||||
|
author:
|
||||||
|
- Dag Wieers (@dagwieers)
|
||||||
'''
|
'''
|
||||||
|
|
||||||
EXAMPLES = '''
|
EXAMPLES = r'''
|
||||||
# Example playbook using fail and when together
|
# Example playbook using fail and when together
|
||||||
- fail:
|
- fail:
|
||||||
msg: "The system may not be provisioned according to the CMDB status."
|
msg: The system may not be provisioned according to the CMDB status.
|
||||||
when: cmdb_status != "to-be-staged"
|
when: cmdb_status != "to-be-staged"
|
||||||
'''
|
'''
|
||||||
|
|||||||
Loading…
Reference in New Issue