mirror of
https://opendev.org/openstack/ansible-collections-openstack.git
synced 2026-03-27 05:53:02 +00:00
272 lines
8.3 KiB
Python
272 lines
8.3 KiB
Python
#!/usr/bin/python
|
|
|
|
# Copyright (c) 2014 Hewlett-Packard Development Company, L.P.
|
|
# Copyright (c) 2013, Benno Joy <benno@ansible.com>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
DOCUMENTATION = '''
|
|
---
|
|
module: network
|
|
short_description: Creates/removes networks from OpenStack
|
|
author: OpenStack Ansible SIG
|
|
description:
|
|
- Add or remove network from OpenStack (doesn't update network properties).
|
|
options:
|
|
name:
|
|
description:
|
|
- Name to be assigned to the network.
|
|
required: true
|
|
type: str
|
|
shared:
|
|
description:
|
|
- Whether this network is shared or not.
|
|
type: bool
|
|
default: 'no'
|
|
admin_state_up:
|
|
description:
|
|
- Whether the state should be marked as up or down.
|
|
type: bool
|
|
default: 'yes'
|
|
external:
|
|
description:
|
|
- Whether this network is externally accessible.
|
|
type: bool
|
|
default: 'no'
|
|
state:
|
|
description:
|
|
- Indicate desired state of the resource.
|
|
choices: ['present', 'absent']
|
|
default: present
|
|
type: str
|
|
provider_physical_network:
|
|
description:
|
|
- The physical network where this network object is implemented.
|
|
type: str
|
|
provider_network_type:
|
|
description:
|
|
- The type of physical network that maps to this network resource.
|
|
type: str
|
|
provider_segmentation_id:
|
|
description:
|
|
- An isolated segment on the physical network. The I(network_type)
|
|
attribute defines the segmentation model. For example, if the
|
|
I(network_type) value is vlan, this ID is a vlan identifier. If
|
|
the I(network_type) value is gre, this ID is a gre key.
|
|
type: int
|
|
project:
|
|
description:
|
|
- Project name or ID containing the network (name admin-only)
|
|
type: str
|
|
port_security_enabled:
|
|
description:
|
|
- Whether port security is enabled on the network or not.
|
|
Network will use OpenStack defaults if this option is
|
|
not utilised.
|
|
type: bool
|
|
mtu:
|
|
description:
|
|
- The maximum transmission unit (MTU) value to address fragmentation.
|
|
Network will use OpenStack defaults if this option is
|
|
not provided.
|
|
type: int
|
|
aliases: ['mtu_size']
|
|
dns_domain:
|
|
description:
|
|
- The DNS domain value to set.
|
|
Network will use Openstack defaults if this option is
|
|
not provided.
|
|
type: str
|
|
requirements:
|
|
- "python >= 3.6"
|
|
- "openstacksdk"
|
|
|
|
extends_documentation_fragment:
|
|
- openstack.cloud.openstack
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
# Create an externally accessible network named 'ext_network'.
|
|
- openstack.cloud.network:
|
|
cloud: mycloud
|
|
state: present
|
|
name: ext_network
|
|
external: true
|
|
'''
|
|
|
|
RETURN = '''
|
|
id:
|
|
description: Id of network
|
|
returned: On success when network exists.
|
|
type: str
|
|
network:
|
|
description: Dictionary describing the network.
|
|
returned: On success when network exists.
|
|
type: dict
|
|
contains:
|
|
availability_zone_hints:
|
|
description: Availability zone hints
|
|
type: str
|
|
availability_zones:
|
|
description: Availability zones
|
|
type: str
|
|
created_at:
|
|
description: Created at timestamp
|
|
type: str
|
|
description:
|
|
description: Description
|
|
type: str
|
|
dns_domain:
|
|
description: Dns domain
|
|
type: str
|
|
id:
|
|
description: Id
|
|
type: str
|
|
ipv4_address_scope_id:
|
|
description: Ipv4 address scope id
|
|
type: str
|
|
ipv6_address_scope_id:
|
|
description: Ipv6 address scope id
|
|
type: str
|
|
is_admin_state_up:
|
|
description: Is admin state up
|
|
type: str
|
|
is_default:
|
|
description: Is default
|
|
type: str
|
|
is_port_security_enabled:
|
|
description: Is port security enabled
|
|
type: str
|
|
is_router_external:
|
|
description: Is router external
|
|
type: str
|
|
is_shared:
|
|
description: Is shared
|
|
type: str
|
|
is_vlan_transparent:
|
|
description: Is vlan transparent
|
|
type: str
|
|
mtu:
|
|
description: Mtu
|
|
type: str
|
|
name:
|
|
description: Name
|
|
type: str
|
|
project_id:
|
|
description: Project id
|
|
type: str
|
|
provider_network_type:
|
|
description: Provider network type
|
|
type: str
|
|
provider_physical_network:
|
|
description: Provider physical network
|
|
type: str
|
|
provider_segmentation_id:
|
|
description: Provider segmentation id
|
|
type: str
|
|
qos_policy_id:
|
|
description: Qos policy id
|
|
type: str
|
|
revision_number:
|
|
description: Revision number
|
|
type: str
|
|
segments:
|
|
description: Segments
|
|
type: str
|
|
status:
|
|
description: Status
|
|
type: str
|
|
subnet_ids:
|
|
description: Subnet ids
|
|
type: str
|
|
tags:
|
|
description: Tags
|
|
type: str
|
|
updated_at:
|
|
description: Updated at timestamp
|
|
type: str
|
|
'''
|
|
|
|
from ansible_collections.openstack.cloud.plugins.module_utils.openstack import OpenStackModule
|
|
|
|
|
|
class NetworkModule(OpenStackModule):
|
|
|
|
argument_spec = dict(
|
|
name=dict(required=True),
|
|
shared=dict(default=False, type='bool'),
|
|
admin_state_up=dict(default=True, type='bool'),
|
|
external=dict(default=False, type='bool'),
|
|
provider_physical_network=dict(required=False),
|
|
provider_network_type=dict(required=False),
|
|
provider_segmentation_id=dict(required=False, type='int'),
|
|
state=dict(default='present', choices=['absent', 'present']),
|
|
project=dict(default=None),
|
|
port_security_enabled=dict(type='bool'),
|
|
mtu=dict(required=False, type='int', aliases=['mtu_size']),
|
|
dns_domain=dict(required=False)
|
|
)
|
|
|
|
def run(self):
|
|
|
|
state = self.params['state']
|
|
name = self.params['name']
|
|
shared = self.params['shared']
|
|
admin_state_up = self.params['admin_state_up']
|
|
external = self.params['external']
|
|
provider_physical_network = self.params['provider_physical_network']
|
|
provider_network_type = self.params['provider_network_type']
|
|
provider_segmentation_id = self.params['provider_segmentation_id']
|
|
project = self.params['project']
|
|
|
|
kwargs = {}
|
|
for arg in ('port_security_enabled', 'mtu', 'dns_domain'):
|
|
if self.params[arg] is not None:
|
|
kwargs[arg] = self.params[arg]
|
|
|
|
if project is not None:
|
|
proj = self.conn.identity.find_project(project, ignore_missing=False)
|
|
project_id = proj['id']
|
|
net_kwargs = {'project_id': project_id}
|
|
else:
|
|
project_id = None
|
|
net_kwargs = {}
|
|
net = self.conn.network.find_network(name, **net_kwargs)
|
|
|
|
if state == 'present':
|
|
if not net:
|
|
if provider_physical_network:
|
|
kwargs['provider_physical_network'] = provider_physical_network
|
|
if provider_network_type:
|
|
kwargs['provider_network_type'] = provider_network_type
|
|
if provider_segmentation_id:
|
|
kwargs['provider_segmentation_id'] = provider_segmentation_id
|
|
|
|
if project_id is not None:
|
|
kwargs['project_id'] = project_id
|
|
net = self.conn.network.create_network(name=name,
|
|
shared=shared,
|
|
admin_state_up=admin_state_up,
|
|
is_router_external=external,
|
|
**kwargs)
|
|
changed = True
|
|
net = net.to_dict(computed=False)
|
|
else:
|
|
changed = False
|
|
self.exit(changed=changed, network=net, id=net['id'])
|
|
|
|
elif state == 'absent':
|
|
if not net:
|
|
self.exit(changed=False)
|
|
else:
|
|
self.conn.network.delete_network(net['id'])
|
|
self.exit(changed=True)
|
|
|
|
|
|
def main():
|
|
module = NetworkModule()
|
|
module()
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|