__ __ __ __ _____ _ _ _____ _ _ _ | \/ | \ \ / / | __ \ (_) | | / ____| | | | | | \ / |_ __\ V / | |__) | __ ___ ____ _| |_ ___ | (___ | |__ ___| | | | |\/| | '__|> < | ___/ '__| \ \ / / _` | __/ _ \ \___ \| '_ \ / _ \ | | | | | | |_ / . \ | | | | | |\ V / (_| | || __/ ____) | | | | __/ | | |_| |_|_(_)_/ \_\ |_| |_| |_| \_/ \__,_|\__\___| |_____/|_| |_|\___V 2.1 if you need WebShell for Seo everyday contact me on Telegram Telegram Address : @jackleetFor_More_Tools:
# Copyright: (c) 2015, Hewlett-Packard Development Company, L.P.
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
DOCUMENTATION = '''
---
module: floating_ip
author: OpenStack Ansible SIG
short_description: Add/Remove floating IP from an instance
description:
- Add or Remove a floating IP to an instance.
- Returns the floating IP when attaching only if I(wait=true).
- When detaching a floating IP there might be a delay until an instance does not list the floating IP any more.
options:
server:
description:
- The name or ID of the instance to which the IP address
should be assigned.
required: true
type: str
network:
description:
- The name or ID of a neutron external network or a nova pool name.
type: str
floating_ip_address:
description:
- A floating IP address to attach or to detach. When I(state) is present
can be used to specify a IP address to attach. I(floating_ip_address)
requires I(network) to be set.
type: str
reuse:
description:
- When I(state) is present, and I(floating_ip_address) is not present,
this parameter can be used to specify whether we should try to reuse
a floating IP address already allocated to the project.
type: bool
default: 'no'
fixed_address:
description:
- To which fixed IP of server the floating IP address should be
attached to.
type: str
nat_destination:
description:
- The name or id of a neutron private network that the fixed IP to
attach floating IP is on
aliases: ["fixed_network", "internal_network"]
type: str
wait:
description:
- When attaching a floating IP address, specify whether to wait for it to appear as attached.
- Must be set to C(yes) for the module to return the value of the floating IP when attaching.
type: bool
default: 'no'
timeout:
description:
- Time to wait for an IP address to appear as attached. See wait.
required: false
default: 60
type: int
state:
description:
- Should the resource be present or absent.
choices: [present, absent]
default: present
type: str
purge:
description:
- When I(state) is absent, indicates whether or not to delete the floating
IP completely, or only detach it from the server. Default is to detach only.
type: bool
default: 'no'
requirements:
- "python >= 3.6"
- "openstacksdk"
extends_documentation_fragment:
- openstack.cloud.openstack
'''
EXAMPLES = '''
# Assign a floating IP to the first interface of `cattle001` from an existing
# external network or nova pool. A new floating IP from the first available
# external network is allocated to the project.
- openstack.cloud.floating_ip:
cloud: dguerri
server: cattle001
# Assign a new floating IP to the instance fixed ip `192.0.2.3` of
# `cattle001`. If a free floating IP is already allocated to the project, it is
# reused; if not, a new one is created.
- openstack.cloud.floating_ip:
cloud: dguerri
state: present
reuse: yes
server: cattle001
network: ext_net
fixed_address: 192.0.2.3
wait: true
timeout: 180
# Assign a new floating IP from the network `ext_net` to the instance fixed
# ip in network `private_net` of `cattle001`.
- openstack.cloud.floating_ip:
cloud: dguerri
state: present
server: cattle001
network: ext_net
nat_destination: private_net
wait: true
timeout: 180
# Detach a floating IP address from a server
- openstack.cloud.floating_ip:
cloud: dguerri
state: absent
floating_ip_address: 203.0.113.2
server: cattle001
'''
from ansible_collections.openstack.cloud.plugins.module_utils.openstack import OpenStackModule
import itertools
class NetworkingFloatingIPModule(OpenStackModule):
argument_spec = dict(
server=dict(required=True),
state=dict(default='present', choices=['absent', 'present']),
network=dict(required=False, default=None),
floating_ip_address=dict(required=False, default=None),
reuse=dict(required=False, type='bool', default=False),
fixed_address=dict(required=False, default=None),
nat_destination=dict(required=False, default=None,
aliases=['fixed_network', 'internal_network']),
wait=dict(required=False, type='bool', default=False),
timeout=dict(required=False, type='int', default=60),
purge=dict(required=False, type='bool', default=False),
)
module_kwargs = dict(
required_if=[
['state', 'absent', ['floating_ip_address']]
],
required_by=dict(
floating_ip_address=('network',)
)
)
def _get_floating_ip(self, floating_ip_address):
f_ips = self.conn.search_floating_ips(
filters={'floating_ip_address': floating_ip_address})
if not f_ips:
return None
return f_ips[0]
def _list_floating_ips(self, server):
return itertools.chain.from_iterable([
(addr['addr'] for addr in server.addresses[net] if addr['OS-EXT-IPS:type'] == 'floating')
for net in server.addresses
])
def _match_floating_ip(self, server,
floating_ip_address,
network_id,
fixed_address,
nat_destination):
if floating_ip_address:
return self._get_floating_ip(floating_ip_address)
elif not fixed_address and nat_destination:
nat_destination_name = self.conn.get_network(nat_destination)['name']
return next(
(self._get_floating_ip(addr['addr'])
for addr in server.addresses.get(nat_destination_name, [])
if addr['OS-EXT-IPS:type'] == 'floating'),
None)
else:
# not floating_ip_address and (fixed_address or not nat_destination)
# get any of the floating ips that matches fixed_address and/or network
f_ip_addrs = self._list_floating_ips(server)
f_ips = [f_ip for f_ip in self.conn.list_floating_ips() if f_ip['floating_ip_address'] in f_ip_addrs]
return next(
(f_ip for f_ip in f_ips
if ((fixed_address and f_ip.fixed_ip_address == fixed_address) or not fixed_address)
and ((network_id and f_ip.network == network_id) or not network_id)),
None)
def run(self):
server_name_or_id = self.params['server']
state = self.params['state']
network = self.params['network']
floating_ip_address = self.params['floating_ip_address']
reuse = self.params['reuse']
fixed_address = self.params['fixed_address']
nat_destination = self.params['nat_destination']
wait = self.params['wait']
timeout = self.params['timeout']
purge = self.params['purge']
server = self.conn.get_server(server_name_or_id)
if not server:
self.fail_json(
msg="server {0} not found".format(server_name_or_id))
# Extract floating ips from server
f_ip_addrs = self._list_floating_ips(server)
# Get details about requested floating ip
f_ip = self._get_floating_ip(floating_ip_address) if floating_ip_address else None
if network:
network_id = self.conn.get_network(name_or_id=network)["id"]
else:
network_id = None
if state == 'present':
if floating_ip_address and f_ip and floating_ip_address in f_ip_addrs:
# Floating ip address has been assigned to server
self.exit_json(changed=False, floating_ip=f_ip)
if f_ip and f_ip['attached'] and floating_ip_address not in f_ip_addrs:
# Requested floating ip has been attached to different server
self.fail_json(msg="floating-ip {floating_ip_address} already has been attached to different server"
.format(floating_ip_address=floating_ip_address))
if not floating_ip_address:
# No specific floating ip requested, i.e. if any floating ip is already assigned to server,
# check that it matches requirements.
if not fixed_address and nat_destination:
# Check if we have any floating ip on the given nat_destination network
nat_destination_name = self.conn.get_network(nat_destination)['name']
for addr in server.addresses.get(nat_destination_name, []):
if addr['OS-EXT-IPS:type'] == 'floating':
# A floating ip address has been assigned to the requested nat_destination
f_ip = self._get_floating_ip(addr['addr'])
self.exit_json(changed=False, floating_ip=f_ip)
# else fixed_address or not nat_destination, hence an
# analysis of all floating ips of server is required
f_ips = [f_ip for f_ip in self.conn.list_floating_ips() if f_ip['floating_ip_address'] in f_ip_addrs]
for f_ip in f_ips:
if network_id and f_ip.network != network_id:
# requested network does not match network of floating ip
continue
if not fixed_address and not nat_destination:
# any floating ip will fullfil these requirements
self.exit_json(changed=False, floating_ip=f_ip)
if fixed_address and f_ip.fixed_ip_address == fixed_address:
# a floating ip address has been assigned that points to the requested fixed_address
self.exit_json(changed=False, floating_ip=f_ip)
if floating_ip_address and not f_ip:
# openstacksdk's create_ip requires floating_ip_address and floating_network_id to be set
self.conn.network.create_ip(floating_ip_address=floating_ip_address, floating_network_id=network_id)
# Else floating ip either does not exist or has not been attached yet
# Both floating_ip_address and network are mutually exclusive in add_ips_to_server, i.e.
# add_ips_to_server will ignore floating_ip_address if network is set
# Ref.: https://github.com/openstack/openstacksdk/blob/a6b0ece2821ea79330c4067100295f6bdcbe456e/openstack/cloud/_floating_ip.py#L987
server = self.conn.add_ips_to_server(
server=server,
ips=floating_ip_address,
ip_pool=network if not floating_ip_address else None,
reuse=reuse,
fixed_address=fixed_address,
wait=wait,
timeout=timeout, nat_destination=nat_destination)
# Update the floating ip status
f_ip = self._match_floating_ip(server, floating_ip_address, network_id, fixed_address, nat_destination)
self.exit_json(changed=True, floating_ip=f_ip)
elif state == 'absent':
f_ip = self._match_floating_ip(server, floating_ip_address, network_id, fixed_address, nat_destination)
if not f_ip:
# Nothing to detach
self.exit_json(changed=False)
changed = False
if f_ip["fixed_ip_address"]:
self.conn.detach_ip_from_server(server_id=server['id'], floating_ip_id=f_ip['id'])
# OpenStackSDK sets {"port_id": None} to detach a floating ip from an instance,
# but there might be a delay until a server does not list it in addresses any more.
# Update the floating IP status
f_ip = self.conn.get_floating_ip(id=f_ip['id'])
changed = True
if purge:
self.conn.delete_floating_ip(f_ip['id'])
self.exit_json(changed=True)
self.exit_json(changed=changed, floating_ip=f_ip)
def main():
module = NetworkingFloatingIPModule()
module()
if __name__ == '__main__':
main()
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| __pycache__ | Folder | 0755 |
|
|
| __init__.py | File | 0 B | 0644 |
|
| address_scope.py | File | 5.98 KB | 0644 |
|
| auth.py | File | 1.33 KB | 0644 |
|
| baremetal_inspect.py | File | 4.19 KB | 0644 |
|
| baremetal_node.py | File | 15.53 KB | 0644 |
|
| baremetal_node_action.py | File | 12.65 KB | 0644 |
|
| baremetal_node_info.py | File | 21.74 KB | 0644 |
|
| baremetal_port.py | File | 11.64 KB | 0644 |
|
| baremetal_port_info.py | File | 6.83 KB | 0644 |
|
| catalog_service.py | File | 5.12 KB | 0644 |
|
| coe_cluster.py | File | 8.7 KB | 0644 |
|
| coe_cluster_template.py | File | 12.24 KB | 0644 |
|
| compute_flavor.py | File | 7.71 KB | 0644 |
|
| compute_flavor_info.py | File | 7.79 KB | 0644 |
|
| compute_service_info.py | File | 3.56 KB | 0644 |
|
| config.py | File | 1.97 KB | 0644 |
|
| container.py | File | 5.92 KB | 0644 |
|
| dns_zone.py | File | 6.98 KB | 0644 |
|
| dns_zone_info.py | File | 5.16 KB | 0644 |
|
| endpoint.py | File | 6.34 KB | 0644 |
|
| federation_idp.py | File | 6.31 KB | 0644 |
|
| federation_idp_info.py | File | 2.21 KB | 0644 |
|
| federation_mapping.py | File | 5.18 KB | 0644 |
|
| federation_mapping_info.py | File | 2.15 KB | 0644 |
|
| floating_ip.py | File | 12.14 KB | 0644 |
|
| floating_ip_info.py | File | 6.12 KB | 0644 |
|
| group_assignment.py | File | 2.29 KB | 0644 |
|
| host_aggregate.py | File | 7.21 KB | 0644 |
|
| identity_domain.py | File | 4.71 KB | 0644 |
|
| identity_domain_info.py | File | 3.13 KB | 0644 |
|
| identity_group.py | File | 4.18 KB | 0644 |
|
| identity_group_info.py | File | 4.1 KB | 0644 |
|
| identity_role.py | File | 2.66 KB | 0644 |
|
| identity_role_info.py | File | 2.23 KB | 0644 |
|
| identity_user.py | File | 7.86 KB | 0644 |
|
| identity_user_info.py | File | 4.27 KB | 0644 |
|
| image.py | File | 8.77 KB | 0644 |
|
| image_info.py | File | 5.72 KB | 0644 |
|
| keypair.py | File | 4.44 KB | 0644 |
|
| keypair_info.py | File | 3.8 KB | 0644 |
|
| keystone_federation_protocol.py | File | 5.1 KB | 0644 |
|
| keystone_federation_protocol_info.py | File | 2.57 KB | 0644 |
|
| lb_health_monitor.py | File | 11.11 KB | 0644 |
|
| lb_listener.py | File | 8.93 KB | 0644 |
|
| lb_member.py | File | 6.71 KB | 0644 |
|
| lb_pool.py | File | 8.1 KB | 0644 |
|
| loadbalancer.py | File | 24.92 KB | 0644 |
|
| network.py | File | 8.03 KB | 0644 |
|
| networks_info.py | File | 4 KB | 0644 |
|
| neutron_rbac_policies_info.py | File | 8.27 KB | 0644 |
|
| neutron_rbac_policy.py | File | 10.53 KB | 0644 |
|
| object.py | File | 3.4 KB | 0644 |
|
| object_container.py | File | 5.92 KB | 0644 |
|
| os_auth.py | File | 1.33 KB | 0644 |
|
| os_client_config.py | File | 1.97 KB | 0644 |
|
| os_coe_cluster.py | File | 8.7 KB | 0644 |
|
| os_coe_cluster_template.py | File | 12.24 KB | 0644 |
|
| os_flavor_info.py | File | 7.79 KB | 0644 |
|
| os_floating_ip.py | File | 12.14 KB | 0644 |
|
| os_group.py | File | 4.18 KB | 0644 |
|
| os_group_info.py | File | 4.1 KB | 0644 |
|
| os_image.py | File | 8.77 KB | 0644 |
|
| os_image_info.py | File | 5.72 KB | 0644 |
|
| os_ironic.py | File | 15.53 KB | 0644 |
|
| os_ironic_inspect.py | File | 4.19 KB | 0644 |
|
| os_ironic_node.py | File | 12.65 KB | 0644 |
|
| os_keypair.py | File | 4.44 KB | 0644 |
|
| os_keystone_domain.py | File | 4.71 KB | 0644 |
|
| os_keystone_domain_info.py | File | 3.13 KB | 0644 |
|
| os_keystone_endpoint.py | File | 6.34 KB | 0644 |
|
| os_keystone_federation_protocol.py | File | 5.1 KB | 0644 |
|
| os_keystone_federation_protocol_info.py | File | 2.57 KB | 0644 |
|
| os_keystone_identity_provider.py | File | 6.31 KB | 0644 |
|
| os_keystone_identity_provider_info.py | File | 2.21 KB | 0644 |
|
| os_keystone_mapping.py | File | 5.18 KB | 0644 |
|
| os_keystone_mapping_info.py | File | 2.15 KB | 0644 |
|
| os_keystone_role.py | File | 2.66 KB | 0644 |
|
| os_keystone_service.py | File | 5.12 KB | 0644 |
|
| os_listener.py | File | 8.93 KB | 0644 |
|
| os_loadbalancer.py | File | 24.92 KB | 0644 |
|
| os_member.py | File | 6.71 KB | 0644 |
|
| os_network.py | File | 8.03 KB | 0644 |
|
| os_networks_info.py | File | 4 KB | 0644 |
|
| os_nova_flavor.py | File | 7.71 KB | 0644 |
|
| os_nova_host_aggregate.py | File | 7.21 KB | 0644 |
|
| os_object.py | File | 3.4 KB | 0644 |
|
| os_pool.py | File | 8.1 KB | 0644 |
|
| os_port.py | File | 16.46 KB | 0644 |
|
| os_port_info.py | File | 6.78 KB | 0644 |
|
| os_project.py | File | 6.33 KB | 0644 |
|
| os_project_access.py | File | 6.08 KB | 0644 |
|
| os_project_info.py | File | 4.51 KB | 0644 |
|
| os_quota.py | File | 15.99 KB | 0644 |
|
| os_recordset.py | File | 7.73 KB | 0644 |
|
| os_router.py | File | 21.82 KB | 0644 |
|
| os_routers_info.py | File | 5.55 KB | 0644 |
|
| os_security_group.py | File | 4.25 KB | 0644 |
|
| os_security_group_rule.py | File | 12.07 KB | 0644 |
|
| os_server.py | File | 26.5 KB | 0644 |
|
| os_server_action.py | File | 8.84 KB | 0644 |
|
| os_server_group.py | File | 4.12 KB | 0644 |
|
| os_server_info.py | File | 2.66 KB | 0644 |
|
| os_server_metadata.py | File | 4.84 KB | 0644 |
|
| os_server_volume.py | File | 3.67 KB | 0644 |
|
| os_stack.py | File | 7.76 KB | 0644 |
|
| os_subnet.py | File | 12.55 KB | 0644 |
|
| os_subnets_info.py | File | 4.51 KB | 0644 |
|
| os_user.py | File | 7.86 KB | 0644 |
|
| os_user_group.py | File | 2.29 KB | 0644 |
|
| os_user_info.py | File | 4.27 KB | 0644 |
|
| os_user_role.py | File | 5.65 KB | 0644 |
|
| os_volume.py | File | 7.8 KB | 0644 |
|
| os_volume_snapshot.py | File | 4.86 KB | 0644 |
|
| os_zone.py | File | 6.98 KB | 0644 |
|
| port.py | File | 16.46 KB | 0644 |
|
| port_info.py | File | 6.78 KB | 0644 |
|
| project.py | File | 6.33 KB | 0644 |
|
| project_access.py | File | 6.08 KB | 0644 |
|
| project_info.py | File | 4.51 KB | 0644 |
|
| quota.py | File | 15.99 KB | 0644 |
|
| recordset.py | File | 7.73 KB | 0644 |
|
| role_assignment.py | File | 5.65 KB | 0644 |
|
| router.py | File | 21.82 KB | 0644 |
|
| routers_info.py | File | 5.55 KB | 0644 |
|
| security_group.py | File | 4.25 KB | 0644 |
|
| security_group_info.py | File | 5.8 KB | 0644 |
|
| security_group_rule.py | File | 12.07 KB | 0644 |
|
| security_group_rule_info.py | File | 7.71 KB | 0644 |
|
| server.py | File | 26.5 KB | 0644 |
|
| server_action.py | File | 8.84 KB | 0644 |
|
| server_group.py | File | 4.12 KB | 0644 |
|
| server_info.py | File | 2.66 KB | 0644 |
|
| server_metadata.py | File | 4.84 KB | 0644 |
|
| server_volume.py | File | 3.67 KB | 0644 |
|
| stack.py | File | 7.76 KB | 0644 |
|
| stack_info.py | File | 2.44 KB | 0644 |
|
| subnet.py | File | 12.55 KB | 0644 |
|
| subnet_pool.py | File | 10.99 KB | 0644 |
|
| subnets_info.py | File | 4.51 KB | 0644 |
|
| volume.py | File | 7.8 KB | 0644 |
|
| volume_backup.py | File | 6.26 KB | 0644 |
|
| volume_backup_info.py | File | 2.9 KB | 0644 |
|
| volume_info.py | File | 3.65 KB | 0644 |
|
| volume_snapshot.py | File | 4.86 KB | 0644 |
|
| volume_snapshot_info.py | File | 3.43 KB | 0644 |
|