mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-04-26 20:31:27 -07:00
0f893027c4
Start using this to construct shade OpenStack Cloud objects in a consistent manner. This will let us centralize things like dealing with password arguments and whatnot. It also allows us to introduce the ability to pass a fully formed config dict directly to the module. Migrate all OpenStack modules to use openstack_cloud_from_module. Have it return the shade library since it's responsible for importing shade and shade is needed for the exceptions. Only pull specific OpenStack arguments for the constructor Rather than passing **module.params to the shade constructor, pull out only the values that make sense. This should prevent the issues with module parameters stepping on shade parameters. Replace module.params.pop with module.params.get We don't need to pop these anymore since the shade constructor is now using opt-in values. Using real urls is ungood. Use example.com domains. Also, get rid of the antiquated port numbers.
218 lines
7.1 KiB
Python
218 lines
7.1 KiB
Python
#!/usr/bin/python
|
|
|
|
# Copyright (c) 2016 IBM
|
|
# 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
|
|
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'community'}
|
|
|
|
|
|
DOCUMENTATION = '''
|
|
module: os_port_facts
|
|
short_description: Retrieve facts about ports within OpenStack.
|
|
version_added: "2.1"
|
|
author: "David Shrewsbury (@Shrews)"
|
|
description:
|
|
- Retrieve facts about ports from OpenStack.
|
|
notes:
|
|
- Facts are placed in the C(openstack_ports) variable.
|
|
requirements:
|
|
- "python >= 2.6"
|
|
- "shade"
|
|
options:
|
|
port:
|
|
description:
|
|
- Unique name or ID of a port.
|
|
required: false
|
|
default: null
|
|
filters:
|
|
description:
|
|
- A dictionary of meta data to use for further filtering. Elements
|
|
of this dictionary will be matched against the returned port
|
|
dictionaries. Matching is currently limited to strings within
|
|
the port dictionary, or strings within nested dictionaries.
|
|
required: false
|
|
default: null
|
|
availability_zone:
|
|
description:
|
|
- Ignored. Present for backwards compatibility
|
|
required: false
|
|
extends_documentation_fragment: openstack
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
# Gather facts about all ports
|
|
- os_port_facts:
|
|
cloud: mycloud
|
|
|
|
# Gather facts about a single port
|
|
- os_port_facts:
|
|
cloud: mycloud
|
|
port: 6140317d-e676-31e1-8a4a-b1913814a471
|
|
|
|
# Gather facts about all ports that have device_id set to a specific value
|
|
# and with a status of ACTIVE.
|
|
- os_port_facts:
|
|
cloud: mycloud
|
|
filters:
|
|
device_id: 1038a010-3a37-4a9d-82ea-652f1da36597
|
|
status: ACTIVE
|
|
'''
|
|
|
|
RETURN = '''
|
|
openstack_ports:
|
|
description: List of port dictionaries. A subset of the dictionary keys
|
|
listed below may be returned, depending on your cloud provider.
|
|
returned: always, but can be null
|
|
type: complex
|
|
contains:
|
|
admin_state_up:
|
|
description: The administrative state of the router, which is
|
|
up (true) or down (false).
|
|
returned: success
|
|
type: boolean
|
|
sample: true
|
|
allowed_address_pairs:
|
|
description: A set of zero or more allowed address pairs. An
|
|
address pair consists of an IP address and MAC address.
|
|
returned: success
|
|
type: list
|
|
sample: []
|
|
"binding:host_id":
|
|
description: The UUID of the host where the port is allocated.
|
|
returned: success
|
|
type: string
|
|
sample: "b4bd682d-234a-4091-aa5b-4b025a6a7759"
|
|
"binding:profile":
|
|
description: A dictionary the enables the application running on
|
|
the host to pass and receive VIF port-specific
|
|
information to the plug-in.
|
|
returned: success
|
|
type: dict
|
|
sample: {}
|
|
"binding:vif_details":
|
|
description: A dictionary that enables the application to pass
|
|
information about functions that the Networking API
|
|
provides.
|
|
returned: success
|
|
type: dict
|
|
sample: {"port_filter": true}
|
|
"binding:vif_type":
|
|
description: The VIF type for the port.
|
|
returned: success
|
|
type: dict
|
|
sample: "ovs"
|
|
"binding:vnic_type":
|
|
description: The virtual network interface card (vNIC) type that is
|
|
bound to the neutron port.
|
|
returned: success
|
|
type: string
|
|
sample: "normal"
|
|
device_id:
|
|
description: The UUID of the device that uses this port.
|
|
returned: success
|
|
type: string
|
|
sample: "b4bd682d-234a-4091-aa5b-4b025a6a7759"
|
|
device_owner:
|
|
description: The UUID of the entity that uses this port.
|
|
returned: success
|
|
type: string
|
|
sample: "network:router_interface"
|
|
dns_assignment:
|
|
description: DNS assignment information.
|
|
returned: success
|
|
type: list
|
|
dns_name:
|
|
description: DNS name
|
|
returned: success
|
|
type: string
|
|
sample: ""
|
|
extra_dhcp_opts:
|
|
description: A set of zero or more extra DHCP option pairs.
|
|
An option pair consists of an option value and name.
|
|
returned: success
|
|
type: list
|
|
sample: []
|
|
fixed_ips:
|
|
description: The IP addresses for the port. Includes the IP address
|
|
and UUID of the subnet.
|
|
returned: success
|
|
type: list
|
|
id:
|
|
description: The UUID of the port.
|
|
returned: success
|
|
type: string
|
|
sample: "3ec25c97-7052-4ab8-a8ba-92faf84148de"
|
|
ip_address:
|
|
description: The IP address.
|
|
returned: success
|
|
type: string
|
|
sample: "127.0.0.1"
|
|
mac_address:
|
|
description: The MAC address.
|
|
returned: success
|
|
type: string
|
|
sample: "00:00:5E:00:53:42"
|
|
name:
|
|
description: The port name.
|
|
returned: success
|
|
type: string
|
|
sample: "port_name"
|
|
network_id:
|
|
description: The UUID of the attached network.
|
|
returned: success
|
|
type: string
|
|
sample: "dd1ede4f-3952-4131-aab6-3b8902268c7d"
|
|
port_security_enabled:
|
|
description: The port security status. The status is enabled (true) or disabled (false).
|
|
returned: success
|
|
type: boolean
|
|
sample: false
|
|
security_groups:
|
|
description: The UUIDs of any attached security groups.
|
|
returned: success
|
|
type: list
|
|
status:
|
|
description: The port status.
|
|
returned: success
|
|
type: string
|
|
sample: "ACTIVE"
|
|
tenant_id:
|
|
description: The UUID of the tenant who owns the network.
|
|
returned: success
|
|
type: string
|
|
sample: "51fce036d7984ba6af4f6c849f65ef00"
|
|
'''
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible.module_utils.openstack import openstack_full_argument_spec, openstack_module_kwargs, openstack_cloud_from_module
|
|
|
|
|
|
def main():
|
|
argument_spec = openstack_full_argument_spec(
|
|
port=dict(required=False),
|
|
filters=dict(type='dict', required=False),
|
|
)
|
|
module_kwargs = openstack_module_kwargs()
|
|
module = AnsibleModule(argument_spec, **module_kwargs)
|
|
|
|
port = module.params.get('port')
|
|
filters = module.params.get('filters')
|
|
|
|
shade, cloud = openstack_cloud_from_module(module)
|
|
try:
|
|
ports = cloud.search_ports(port, filters)
|
|
module.exit_json(changed=False, ansible_facts=dict(
|
|
openstack_ports=ports))
|
|
|
|
except shade.OpenStackCloudException as e:
|
|
module.fail_json(msg=str(e))
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|