167 lines
6.2 KiB
Python
167 lines
6.2 KiB
Python
# -*- coding: utf-8 -*- #
|
|
# Copyright 2014 Google LLC. All Rights Reserved.
|
|
#
|
|
# 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.
|
|
"""Command for detaching a disk from an instance."""
|
|
|
|
from __future__ import absolute_import
|
|
from __future__ import division
|
|
from __future__ import unicode_literals
|
|
|
|
from apitools.base.py import encoding
|
|
|
|
from googlecloudsdk.api_lib.compute import base_classes
|
|
from googlecloudsdk.api_lib.compute import instance_utils
|
|
from googlecloudsdk.calliope import base
|
|
from googlecloudsdk.command_lib.compute import exceptions as compute_exceptions
|
|
from googlecloudsdk.command_lib.compute import scope as compute_scopes
|
|
from googlecloudsdk.command_lib.compute.instances import flags
|
|
from googlecloudsdk.core import log
|
|
|
|
|
|
@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
|
|
base.ReleaseTrack.ALPHA)
|
|
class DetachDisk(base.UpdateCommand):
|
|
"""Detach disks from Compute Engine virtual machine instances.
|
|
|
|
*{command}* is used to detach disks from virtual machines.
|
|
|
|
Detaching a disk without first unmounting it may result in
|
|
incomplete I/O operations and data corruption.
|
|
To unmount a persistent disk on a Linux-based image,
|
|
ssh into the instance and run:
|
|
|
|
$ sudo umount /dev/disk/by-id/google-DEVICE_NAME
|
|
"""
|
|
|
|
detailed_help = {
|
|
'EXAMPLES': """
|
|
To detach a disk named 'my-disk' from an instance named 'my-instance',
|
|
run:
|
|
|
|
$ {command} my-instance --disk=my-disk
|
|
|
|
To detach a device named 'my-device' from an instance named
|
|
'my-instance', run:
|
|
|
|
$ {command} my-instance --device-name=my-device
|
|
""",
|
|
}
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
flags.INSTANCE_ARG.AddArgument(parser)
|
|
disk_group = parser.add_mutually_exclusive_group(required=True)
|
|
|
|
disk_group.add_argument(
|
|
'--disk',
|
|
help="""\
|
|
Specifies a disk to detach by its resource name. If you specify a
|
|
disk to remove by persistent disk name, then you must not specify its
|
|
device name using the ``--device-name'' flag.
|
|
""")
|
|
|
|
disk_group.add_argument(
|
|
'--device-name',
|
|
help="""\
|
|
Specifies a disk to detach by its device name, which is the name
|
|
that the guest operating system sees. The device name is set
|
|
at the time that the disk is attached to the instance, and needs not be
|
|
the same as the persistent disk name. If the disk's device name is
|
|
specified, then its persistent disk name must not be specified
|
|
using the ``--disk'' flag.
|
|
""")
|
|
flags.AddDiskScopeFlag(parser)
|
|
|
|
def CreateReference(self, client, resources, args):
|
|
return flags.INSTANCE_ARG.ResolveAsResource(
|
|
args, resources, scope_lister=flags.GetInstanceZoneScopeLister(client))
|
|
|
|
def GetGetRequest(self, client, instance_ref):
|
|
return (client.apitools_client.instances,
|
|
'Get',
|
|
client.messages.ComputeInstancesGetRequest(**instance_ref.AsDict()))
|
|
|
|
def GetSetRequest(self, client, instance_ref, replacement, existing):
|
|
removed_disk = list(
|
|
set(disk.deviceName for disk in existing.disks) -
|
|
set(disk.deviceName for disk in replacement.disks))[0]
|
|
|
|
return (client.apitools_client.instances,
|
|
'DetachDisk',
|
|
client.messages.ComputeInstancesDetachDiskRequest(
|
|
deviceName=removed_disk,
|
|
**instance_ref.AsDict()))
|
|
|
|
def Modify(self, resources, args, instance_ref, existing):
|
|
replacement = encoding.CopyProtoMessage(existing)
|
|
|
|
if args.disk:
|
|
disk_ref = self.ParseDiskRef(resources, args, instance_ref)
|
|
|
|
replacement.disks = [
|
|
disk for disk in existing.disks
|
|
if not disk.source or resources.ParseURL(disk.source).RelativeName()
|
|
!= disk_ref.RelativeName()
|
|
]
|
|
|
|
if len(existing.disks) == len(replacement.disks):
|
|
raise compute_exceptions.ArgumentError(
|
|
'Disk [{0}] is not attached to instance [{1}] in zone [{2}].'
|
|
.format(disk_ref.Name(), instance_ref.instance, instance_ref.zone))
|
|
|
|
else:
|
|
replacement.disks = [disk for disk in existing.disks
|
|
if disk.deviceName != args.device_name]
|
|
|
|
if len(existing.disks) == len(replacement.disks):
|
|
raise compute_exceptions.ArgumentError(
|
|
'No disk with device name [{0}] is attached to instance [{1}] in '
|
|
'zone [{2}].'
|
|
.format(args.device_name, instance_ref.instance, instance_ref.zone))
|
|
|
|
return replacement
|
|
|
|
def Run(self, args):
|
|
holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
|
|
client = holder.client
|
|
|
|
instance_ref = self.CreateReference(client, holder.resources, args)
|
|
get_request = self.GetGetRequest(client, instance_ref)
|
|
|
|
objects = client.MakeRequests([get_request])
|
|
|
|
new_object = self.Modify(holder.resources, args, instance_ref, objects[0])
|
|
|
|
# If existing object is equal to the proposed object or if
|
|
# Modify() returns None, then there is no work to be done, so we
|
|
# print the resource and return.
|
|
if objects[0] == new_object:
|
|
log.status.Print(
|
|
'No change requested; skipping update for [{0}].'.format(
|
|
objects[0].name))
|
|
return objects
|
|
|
|
return client.MakeRequests(
|
|
[self.GetSetRequest(client, instance_ref, new_object, objects[0])])
|
|
|
|
def ParseDiskRef(self, resources, args, instance_ref):
|
|
if args.disk_scope == 'regional':
|
|
scope = compute_scopes.ScopeEnum.REGION
|
|
else:
|
|
scope = compute_scopes.ScopeEnum.ZONE
|
|
return instance_utils.ParseDiskResource(resources, args.disk,
|
|
instance_ref.project,
|
|
instance_ref.zone,
|
|
scope)
|