# Copyright 2019 Red Hat, Inc. # # 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. import logging from openstackclient.identity import common as identity_common from osc_lib.cli import format_columns from osc_lib.cli import parseractions from osc_lib.command import command from osc_lib import exceptions from osc_lib import utils as oscutils from manilaclient import api_versions from manilaclient.common._i18n import _ from manilaclient.common.apiclient import utils as apiutils from manilaclient.common import cliutils from manilaclient.osc import utils LOG = logging.getLogger(__name__) SHARE_ATTRIBUTES = [ 'id', 'name', 'size', 'share_proto', 'status', 'is_public', 'share_type_name', 'availability_zone', 'description', 'share_network_id', 'share_server_id', 'share_type', 'share_group_id', 'host', 'user_id', 'project_id', 'access_rules_status', 'snapshot_id', 'snapshot_support', 'create_share_from_snapshot_support', 'mount_snapshot_support', 'revert_to_snapshot_support', 'task_state', 'source_share_group_snapshot_member_id', 'replication_type', 'has_replicas', 'created_at', 'metadata' ] SHARE_ATTRIBUTES_HEADERS = [ 'ID', 'Name', 'Size', 'Share Protocol', 'Status', 'Is Public', 'Share Type Name', 'Availability Zone', 'Description', 'Share Network ID', 'Share Server ID', 'Share Type', 'Share Group ID', 'Host', 'User ID', 'Project ID', 'Access Rules Status', 'Source Snapshot ID', 'Supports Creating Snapshots', 'Supports Cloning Snapshots', 'Supports Mounting snapshots', 'Supports Reverting to Snapshot', 'Migration Task Status', 'Source Share Group Snapshot Member ID', 'Replication Type', 'Has Replicas', 'Created At', 'Properties', ] class CreateShare(command.ShowOne): """Create a new share.""" _description = _("Create new share") log = logging.getLogger(__name__ + ".CreateShare") def get_parser(self, prog_name): parser = super(CreateShare, self).get_parser(prog_name) parser.add_argument( 'share_proto', metavar="", help=_('Share protocol (NFS, CIFS, CephFS, GlusterFS or HDFS)') ) parser.add_argument( 'size', metavar="", type=int, help=_('Share size in GiB.') ) parser.add_argument( '--name', metavar="", default=None, help=_('Optional share name. (Default=None)') ) parser.add_argument( '--snapshot-id', metavar="", default=None, help=_("Optional snapshot ID to create the share from." " (Default=None)") ) # NOTE(vkmc) --property replaces --metadata in osc parser.add_argument( "--property", metavar="", default={}, action=parseractions.KeyValueAction, help=_("Set a property to this share " "(repeat option to set multiple properties)"), ) parser.add_argument( '--share-network', metavar='', default=None, help=_('Optional network info ID or name.'), ) parser.add_argument( '--description', metavar='', default=None, help=_('Optional share description. (Default=None)') ) parser.add_argument( '--public', metavar='', default=False, help=_('Level of visibility for share. ' 'Defines whether other tenants are able to see it or not. ' '(Default = False)') ) parser.add_argument( '--share-type', metavar='', default=None, help=_('Optional share type. Use of optional shares type ' 'is deprecated. (Default=Default)') ) parser.add_argument( '--availability-zone', metavar='', default=None, help=_('Availability zone in which share should be created.') ) parser.add_argument( '--share-group', metavar='', default=None, help=_('Optional share group name or ID in which to create ' 'the share. (Default=None).') ) parser.add_argument( '--wait', action='store_true', default=False, help=_('Wait for share creation') ) return parser def take_action(self, parsed_args): # TODO(s0ru): the table shows 'Field', 'Value' share_client = self.app.client_manager.share share_type = None if parsed_args.share_type: share_type = apiutils.find_resource(share_client.share_types, parsed_args.share_type).id share_network = None if parsed_args.share_network: share_network = apiutils.find_resource( share_client.share_networks, parsed_args.share_network).id share_group = None if parsed_args.share_group: share_group = apiutils.find_resource(share_client.share_groups, parsed_args.share_group).id size = parsed_args.size snapshot_id = None if parsed_args.snapshot_id: snapshot = apiutils.find_resource(share_client.share_snapshots, parsed_args.snapshot_id) snapshot_id = snapshot.id size = max(size or 0, snapshot.size) body = { 'share_proto': parsed_args.share_proto, 'size': size, 'snapshot_id': snapshot_id, 'name': parsed_args.name, 'description': parsed_args.description, 'metadata': parsed_args.property, 'share_network': share_network, 'share_type': share_type, 'is_public': parsed_args.public, 'availability_zone': parsed_args.availability_zone, 'share_group_id': share_group } share = share_client.shares.create(**body) if parsed_args.wait: if not oscutils.wait_for_status( status_f=share_client.shares.get, res_id=share.id, success_status=['available'] ): LOG.error(_("ERROR: Share is in error state.")) share = apiutils.find_resource(share_client.shares, share.id) printable_share = share._info printable_share.pop('links', None) printable_share.pop('shares_type', None) return self.dict2columns(printable_share) class DeleteShare(command.Command): """Delete a share.""" _description = _("Delete a share") def get_parser(self, prog_name): parser = super(DeleteShare, self).get_parser(prog_name) parser.add_argument( "shares", metavar="", nargs="+", help=_("Share(s) to delete (name or ID)") ) parser.add_argument( "--share-group", metavar="", default=None, help=_("Optional share group (name or ID)" "which contains the share") ) parser.add_argument( "--force", action='store_true', default=False, help=_("Attempt forced removal of share(s), regardless of state " "(defaults to False)") ) parser.add_argument( "--wait", action='store_true', default=False, help=_("Wait for share deletion") ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share result = 0 for share in parsed_args.shares: try: share_obj = apiutils.find_resource( share_client.shares, share ) share_group_id = (share_group_id if parsed_args.share_group else None) if parsed_args.force: share_client.shares.force_delete(share_obj) else: share_client.shares.delete(share_obj, share_group_id) if parsed_args.wait: if not oscutils.wait_for_delete( manager=share_client.shares, res_id=share_obj.id): result += 1 except Exception as exc: result += 1 LOG.error(_("Failed to delete share with " "name or ID '%(share)s': %(e)s"), {'share': share, 'e': exc}) if result > 0: total = len(parsed_args.shares) msg = (_("%(result)s of %(total)s shares failed " "to delete.") % {'result': result, 'total': total}) raise exceptions.CommandError(msg) class ListShare(command.Lister): """List Shared file systems (shares).""" _description = _("List shares") def get_parser(self, prog_name): parser = super(ListShare, self).get_parser(prog_name) parser.add_argument( '--name', metavar="", help=_('Filter shares by share name') ) parser.add_argument( '--status', metavar="", help=_('Filter shares by status') ) parser.add_argument( '--snapshot', metavar='', help=_('Filter shares by snapshot name or id.'), ) parser.add_argument( '--public', action='store_true', default=False, help=_('Include public shares'), ) parser.add_argument( '--share-network', metavar='', help=_('Filter shares exported on a given share network'), ) parser.add_argument( '--share-type', metavar='', help=_('Filter shares of a given share type'), ) parser.add_argument( '--share-group', metavar='', help=_('Filter shares belonging to a given share group'), ) parser.add_argument( '--host', metavar='', help=_('Filter shares belonging to a given host (admin only)'), ) parser.add_argument( '--share-server', metavar='', help=_('Filter shares exported via a given share server ' '(admin only)'), ) parser.add_argument( '--project', metavar='', help=_('Filter shares by project (name or ID) (admin only)') ) identity_common.add_project_domain_option_to_parser(parser) parser.add_argument( '--user', metavar='', help=_('Filter results by user (name or ID) (admin only)') ) identity_common.add_user_domain_option_to_parser(parser) parser.add_argument( '--all-projects', action='store_true', default=False, help=_('Include all projects (admin only)'), ) parser.add_argument( '--property', metavar='', action=parseractions.KeyValueAction, help=_('Filter shares having a given metadata key=value property ' '(repeat option to filter by multiple properties)'), ) parser.add_argument( '--extra-spec', metavar='', action=parseractions.KeyValueAction, help=_('Filter shares with extra specs (key=value) of the share ' 'type that they belong to. ' '(repeat option to filter by multiple extra specs)'), ) parser.add_argument( '--long', action='store_true', default=False, help=_('List additional fields in output'), ) parser.add_argument( '--sort', metavar="[:]", default='name:asc', help=_("Sort output by selected keys and directions(asc or desc) " "(default: name:asc), multiple keys and directions can be " "specified separated by comma"), ) parser.add_argument( '--limit', metavar="", type=int, action=parseractions.NonNegativeAction, help=_('Maximum number of shares to display'), ) parser.add_argument( '--marker', metavar="", help=_('The last share ID of the previous page'), ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share identity_client = self.app.client_manager.identity # TODO(gouthamr): Add support for ~name, ~description # export_location filtering if parsed_args.long: columns = SHARE_ATTRIBUTES column_headers = SHARE_ATTRIBUTES_HEADERS else: columns = [ 'id', 'name', 'size', 'share_proto', 'status', 'is_public', 'share_type_name', 'host', 'availability_zone' ] column_headers = [ 'ID', 'Name', 'Size', 'Share Proto', 'Status', 'Is Public', 'Share Type Name', 'Host', 'Availability Zone' ] project_id = None if parsed_args.project: project_id = identity_common.find_project( identity_client, parsed_args.project, parsed_args.project_domain).id user_id = None if parsed_args.user: user_id = identity_common.find_user(identity_client, parsed_args.user, parsed_args.user_domain).id # set value of 'all_tenants' when using project option all_tenants = bool(parsed_args.project) or parsed_args.all_projects share_type_id = None if parsed_args.share_type: share_type_id = apiutils.find_resource(share_client.share_types, parsed_args.share_type).id snapshot_id = None if parsed_args.snapshot: snapshot_id = apiutils.find_resource(share_client.share_snapshots, parsed_args.snapshot).id share_network_id = None if parsed_args.share_network: share_network_id = apiutils.find_resource( share_client.share_networks, parsed_args.share_network).id share_group_id = None if parsed_args.share_group: share_group_id = apiutils.find_resource(share_client.share_groups, parsed_args.share_group).id share_server_id = None if parsed_args.share_server: share_server_id = apiutils.find_resource( share_client.share_servers, parsed_args.share_server).id search_opts = { 'all_tenants': all_tenants, 'is_public': parsed_args.public, 'metadata': utils.extract_key_value_options( parsed_args.property), 'extra_specs': utils.extract_key_value_options( parsed_args.extra_spec), 'limit': parsed_args.limit, 'name': parsed_args.name, 'status': parsed_args.status, 'host': parsed_args.host, 'share_server_id': share_server_id, 'share_network_id': share_network_id, 'share_type_id': share_type_id, 'snapshot_id': snapshot_id, 'share_group_id': share_group_id, 'project_id': project_id, 'user_id': user_id, 'offset': parsed_args.marker, } # NOTE(vkmc) We implemented sorting and filtering in manilaclient # but we will use the one provided by osc data = share_client.shares.list(search_opts=search_opts) data = oscutils.sort_items(data, parsed_args.sort, str) return (column_headers, (oscutils.get_item_properties (s, columns, formatters={'Metadata': oscutils.format_dict},) for s in data)) class ShowShare(command.ShowOne): """Show a share.""" _description = _("Display share details") def get_parser(self, prog_name): parser = super(ShowShare, self).get_parser(prog_name) parser.add_argument( 'share', metavar="", help=_('Share to display (name or ID)') ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share share_obj = apiutils.find_resource(share_client.shares, parsed_args.share) export_locations = share_client.share_export_locations.list(share_obj) export_locations = ( cliutils.transform_export_locations_to_string_view( export_locations)) data = share_obj._info data['export_locations'] = export_locations # Special mapping for columns to make the output easier to read: # 'metadata' --> 'properties' data.update( { 'properties': format_columns.DictColumn(data.pop('metadata', {})), }, ) # Remove key links from being displayed data.pop("links", None) data.pop("shares_type", None) return self.dict2columns(data) class SetShare(command.Command): """Set share properties.""" _description = _("Set share properties") def get_parser(self, prog_name): parser = super(SetShare, self).get_parser(prog_name) parser.add_argument( 'share', metavar="", help=_('Share to modify (name or ID)') ) # 'metadata' --> 'properties' parser.add_argument( "--property", metavar="", default={}, action=parseractions.KeyValueAction, help=_("Set a property to this share " "(repeat option to set multiple properties)"), ) parser.add_argument( '--name', metavar="", default=None, help=_('New share name. (Default=None)') ) parser.add_argument( '--description', metavar='', default=None, help=_('New share description. (Default=None)') ) parser.add_argument( '--public', metavar='', help=_('Level of visibility for share. ' 'Defines whether other tenants are able to see it or not. ') ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share share_obj = apiutils.find_resource(share_client.shares, parsed_args.share) result = 0 if parsed_args.property: try: share_client.shares.set_metadata( share_obj.id, parsed_args.property) except Exception as e: LOG.error(_("Failed to set share properties " "'%(properties)s': %(exception)s"), {'properties': parsed_args.property, 'exception': e}) result += 1 kwargs = {} if parsed_args.name is not None: kwargs['display_name'] = parsed_args.name if parsed_args.description is not None: kwargs['display_description'] = parsed_args.description if parsed_args.public is not None: kwargs['is_public'] = parsed_args.public if kwargs: try: share_client.shares.update(share_obj.id, **kwargs) except Exception as e: LOG.error(_("Failed to update share display name, visibility " "or display description: %s"), e) result += 1 if result > 0: raise exceptions.CommandError(_("One or more of the " "set operations failed")) class UnsetShare(command.Command): """Unset share properties.""" _description = _("Unset share properties") def get_parser(self, prog_name): parser = super(UnsetShare, self).get_parser(prog_name) parser.add_argument( 'share', metavar="", help=_('Share to modify (name or ID)') ) # 'metadata' --> 'properties' parser.add_argument( '--property', metavar='', action='append', help=_('Remove a property from share ' '(repeat option to remove multiple properties)'), ) parser.add_argument( '--name', action='store_true', help=_('Unset share name.') ) parser.add_argument( '--description', action='store_true', help=_('Unset share description.') ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share share_obj = apiutils.find_resource(share_client.shares, parsed_args.share) result = 0 kwargs = {} if parsed_args.name: kwargs['display_name'] = None if parsed_args.description: kwargs['display_description'] = None if kwargs: try: share_client.shares.update(share_obj.id, **kwargs) except Exception as e: LOG.error(_("Failed to unset share display name " "or display description: %s"), e) result += 1 if parsed_args.property: for key in parsed_args.property: try: share_client.shares.delete_metadata( share_obj.id, [key]) except Exception as e: LOG.error(_("Failed to unset share property " "'%(key)s': %(e)s"), {'key': key, 'e': e}) result += 1 if result > 0: raise exceptions.CommandError(_( "One or more of the " "unset operations failed")) class ResizeShare(command.Command): """Resize a share""" _description = _("Resize a share") def get_parser(self, prog_name): parser = super(ResizeShare, self).get_parser(prog_name) parser.add_argument( 'share', metavar="", help=_('Name or ID of share to resize') ) parser.add_argument( 'new_size', metavar="", type=int, help=_('New size of share, in GiBs') ) parser.add_argument( '--wait', action='store_true', default=False, help=_('Wait for share resize') ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share share = apiutils.find_resource(share_client.shares, parsed_args.share) share_size = share._info['size'] new_size = parsed_args.new_size if share_size > new_size: try: share_client.shares.shrink(share, new_size) except Exception as e: raise exceptions.CommandError(_( "Share resize failed: %s" % e )) elif share_size < new_size: try: share_client.shares.extend(share, new_size) except Exception as e: raise exceptions.CommandError(_( "Share resize failed: %s" % e )) else: raise exceptions.CommandError(_( "Share size is already at %s GiBs" % new_size )) if parsed_args.wait: if not oscutils.wait_for_status( status_f=share_client.shares.get, res_id=share.id, success_status=['available'] ): raise exceptions.CommandError(_( "Share not available after resize attempt.")) class AdoptShare(command.ShowOne): """Adopt share not handled by Manila (Admin only).""" _description = _("Adopt a share") def get_parser(self, prog_name): parser = super(AdoptShare, self).get_parser(prog_name) parser.add_argument( 'service_host', metavar="", help=_('Service host: some.host@driver#pool.') ) parser.add_argument( 'protocol', metavar="", help=_( 'Protocol of the share to manage, such as NFS or CIFS.') ) parser.add_argument( 'export_path', metavar="", help=_('Share export path, NFS share such as: ' '10.0.0.1:/example_path, CIFS share such as: ' '\\\\10.0.0.1\\example_cifs_share.') ) parser.add_argument( '--name', metavar="", default=None, help=_('Optional share name. (Default=None)') ) parser.add_argument( '--description', metavar="", default=None, help=_('Optional share description. (Default=None)') ) parser.add_argument( '--share-type', metavar="", default=None, help=_( 'Optional share type assigned to share. (Default=None)') ) parser.add_argument( '--driver-options', type=str, nargs='*', metavar='', default=None, help=_( 'Optional driver options as key=value pairs (Default=None).') ) parser.add_argument( '--public', action='store_true', help=_('Level of visibility for share. Defines whether other ' 'projects are able to see it or not. Available only for ' 'microversion >= 2.8. (Default=False)') ) parser.add_argument( '--share-server-id', metavar="", help=_('Share server associated with share when using a share ' 'type with "driver_handles_share_servers" extra_spec ' 'set to True. Available only for microversion >= 2.49. ' '(Default=None)') ) parser.add_argument( "--wait", action='store_true', help=_("Wait until share is adopted") ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share kwargs = { 'service_host': parsed_args.service_host, 'protocol': parsed_args.protocol, 'export_path': parsed_args.export_path, 'name': parsed_args.name, 'description': parsed_args.description } share_type = None if parsed_args.share_type: share_type = apiutils.find_resource(share_client.share_types, parsed_args.share_type).id kwargs['share_type'] = share_type driver_options = None if parsed_args.driver_options: driver_options = utils.extract_properties( parsed_args.driver_options) kwargs['driver_options'] = driver_options if parsed_args.public: if share_client.api_version >= api_versions.APIVersion("2.8"): kwargs['public'] = True else: raise exceptions.CommandError( 'Setting share visibility while adopting a share is ' 'available only for API microversion >= 2.8') if parsed_args.share_server_id: if share_client.api_version >= api_versions.APIVersion("2.49"): kwargs['share_server_id'] = parsed_args.share_server_id else: raise exceptions.CommandError( 'Selecting a share server ID is available only for ' 'API microversion >= 2.49') share = share_client.shares.manage(**kwargs) if parsed_args.wait: if not oscutils.wait_for_status( status_f=share_client.shares.get, res_id=share.id, success_status=['available'], error_status=['manage_error', 'error'] ): LOG.error(_("ERROR: Share is in error state.")) share = apiutils.find_resource(share_client.shares, share.id) share._info.pop('links', None) return self.dict2columns(share._info) class AbandonShare(command.Command): """Abandon a share (Admin only).""" _description = _("Abandon a share") def get_parser(self, prog_name): parser = super(AbandonShare, self).get_parser(prog_name) parser.add_argument( 'share', metavar="", nargs="+", help=_('Name or ID of the share(s)') ) parser.add_argument( "--wait", action='store_true', help=_("Wait until share is abandoned") ) return parser def take_action(self, parsed_args): share_client = self.app.client_manager.share result = 0 for share in parsed_args.share: try: share_obj = apiutils.find_resource( share_client.shares, share ) share_client.shares.unmanage(share_obj) if parsed_args.wait: # 'wait_for_delete' checks that the resource is no longer # retrievable with the given 'res_id' so we can use it # to check that the share has been abandoned if not oscutils.wait_for_delete( manager=share_client.shares, res_id=share_obj.id): result += 1 except Exception as e: result += 1 LOG.error(_("Failed to abandon share with " "name or ID '%(share)s': %(e)s"), {'share': share, 'e': e}) if result > 0: total = len(parsed_args.share) msg = (_("Failed to abandon %(result)s out of %(total)s shares.") % {'result': result, 'total': total}) raise exceptions.CommandError(msg)