
It's not required for collections, for more details: https://github.com/ansible-collections/overview/issues/57 Change-Id: I954eef25bb9837c9282665ad5586dbe37f4f4424
142 lines
4.2 KiB
Python
142 lines
4.2 KiB
Python
#!/usr/bin/python
|
|
# coding: utf-8 -*-
|
|
|
|
# Copyright (c) 2014 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: server_volume
|
|
short_description: Attach/Detach Volumes from OpenStack VM's
|
|
author: "Monty Taylor (@emonty)"
|
|
description:
|
|
- Attach or Detach volumes from OpenStack VM's
|
|
options:
|
|
state:
|
|
description:
|
|
- Should the resource be present or absent.
|
|
choices: [present, absent]
|
|
default: present
|
|
required: false
|
|
type: str
|
|
server:
|
|
description:
|
|
- Name or ID of server you want to attach a volume to
|
|
required: true
|
|
type: str
|
|
volume:
|
|
description:
|
|
- Name or id of volume you want to attach to a server
|
|
required: true
|
|
type: str
|
|
device:
|
|
description:
|
|
- Device you want to attach. Defaults to auto finding a device name.
|
|
type: str
|
|
requirements:
|
|
- "python >= 3.6"
|
|
- "openstacksdk"
|
|
|
|
extends_documentation_fragment:
|
|
- openstack.cloud.openstack
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
# Attaches a volume to a compute host
|
|
- name: attach a volume
|
|
hosts: localhost
|
|
tasks:
|
|
- name: attach volume to host
|
|
openstack.cloud.server_volume:
|
|
state: present
|
|
cloud: mordred
|
|
server: Mysql-server
|
|
volume: mysql-data
|
|
device: /dev/vdb
|
|
'''
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible_collections.openstack.cloud.plugins.module_utils.openstack import (openstack_full_argument_spec,
|
|
openstack_module_kwargs,
|
|
openstack_cloud_from_module)
|
|
|
|
|
|
def _system_state_change(state, device):
|
|
"""Check if system state would change."""
|
|
if state == 'present':
|
|
if device:
|
|
return False
|
|
return True
|
|
if state == 'absent':
|
|
if device:
|
|
return True
|
|
return False
|
|
return False
|
|
|
|
|
|
def main():
|
|
argument_spec = openstack_full_argument_spec(
|
|
server=dict(required=True),
|
|
volume=dict(required=True),
|
|
device=dict(default=None), # None == auto choose device name
|
|
state=dict(default='present', choices=['absent', 'present']),
|
|
)
|
|
|
|
module_kwargs = openstack_module_kwargs()
|
|
module = AnsibleModule(argument_spec,
|
|
supports_check_mode=True,
|
|
**module_kwargs)
|
|
|
|
state = module.params['state']
|
|
wait = module.params['wait']
|
|
timeout = module.params['timeout']
|
|
|
|
sdk, cloud = openstack_cloud_from_module(module)
|
|
try:
|
|
server = cloud.get_server(module.params['server'])
|
|
volume = cloud.get_volume(module.params['volume'])
|
|
|
|
if not volume:
|
|
module.fail_json(msg='volume %s is not found' % module.params['volume'])
|
|
|
|
dev = cloud.get_volume_attach_device(volume, server.id)
|
|
|
|
if module.check_mode:
|
|
module.exit_json(changed=_system_state_change(state, dev))
|
|
|
|
if state == 'present':
|
|
changed = False
|
|
if not dev:
|
|
changed = True
|
|
cloud.attach_volume(server, volume, module.params['device'],
|
|
wait=wait, timeout=timeout)
|
|
|
|
server = cloud.get_server(module.params['server']) # refresh
|
|
volume = cloud.get_volume(module.params['volume']) # refresh
|
|
hostvars = cloud.get_openstack_vars(server)
|
|
|
|
module.exit_json(
|
|
changed=changed,
|
|
id=volume['id'],
|
|
attachments=volume['attachments'],
|
|
openstack=hostvars
|
|
)
|
|
|
|
elif state == 'absent':
|
|
if not dev:
|
|
# Volume is not attached to this server
|
|
module.exit_json(changed=False)
|
|
|
|
cloud.detach_volume(server, volume, wait=wait, timeout=timeout)
|
|
module.exit_json(
|
|
changed=True,
|
|
result='Detached volume from server'
|
|
)
|
|
|
|
except (sdk.exceptions.OpenStackCloudException, sdk.exceptions.ResourceTimeout) as e:
|
|
module.fail_json(msg=str(e))
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|