# Copyright 2012-2013 OpenStack Foundation # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. # """Image V2 Action Implementations""" import argparse import logging import six from cliff import command from cliff import lister from cliff import show from glanceclient.common import utils as gc_utils from openstackclient.api import utils as api_utils from openstackclient.common import exceptions from openstackclient.common import parseractions from openstackclient.common import utils from openstackclient.identity import common DEFAULT_CONTAINER_FORMAT = 'bare' DEFAULT_DISK_FORMAT = 'raw' def _format_image(image): """Format an image to make it more consistent with OSC operations. """ info = {} properties = {} # the only fields we're not including is "links", "tags" and the properties fields_to_show = ['status', 'name', 'container_format', 'created_at', 'size', 'disk_format', 'updated_at', 'visibility', 'min_disk', 'protected', 'id', 'file', 'checksum', 'owner', 'virtual_size', 'min_ram', 'schema'] # split out the usual key and the properties which are top-level for key in six.iterkeys(image): if key in fields_to_show: info[key] = image.get(key) elif key == 'tags': continue # handle this later else: properties[key] = image.get(key) # format the tags if they are there info['tags'] = utils.format_list(image.get('tags')) # add properties back into the dictionary as a top-level key if properties: info['properties'] = utils.format_dict(properties) return info class AddProjectToImage(show.ShowOne): """Associate project with image""" log = logging.getLogger(__name__ + ".AddProjectToImage") def get_parser(self, prog_name): parser = super(AddProjectToImage, self).get_parser(prog_name) parser.add_argument( "image", metavar="", help="Image to share (name or ID)", ) parser.add_argument( "project", metavar="", help="Project to associate with image (name or ID)", ) common.add_project_domain_option_to_parser(parser) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image identity_client = self.app.client_manager.identity project_id = common.find_project(identity_client, parsed_args.project, parsed_args.project_domain).id image_id = utils.find_resource( image_client.images, parsed_args.image).id image_member = image_client.image_members.create( image_id, project_id, ) return zip(*sorted(six.iteritems(image_member))) class CreateImage(show.ShowOne): """Create/upload an image""" log = logging.getLogger(__name__ + ".CreateImage") deadopts = ('size', 'location', 'copy-from', 'checksum', 'store') def get_parser(self, prog_name): parser = super(CreateImage, self).get_parser(prog_name) # TODO(bunting): There are additional arguments that v1 supported # that v2 either doesn't support or supports weirdly. # --checksum - could be faked clientside perhaps? # --location - maybe location add? # --size - passing image size is actually broken in python-glanceclient # --copy-from - does not exist in v2 # --store - does not exits in v2 parser.add_argument( "name", metavar="", help="New image name", ) parser.add_argument( "--id", metavar="", help="Image ID to reserve", ) parser.add_argument( "--container-format", default=DEFAULT_CONTAINER_FORMAT, metavar="", help="Image container format " "(default: %s)" % DEFAULT_CONTAINER_FORMAT, ) parser.add_argument( "--disk-format", default=DEFAULT_DISK_FORMAT, metavar="", help="Image disk format " "(default: %s)" % DEFAULT_DISK_FORMAT, ) parser.add_argument( "--owner", metavar="", help="Image owner project name or ID", ) parser.add_argument( "--min-disk", metavar="", type=int, help="Minimum disk size needed to boot image, in gigabytes", ) parser.add_argument( "--min-ram", metavar="", type=int, help="Minimum RAM size needed to boot image, in megabytes", ) parser.add_argument( "--file", metavar="", help="Upload image from local file", ) parser.add_argument( "--volume", metavar="", help="Create image from a volume", ) parser.add_argument( "--force", dest='force', action='store_true', default=False, help="Force image creation if volume is in use " "(only meaningful with --volume)", ) protected_group = parser.add_mutually_exclusive_group() protected_group.add_argument( "--protected", action="store_true", help="Prevent image from being deleted", ) protected_group.add_argument( "--unprotected", action="store_true", help="Allow image to be deleted (default)", ) public_group = parser.add_mutually_exclusive_group() public_group.add_argument( "--public", action="store_true", help="Image is accessible to the public", ) public_group.add_argument( "--private", action="store_true", help="Image is inaccessible to the public (default)", ) parser.add_argument( "--property", dest="properties", metavar="", action=parseractions.KeyValueAction, help="Set a property on this image " "(repeat option to set multiple properties)", ) parser.add_argument( "--tag", dest="tags", metavar="", action='append', help="Set a tag on this image " "(repeat option to set multiple tags)", ) for deadopt in self.deadopts: parser.add_argument( "--%s" % deadopt, metavar="<%s>" % deadopt, dest=deadopt.replace('-', '_'), help=argparse.SUPPRESS, ) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image for deadopt in self.deadopts: if getattr(parsed_args, deadopt.replace('-', '_'), None): raise exceptions.CommandError( "ERROR: --%s was given, which is an Image v1 option" " that is no longer supported in Image v2" % deadopt) # Build an attribute dict from the parsed args, only include # attributes that were actually set on the command line kwargs = {} copy_attrs = ('name', 'id', 'container_format', 'disk_format', 'min_disk', 'min_ram', 'tags', 'owner') for attr in copy_attrs: if attr in parsed_args: val = getattr(parsed_args, attr, None) if val: # Only include a value in kwargs for attributes that # are actually present on the command line kwargs[attr] = val # properties should get flattened into the general kwargs if getattr(parsed_args, 'properties', None): for k, v in six.iteritems(parsed_args.properties): kwargs[k] = str(v) # Handle exclusive booleans with care # Avoid including attributes in kwargs if an option is not # present on the command line. These exclusive booleans are not # a single value for the pair of options because the default must be # to do nothing when no options are present as opposed to always # setting a default. if parsed_args.protected: kwargs['protected'] = True if parsed_args.unprotected: kwargs['protected'] = False if parsed_args.public: kwargs['visibility'] = 'public' if parsed_args.private: kwargs['visibility'] = 'private' # open the file first to ensure any failures are handled before the # image is created fp = gc_utils.get_data_file(parsed_args) info = {} if fp is not None and parsed_args.volume: raise exceptions.CommandError("Uploading data and using container " "are not allowed at the same time") if fp is None and parsed_args.file: self.log.warning("Failed to get an image file.") return {}, {} # If a volume is specified. if parsed_args.volume: volume_client = self.app.client_manager.volume source_volume = utils.find_resource( volume_client.volumes, parsed_args.volume, ) response, body = volume_client.volumes.upload_to_image( source_volume.id, parsed_args.force, parsed_args.name, parsed_args.container_format, parsed_args.disk_format, ) info = body['os-volume_upload_image'] info['volume_type'] = info['volume_type']['name'] else: image = image_client.images.create(**kwargs) if fp is not None: with fp: try: image_client.images.upload(image.id, fp) except Exception as e: # If the upload fails for some reason attempt to remove the # dangling queued image made by the create() call above but # only if the user did not specify an id which indicates # the Image already exists and should be left alone. try: if 'id' not in kwargs: image_client.images.delete(image.id) except Exception: pass # we don't care about this one raise e # now, throw the upload exception again # update the image after the data has been uploaded image = image_client.images.get(image.id) if not info: info = _format_image(image) return zip(*sorted(six.iteritems(info))) class DeleteImage(command.Command): """Delete image(s)""" log = logging.getLogger(__name__ + ".DeleteImage") def get_parser(self, prog_name): parser = super(DeleteImage, self).get_parser(prog_name) parser.add_argument( "images", metavar="", nargs="+", help="Image(s) to delete (name or ID)", ) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image for image in parsed_args.images: image_obj = utils.find_resource( image_client.images, image, ) image_client.images.delete(image_obj.id) class ListImage(lister.Lister): """List available images""" log = logging.getLogger(__name__ + ".ListImage") def get_parser(self, prog_name): parser = super(ListImage, self).get_parser(prog_name) public_group = parser.add_mutually_exclusive_group() public_group.add_argument( "--public", dest="public", action="store_true", default=False, help="List only public images", ) public_group.add_argument( "--private", dest="private", action="store_true", default=False, help="List only private images", ) public_group.add_argument( "--shared", dest="shared", action="store_true", default=False, help="List only shared images", ) parser.add_argument( '--property', metavar='', action=parseractions.KeyValueAction, help='Filter output based on property', ) parser.add_argument( '--long', action='store_true', default=False, help='List additional fields in output', ) # --page-size has never worked, leave here for silent compatibility # We'll implement limit/marker differently later parser.add_argument( "--page-size", metavar="", help=argparse.SUPPRESS, ) parser.add_argument( '--sort', metavar="[:]", help="Sort output by selected keys and directions(asc or desc) " "(default: asc), multiple keys and directions can be " "specified separated by comma", ) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image kwargs = {} if parsed_args.public: kwargs['public'] = True if parsed_args.private: kwargs['private'] = True if parsed_args.shared: kwargs['shared'] = True if parsed_args.long: columns = ( 'ID', 'Name', 'Disk Format', 'Container Format', 'Size', 'Status', 'visibility', 'protected', 'owner', 'tags', ) column_headers = ( 'ID', 'Name', 'Disk Format', 'Container Format', 'Size', 'Status', 'Visibility', 'Protected', 'Owner', 'Tags', ) else: columns = ("ID", "Name", "Status") column_headers = columns # List of image data received data = [] # No pages received yet, so start the page marker at None. marker = None while True: page = image_client.api.image_list(marker=marker, **kwargs) if not page: break data.extend(page) # Set the marker to the id of the last item we received marker = page[-1]['id'] if parsed_args.property: # NOTE(dtroyer): coerce to a list to subscript it in py3 attr, value = list(parsed_args.property.items())[0] api_utils.simple_filter( data, attr=attr, value=value, property_field='properties', ) data = utils.sort_items(data, parsed_args.sort) return ( column_headers, (utils.get_dict_properties( s, columns, formatters={ 'tags': utils.format_list, }, ) for s in data) ) class RemoveProjectImage(command.Command): """Disassociate project with image""" log = logging.getLogger(__name__ + ".RemoveProjectImage") def get_parser(self, prog_name): parser = super(RemoveProjectImage, self).get_parser(prog_name) parser.add_argument( "image", metavar="", help="Image to unshare (name or ID)", ) parser.add_argument( "project", metavar="", help="Project to disassociate with image (name or ID)", ) common.add_project_domain_option_to_parser(parser) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image identity_client = self.app.client_manager.identity project_id = common.find_project(identity_client, parsed_args.project, parsed_args.project_domain).id image_id = utils.find_resource( image_client.images, parsed_args.image).id image_client.image_members.delete(image_id, project_id) class SaveImage(command.Command): """Save an image locally""" log = logging.getLogger(__name__ + ".SaveImage") def get_parser(self, prog_name): parser = super(SaveImage, self).get_parser(prog_name) parser.add_argument( "--file", metavar="", help="Downloaded image save filename (default: stdout)", ) parser.add_argument( "image", metavar="", help="Image to save (name or ID)", ) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image image = utils.find_resource( image_client.images, parsed_args.image, ) data = image_client.images.data(image.id) gc_utils.save_image(data, parsed_args.file) class SetImage(command.Command): """Set image properties""" log = logging.getLogger(__name__ + ".SetImage") deadopts = ('visibility',) def get_parser(self, prog_name): parser = super(SetImage, self).get_parser(prog_name) # TODO(bunting): There are additional arguments that v1 supported # --size - does not exist in v2 # --store - does not exist in v2 # --location - maybe location add? # --copy-from - does not exist in v2 # --file - should be able to upload file # --volume - not possible with v2 as can't change id # --force - see `--volume` # --checksum - maybe could be done client side # --stdin - could be implemented parser.add_argument( "image", metavar="", help="Image to modify (name or ID)" ) parser.add_argument( "--name", metavar="", help="New image name" ) parser.add_argument( "--owner", metavar="", help="New image owner project (name or ID)", ) parser.add_argument( "--min-disk", type=int, metavar="", help="Minimum disk size needed to boot image, in gigabytes" ) parser.add_argument( "--min-ram", type=int, metavar="", help="Minimum RAM size needed to boot image, in megabytes", ) parser.add_argument( "--container-format", metavar="", help="Image container format " "(default: %s)" % DEFAULT_CONTAINER_FORMAT, ) parser.add_argument( "--disk-format", metavar="", help="Image disk format " "(default: %s)" % DEFAULT_DISK_FORMAT, ) protected_group = parser.add_mutually_exclusive_group() protected_group.add_argument( "--protected", action="store_true", help="Prevent image from being deleted", ) protected_group.add_argument( "--unprotected", action="store_true", help="Allow image to be deleted (default)", ) public_group = parser.add_mutually_exclusive_group() public_group.add_argument( "--public", action="store_true", help="Image is accessible to the public", ) public_group.add_argument( "--private", action="store_true", help="Image is inaccessible to the public (default)", ) parser.add_argument( "--property", dest="properties", metavar="", action=parseractions.KeyValueAction, help="Set a property on this image " "(repeat option to set multiple properties)", ) parser.add_argument( "--tag", dest="tags", metavar="", default=[], action='append', help="Set a tag on this image " "(repeat option to set multiple tags)", ) parser.add_argument( "--architecture", metavar="", help="Operating system architecture", ) parser.add_argument( "--instance-id", metavar="", help="ID of server instance used to create this image", ) parser.add_argument( "--instance-uuid", metavar="", dest="instance_id", help=argparse.SUPPRESS, ) parser.add_argument( "--kernel-id", metavar="", help="ID of kernel image used to boot this disk image", ) parser.add_argument( "--os-distro", metavar="", help="Operating system distribution name", ) parser.add_argument( "--os-version", metavar="", help="Operating system distribution version", ) parser.add_argument( "--ramdisk-id", metavar="", help="ID of ramdisk image used to boot this disk image", ) for deadopt in self.deadopts: parser.add_argument( "--%s" % deadopt, metavar="<%s>" % deadopt, dest=deadopt.replace('-', '_'), help=argparse.SUPPRESS, ) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image for deadopt in self.deadopts: if getattr(parsed_args, deadopt.replace('-', '_'), None): raise exceptions.CommandError( "ERROR: --%s was given, which is an Image v1 option" " that is no longer supported in Image v2" % deadopt) kwargs = {} copy_attrs = ('architecture', 'container_format', 'disk_format', 'file', 'instance_id', 'kernel_id', 'locations', 'min_disk', 'min_ram', 'name', 'os_distro', 'os_version', 'owner', 'prefix', 'progress', 'ramdisk_id', 'tags') for attr in copy_attrs: if attr in parsed_args: val = getattr(parsed_args, attr, None) if val: # Only include a value in kwargs for attributes that are # actually present on the command line kwargs[attr] = val # Properties should get flattened into the general kwargs if getattr(parsed_args, 'properties', None): for k, v in six.iteritems(parsed_args.properties): kwargs[k] = str(v) # Handle exclusive booleans with care # Avoid including attributes in kwargs if an option is not # present on the command line. These exclusive booleans are not # a single value for the pair of options because the default must be # to do nothing when no options are present as opposed to always # setting a default. if parsed_args.protected: kwargs['protected'] = True if parsed_args.unprotected: kwargs['protected'] = False if parsed_args.public: kwargs['visibility'] = 'public' if parsed_args.private: kwargs['visibility'] = 'private' if not kwargs: self.log.warning("No arguments specified") return {}, {} image = utils.find_resource( image_client.images, parsed_args.image) if parsed_args.tags: # Tags should be extended, but duplicates removed kwargs['tags'] = list(set(image.tags).union(set(parsed_args.tags))) image = image_client.images.update(image.id, **kwargs) class ShowImage(show.ShowOne): """Display image details""" log = logging.getLogger(__name__ + ".ShowImage") def get_parser(self, prog_name): parser = super(ShowImage, self).get_parser(prog_name) parser.add_argument( "image", metavar="", help="Image to display (name or ID)", ) return parser def take_action(self, parsed_args): self.log.debug("take_action(%s)", parsed_args) image_client = self.app.client_manager.image image = utils.find_resource( image_client.images, parsed_args.image, ) info = _format_image(image) return zip(*sorted(six.iteritems(info)))