File: //lib/python2.7/site-packages/euca2ools/commands/ec2/registerimage.py
# Copyright 2009-2014 Eucalyptus Systems, Inc.
#
# Redistribution and use of this software in source and binary forms,
# with or without modification, are permitted provided that the following
# conditions are met:
#
# Redistributions of source code must retain the above copyright notice,
# this list of conditions and the following disclaimer.
#
# Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
from requestbuilder import Arg
from requestbuilder.exceptions import ArgumentError
from euca2ools.commands.argtypes import ec2_block_device_mapping
from euca2ools.commands.ec2 import EC2Request
class RegisterImage(EC2Request):
DESCRIPTION = 'Register a new image'
ARGS = [Arg('ImageLocation', metavar='MANIFEST', nargs='?',
help='''location of the image manifest in S3 storage
(required for instance-store images)'''),
Arg('-n', '--name', dest='Name', required=True,
help='name of the new image (required)'),
Arg('-d', '--description', dest='Description',
help='description of the new image'),
Arg('-a', '--architecture', dest='Architecture',
choices=('i386', 'x86_64', 'armhf'),
help='CPU architecture of the new image'),
Arg('--kernel', dest='KernelId', metavar='KERNEL',
help='ID of the kernel to associate with the new image'),
Arg('--ramdisk', dest='RamdiskId', metavar='RAMDISK',
help='ID of the ramdisk to associate with the new image'),
Arg('--root-device-name', dest='RootDeviceName', metavar='DEVICE',
help='root device name (default: /dev/sda1)'),
# ^ default is added by main()
Arg('-s', '--snapshot', route_to=None,
help='snapshot to use for the root device'),
Arg('-b', '--block-device-mapping', metavar='DEVICE=MAPPED',
dest='BlockDeviceMapping', action='append',
type=ec2_block_device_mapping, default=[],
help='''define a block device mapping for the image, in the
form DEVICE=MAPPED, where "MAPPED" is "none", "ephemeral(0-3)",
or
"[SNAP-ID]:[GiB]:[true|false]:[standard|VOLTYPE[:IOPS]]"'''),
Arg('--virtualization-type', dest='VirtualizationType',
choices=('paravirtual', 'hvm'),
help='virtualization type for the new image'),
Arg('--platform', dest='Platform', metavar='windows',
choices=('windows',),
help="[Privileged] the new image's platform (windows)")]
# noinspection PyExceptionInherit
def preprocess(self):
if self.args.get('ImageLocation'):
# instance-store image
if self.args.get('RootDeviceName'):
raise ArgumentError('argument --root-device-name: not allowed '
'with argument MANIFEST')
if self.args.get('snapshot'):
raise ArgumentError('argument --snapshot: not allowed with '
'argument MANIFEST')
else:
# Try for an EBS image
if not self.params.get('RootDeviceName'):
self.params['RootDeviceName'] = '/dev/sda1'
snapshot = self.args.get('snapshot')
# Look for a mapping for the root device
for mapping in self.args['BlockDeviceMapping']:
if mapping.get('DeviceName') == self.params['RootDeviceName']:
if (snapshot != mapping.get('Ebs', {}).get('SnapshotId')
and snapshot):
# The mapping's snapshot differs or doesn't exist
raise ArgumentError(
'snapshot ID supplied with --snapshot conflicts '
'with block device mapping for root device {0}'
.format(mapping['DeviceName']))
else:
# No need to apply --snapshot since the mapping is
# already there
break
else:
if snapshot:
self.params['BlockDeviceMapping'].append(
{'DeviceName': self.params['RootDeviceName'],
'Ebs': {'SnapshotId': snapshot}})
else:
raise ArgumentError(
'either a manifest location or a root device snapshot '
'mapping must be specified')
def print_result(self, result):
print self.tabify(('IMAGE', result.get('imageId')))