Euca2ools Guide / EC2-Compatible Commands |
Registers a manifest for use with the cloud. Note that the registered image by default is set to private. To make publically available, use the euca-modify-image-attribute and set the --add value to all.
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 ][--virtualization-type type]
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:
|
No |
-s,--snapshot snapshot | EBS snapshot ID to use as the root device | No |
--virtualization-type type | The virtualization type for the new image. Valid values: paravirtual | hvm Note: You should always explicitly declare the instance type of a bundle created with
euca-bundle-instance as an HVM type
using --virtualization-type parameter.
|
No |
--platform windows | [Privileged] Indicates that the new image is a Windows image. | No |
Option | Description |
---|---|
--show-empty-fields | Show empty fields as "(nil)". |
--region user@region | Region and/or user name to search when looking up config file data. Only valid for EC2 endpoints. |
-U,--url url | URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean. |
-I,--access-key-id key_id | User's access key ID. |
-S,--secret-key secret_key | User's secret key. |
--security-token token | User's security token. |
--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. |
euca-register -a i386 --description 'My new image' --name 'myimage' mah-bukkit/myimage.img.manifest.xml IMAGE emi-15A1386E