mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Added documentation for nova inventory system
This commit is contained in:
parent
7fed89b51d
commit
cdb8343ec6
1 changed files with 110 additions and 42 deletions
|
@ -1,46 +1,5 @@
|
||||||
#!/usr/bin/python
|
#!/usr/bin/python
|
||||||
|
|
||||||
"""
|
|
||||||
OpenStack external inventory script
|
|
||||||
=================================
|
|
||||||
|
|
||||||
Generates inventory that Ansible can understand by making API request to
|
|
||||||
OpenStack endpoint using the novaclient library.
|
|
||||||
|
|
||||||
NOTE: This script assumes Ansible is being executed where the environment
|
|
||||||
variables needed for novaclient have already been set on nova.ini file
|
|
||||||
|
|
||||||
For more details, see: https://github.com/openstack/python-novaclient
|
|
||||||
|
|
||||||
When run against a specific host, this script returns the following variables:
|
|
||||||
os_os-ext-sts_task_state
|
|
||||||
os_addresses
|
|
||||||
os_links
|
|
||||||
os_image
|
|
||||||
os_os-ext-sts_vm_state
|
|
||||||
os_flavor
|
|
||||||
os_id
|
|
||||||
os_rax-bandwidth_bandwidth
|
|
||||||
os_user_id
|
|
||||||
os_os-dcf_diskconfig
|
|
||||||
os_accessipv4
|
|
||||||
os_accessipv6
|
|
||||||
os_progress
|
|
||||||
os_os-ext-sts_power_state
|
|
||||||
os_metadata
|
|
||||||
os_status
|
|
||||||
os_updated
|
|
||||||
os_hostid
|
|
||||||
os_name
|
|
||||||
os_created
|
|
||||||
os_tenant_id
|
|
||||||
os__info
|
|
||||||
os__loaded
|
|
||||||
|
|
||||||
where some item can have nested structure.
|
|
||||||
|
|
||||||
"""
|
|
||||||
|
|
||||||
# (c) 2012, Marco Vito Moscaritolo <marco@agavee.com>
|
# (c) 2012, Marco Vito Moscaritolo <marco@agavee.com>
|
||||||
#
|
#
|
||||||
# This file is part of Ansible,
|
# This file is part of Ansible,
|
||||||
|
@ -58,7 +17,116 @@ where some item can have nested structure.
|
||||||
# You should have received a copy of the GNU General Public License
|
# You should have received a copy of the GNU General Public License
|
||||||
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
######################################################################
|
DOCUMENTATION = '''
|
||||||
|
---
|
||||||
|
inventory: nova
|
||||||
|
short_description: OpenStack external inventory script
|
||||||
|
description:
|
||||||
|
- Generates inventory that Ansible can understand by making API request to OpenStack endpoint using the novaclient library.
|
||||||
|
- |
|
||||||
|
When run against a specific host, this script returns the following variables:
|
||||||
|
os_os-ext-sts_task_state
|
||||||
|
os_addresses
|
||||||
|
os_links
|
||||||
|
os_image
|
||||||
|
os_os-ext-sts_vm_state
|
||||||
|
os_flavor
|
||||||
|
os_id
|
||||||
|
os_rax-bandwidth_bandwidth
|
||||||
|
os_user_id
|
||||||
|
os_os-dcf_diskconfig
|
||||||
|
os_accessipv4
|
||||||
|
os_accessipv6
|
||||||
|
os_progress
|
||||||
|
os_os-ext-sts_power_state
|
||||||
|
os_metadata
|
||||||
|
os_status
|
||||||
|
os_updated
|
||||||
|
os_hostid
|
||||||
|
os_name
|
||||||
|
os_created
|
||||||
|
os_tenant_id
|
||||||
|
os__info
|
||||||
|
os__loaded
|
||||||
|
|
||||||
|
where some item can have nested structure.
|
||||||
|
- All information are set on B(nova.ini) file
|
||||||
|
version_added: None
|
||||||
|
options:
|
||||||
|
version:
|
||||||
|
description:
|
||||||
|
- OpenStack version to use.
|
||||||
|
required: true
|
||||||
|
default: null
|
||||||
|
choices: [ "1.1", "2" ]
|
||||||
|
username:
|
||||||
|
description:
|
||||||
|
- Username used to authenticate in OpenStack.
|
||||||
|
required: true
|
||||||
|
default: null
|
||||||
|
api_key:
|
||||||
|
description:
|
||||||
|
- Password used to authenticate in OpenStack, can be the ApiKey on some authentication system.
|
||||||
|
required: true
|
||||||
|
default: null
|
||||||
|
auth_url:
|
||||||
|
description:
|
||||||
|
- Authentication URL required to generate token.
|
||||||
|
- To manage RackSpace use I(https://identity.api.rackspacecloud.com/v2.0/)
|
||||||
|
required: true
|
||||||
|
default: null
|
||||||
|
auth_system:
|
||||||
|
description:
|
||||||
|
- Authentication system used to login
|
||||||
|
- To manage RackSpace install B(rackspace-novaclient) and insert I(rackspace)
|
||||||
|
required: true
|
||||||
|
default: null
|
||||||
|
region_name:
|
||||||
|
description:
|
||||||
|
- Region name to use in request
|
||||||
|
- In RackSpace some value can be I(ORD) or I(DWF).
|
||||||
|
required: true
|
||||||
|
default: null
|
||||||
|
project_id:
|
||||||
|
description:
|
||||||
|
- Project ID to use in connection
|
||||||
|
- In RackSpace use OS_TENANT_NAME
|
||||||
|
required: false
|
||||||
|
default: null
|
||||||
|
endpoint_type:
|
||||||
|
description:
|
||||||
|
- The endpoint type for novaclient
|
||||||
|
- In RackSpace use 'publicUrl'
|
||||||
|
required: false
|
||||||
|
default: null
|
||||||
|
service_type:
|
||||||
|
description:
|
||||||
|
- The service type you are managing.
|
||||||
|
- In RackSpace use 'compute'
|
||||||
|
required: false
|
||||||
|
default: null
|
||||||
|
service_name:
|
||||||
|
description:
|
||||||
|
- The service name you are managing.
|
||||||
|
- In RackSpace use 'cloudServersOpenStack'
|
||||||
|
required: false
|
||||||
|
default: null
|
||||||
|
insicure:
|
||||||
|
description:
|
||||||
|
- To no check security
|
||||||
|
required: false
|
||||||
|
default: false
|
||||||
|
choices: [ "true", "false" ]
|
||||||
|
author: Marco Vito Moscaritolo
|
||||||
|
notes:
|
||||||
|
- This script assumes Ansible is being executed where the environment variables needed for novaclient have already been set on nova.ini file
|
||||||
|
- For more details, see U(https://github.com/openstack/python-novaclient)
|
||||||
|
examples:
|
||||||
|
- description: List instances
|
||||||
|
code: nova.py --list
|
||||||
|
- description: Instance property
|
||||||
|
code: nova.py --instance INSTANCE_IP
|
||||||
|
'''
|
||||||
|
|
||||||
|
|
||||||
import sys
|
import sys
|
||||||
|
|
Loading…
Reference in a new issue