File: //snap/google-cloud-cli/394/lib/surface/compute/images/export.py
# -*- coding: utf-8 -*- #
# Copyright 2018 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.
"""Export image command."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.compute import base_classes
from googlecloudsdk.api_lib.compute import daisy_utils
from googlecloudsdk.api_lib.compute import image_utils
from googlecloudsdk.api_lib.storage import storage_api
from googlecloudsdk.api_lib.storage import storage_util
from googlecloudsdk.calliope import base
from googlecloudsdk.calliope import exceptions
from googlecloudsdk.command_lib.compute.images import flags
from googlecloudsdk.core import properties
from googlecloudsdk.core import resources as core_resources
_OUTPUT_FILTER = ['[Daisy', '[image-export', ' image', 'ERROR']
@base.DefaultUniverseOnly
@base.ReleaseTracks(base.ReleaseTrack.GA)
class Export(base.CreateCommand):
"""Export a Compute Engine image."""
@staticmethod
def Args(parser):
image_group = parser.add_mutually_exclusive_group(required=True)
image_group.add_argument(
'--image',
help='The name of the disk image to export.',
)
image_group.add_argument(
'--image-family',
help=('The family of the disk image to be exported. When a family '
'is used instead of an image, the latest non-deprecated image '
'associated with that family is used.'),
)
image_utils.AddImageProjectFlag(parser)
flags.compute_flags.AddZoneFlag(
parser, 'image', 'export',
help_text='The zone to use when exporting the image. When you export '
'an image, the export tool creates and uses temporary VMs '
'in your project for the export process. Use this flag to '
'specify the zone to use for these temporary VMs.')
parser.add_argument(
'--destination-uri',
required=True,
help=('The Cloud Storage URI destination for '
'the exported virtual disk file.'),
)
# Export format can take more values than what we list here in the help.
# However, we don't want to suggest formats that will likely never be used,
# so we list common ones here, but don't prevent others from being used.
parser.add_argument(
'--export-format',
help=('Specify the format to export to, such as '
'`vmdk`, `vhdx`, `vpc`, or `qcow2`.'),
)
parser.add_argument(
'--network',
help=('The name of the network in your project to use for the image '
'export. When you export an image, the export tool creates and '
'uses temporary VMs in your project for the export process. Use '
'this flag to specify the network to use for these temporary VMs.'
),
)
parser.add_argument(
'--subnet',
help="""\
Name of the subnetwork in your project to use for the image export. When
you export an image, the export tool creates and uses temporary VMs in
your project for the export process. Use this flag to specify the
subnetwork to use for these temporary VMs.
* If the network resource is in legacy mode, do not provide this
property.
* If the network is in auto subnet mode, specifying the subnetwork is
optional.
* If the network is in custom subnet mode, then this field must be
specified.
"""
)
daisy_utils.AddComputeServiceAccountArg(
parser, 'image export',
daisy_utils.EXPORT_ROLES_FOR_COMPUTE_SERVICE_ACCOUNT)
daisy_utils.AddCloudBuildServiceAccountArg(
parser,
'image export',
daisy_utils.EXPORT_ROLES_FOR_CLOUDBUILD_SERVICE_ACCOUNT,
)
daisy_utils.AddCommonDaisyArgs(
parser,
operation='an export',
extra_timeout_help=("""
If you are exporting a large image that takes longer than 24 hours to
export, either use the RAW disk format to reduce the time needed for
converting the image, or split the data into several smaller images.
"""))
parser.display_info.AddCacheUpdater(flags.ImagesCompleter)
def Run(self, args):
try:
gcs_uri = daisy_utils.MakeGcsObjectUri(args.destination_uri)
except (storage_util.InvalidObjectNameError,
core_resources.UnknownCollectionException):
raise exceptions.InvalidArgumentException(
'destination-uri',
'must be a path to an object in Google Cloud Storage')
tags = ['gce-daisy-image-export']
export_args = []
daisy_utils.AppendNetworkAndSubnetArgs(args, export_args)
daisy_utils.AppendArg(export_args, 'zone',
properties.VALUES.compute.zone.Get())
daisy_utils.AppendArg(export_args, 'scratch_bucket_gcs_path',
'gs://{0}/'.format(self._GetDaisyBucket(args)))
daisy_utils.AppendArg(export_args, 'timeout',
'{}s'.format(daisy_utils.GetDaisyTimeout(args)))
daisy_utils.AppendArg(export_args, 'client_id', 'gcloud')
source_image = self._GetSourceImage(args.image, args.image_family,
args.image_project)
daisy_utils.AppendArg(export_args, 'source_image', source_image)
daisy_utils.AppendArg(export_args, 'destination_uri', gcs_uri)
if args.export_format:
daisy_utils.AppendArg(export_args, 'format', args.export_format.lower())
if 'compute_service_account' in args:
daisy_utils.AppendArg(export_args, 'compute_service_account',
args.compute_service_account)
return self._RunImageExport(args, export_args, tags, _OUTPUT_FILTER)
def _RunImageExport(self, args, export_args, tags, output_filter):
return daisy_utils.RunImageExport(
args,
export_args,
tags,
_OUTPUT_FILTER,
release_track=self.ReleaseTrack().id.lower()
if self.ReleaseTrack() else None)
def _GetSourceImage(self, image, image_family, image_project):
holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
client = holder.client
resources = holder.resources
project = properties.VALUES.core.project.GetOrFail()
image_expander = image_utils.ImageExpander(client, resources)
image = image_expander.ExpandImageFlag(
user_project=project, image=image, image_family=image_family,
image_project=image_project, return_image_resource=False)
image_ref = resources.Parse(image[0], collection='compute.images')
return image_ref.RelativeName()
@staticmethod
def _GetDaisyBucket(args):
storage_client = storage_api.StorageClient()
bucket_location = storage_client.GetBucketLocationForFile(
args.destination_uri)
return daisy_utils.CreateDaisyBucketInProject(
bucket_location,
storage_client,
enable_uniform_level_access=True,
soft_delete_duration=0)
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class ExportBeta(Export):
"""Export a Compute Engine image for Beta release track."""
@classmethod
def Args(cls, parser):
super(ExportBeta, cls).Args(parser)
daisy_utils.AddExtraCommonDaisyArgs(parser)
def _RunImageExport(self, args, export_args, tags, output_filter):
return daisy_utils.RunImageExport(
args,
export_args,
tags,
_OUTPUT_FILTER,
release_track=self.ReleaseTrack().id.lower()
if self.ReleaseTrack() else None,
docker_image_tag=args.docker_image_tag)
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
class ExportAlpha(ExportBeta):
"""Export a Compute Engine image for Alpha release track."""
Export.detailed_help = {
'brief':
'Export a Compute Engine image',
'DESCRIPTION':
"""\
*{command}* exports virtual disk images from Compute Engine.
By default, images are exported in the Compute Engine format,
which is a `disk.raw` file that is tarred and gzipped.
The `--export-format` flag exports the image to a format supported
by QEMU using qemu-img. Valid formats include `vmdk`, `vhdx`, `vpc`,
`vdi`, and `qcow2`.
Before exporting an image, set up access to Cloud Storage and grant
required roles to the user accounts and service accounts. For more
information, see [](https://cloud.google.com/compute/docs/import/requirements-export-import-images).
""",
'EXAMPLES':
"""\
To export a VMDK file ``my-image'' from a project ``my-project'' to a
Cloud Storage bucket ``my-bucket'', run:
$ {command} --image=my-image --destination-uri=gs://my-bucket/my-image.vmdk --export-format=vmdk --project=my-project
"""
}