diff --git a/lib/ansible/modules/extras/cloud/google/gce_img.py b/lib/ansible/modules/extras/cloud/google/gce_img.py new file mode 100644 index 00000000000..460a55b41ad --- /dev/null +++ b/lib/ansible/modules/extras/cloud/google/gce_img.py @@ -0,0 +1,174 @@ +#!/usr/bin/python +# Copyright 2015 Google Inc. All Rights Reserved. +# +# This file is part of Ansible +# +# Ansible is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# Ansible is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with Ansible. If not, see . + +"""An Ansible module to utilize GCE image resources.""" + +import sys + +# import module snippets +from ansible.module_utils.basic import * +from ansible.module_utils.gce import * + +try: + from libcloud.compute.types import Provider + from libcloud.compute.providers import get_driver + from libcloud.common.google import GoogleBaseError + from libcloud.common.google import ResourceNotFoundError + _ = Provider.GCE +except ImportError: + print('failed=True ' + "msg='libcloud with GCE support is required for this module.'") + sys.exit(1) + +DOCUMENTATION = ''' +--- +module: gce_img +short_description: utilize GCE image resources +description: + - This module can create and delete GCE private images from gzipped + compressed tarball containing raw disk data or from existing detached + disks in any zone. U(https://cloud.google.com/compute/docs/images) +options: + name: + description: + - the name of the image to create + required: true + default: null + aliases: [] + source: + description: + - the source disk or the Google Cloud Storage URI to create the image from + required: false + default: null + aliases: [] + state: + description: + - desired state of the image + required: false + default: "present" + choices: ["active", "present", "absent", "deleted"] + aliases: [] + zone: + description: + - the zone of the disk specified by source + required: false + default: "us-central1-a" + aliases: [] + service_account_email: + version_added: "1.6" + description: + - service account email + required: false + default: null + aliases: [] + pem_file: + version_added: "1.6" + description: + - path to the pem file associated with the service account email + required: false + default: null + aliases: [] + project_id: + version_added: "1.6" + description: + - your GCE project ID + required: false + default: null + aliases: [] + +requirements: [ "libcloud" ] +author: Peter Tan +''' + +EXAMPLES = ''' +# Create an image named test-image from the disk 'test-disk' in zone us-central1-a. +- gce_img: + name: test-image + source: test-disk + zone: us-central1-a + state: present + +# Delete an image named test-image in zone us-central1-a. +- gce_img: + name: test-image + zone: us-central1-a + state: deleted +''' + + +def main(): + module = AnsibleModule( + argument_spec=dict( + name=dict(required=True), + source=dict(), + state=dict(default='present'), + zone=dict(default='us-central1-a'), + service_account_email=dict(), + pem_file=dict(), + project_id=dict(), + ) + ) + + gce = gce_connect(module) + + name = module.params.get('name') + source = module.params.get('source') + state = module.params.get('state') + zone = module.params.get('zone') + changed = False + + try: + image = gce.ex_get_image(name) + except GoogleBaseError, e: + module.fail_json(msg=str(e), changed=False) + + # user wants to create an image. + if state in ['active', 'present'] and not image: + if not source: + module.fail_json(msg='Must supply a source', changed=False) + + if source.startswith('https://storage.googleapis.com'): + # source is a Google Cloud Storage URI + volume = source + else: + try: + volume = gce.ex_get_volume(source, zone) + except ResourceNotFoundError: + module.fail_json(msg='Disk %s not found in zone %s' % (source, zone), + changed=False) + except GoogleBaseError, e: + module.fail_json(msg=str(e), changed=False) + + try: + image = gce.ex_create_image(name, volume) + changed = True + except GoogleBaseError, e: + module.fail_json(msg=str(e), changed=False) + + # user wants to delete the image. + if state in ['absent', 'deleted'] and image: + try: + gce.ex_delete_image(image) + changed = True + except GoogleBaseError, e: + module.fail_json(msg=str(e), changed=False) + + module.exit_json(changed=changed, name=name) + sys.exit(0) + +main()