Collapse AllExpand All

euca-register

Registers a manifest for use with the cloud.

Syntax

euca-register [manifest] -n name [-d description ] 
				[-a architecture ][--kernel kernel ] [--ramdisk ramdisk ]
				[--root-device-name root_device_name ] [-b block_device_mapping ] 
				[-s snapshot ]

Options

Option Description Required
manifest Path to the uploaded image (bucket/manifest). Required if you are registering an S3-based image. Conditional
-n,--name Name of the image.
Constraints: 3-128 alphanumeric characters, parenthesis (()), commas (,), slashes (/), dashes (-), or underscores(_)
Yes
-d,--description description Description of the image
Constraints: Up to 255 characters.
No
-a,--architecture architecture The architecture of the image
Valid Values: i386 | x86_64
No
--kernel Kernel ID associated with the image No
--ramdisk Ramdisk ID associated with the image No
--root-device-name name Root device name (for example, /dev/sda1, or xvda) No
-b,--block-device-mapping mapping Block device mapping for the instance. This is passed in the form of <devicename>=<blockdevice>, where: devicename is the device name of the physical device on the instance to map and blockdevice is one of the following values:
  • none: Use this value to suppress existing mapping on the specified image for this device. For example: /dev/sdc=none
  • ephemeral[0..3]: Use this value to indicate that an instance local storage device should be mapped to this device. For example: /dev/sdc=ephemeral0
  • [snapshot-id]:[size]:[delete-on-termination (true|false)]: Use this value to map a device to an existing EBS-backed volume, and to specify whether the EBS volume should be deleted on termination. This value defaults to true.
    To specify a new EBS-backed volume, skip the snapshot ID and pass in a volume size instead. For example: /dev/sdb=:20.
No
-s,--snapshot snapshot EBS snapshot ID to use as the root device No

Common Options

Option Description
--region region Region to direct requests to. Only valid for EC2 endpoints.
-U,--url url URL of the cloud to connect to. Expects an EC2 endpoint /services/Eucalyptus.
-a,--access-key access_key_id User's access key ID
-s,--secret-key secret_key User's secret key
--config configuration_path Read credentials and cloud settings from the specified config file.
Default: $HOME/.eucarc or /etc/euca2ools/eucarc.
--debug Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
--debugger Enable interactive debugger on error
-h,--help Display the manual page for the command.
--version Display the version of this tool

Output

  • Output type identifier ("IMAGE")
  • Image ID

Example

euca-register -a i386 --description 'My new image' --name 'myimage'
mah-bukkit/myimage.img.manifest.xml
IMAGE   emi-15A1386E