ec2-upload-bundle

Amazon Elastic Compute Cloud: 2008-02-01

previous page next page

ec2-upload-bundle

 Syntax

ec2-upload-bundle -b s3_bucket -m manifest -a access_key_id -s secret_key [--acl acl] [--ec2cert certificate] [-d directory] [--part part] [--url url] [--retry] [--skipmanifest]

Description

Upload a bundled AMI to Amazon S3 storage.

Options

[Note] Note

This tool does not support the Common Options.

Option Description Required

-b, --bucket s3_bucket

The name of the Amazon S3 bucket in which to store the bundle. If the bucket doesn't exist it will be created (if the bucket name is available).

Example: -b aes-cracker-ami

Yes

-m, --manifest manifest

The path to the manifest file. The manifest file is created during the bundling process and can be found in the directory containing the bundle.

Example: -m /var/spool/my-first-bundle/Manifest

Yes

-a, --access-key access_key_id

Your AWS access key ID.

Example: -a 10QMXFEV71ZS32XQFTR2

Yes

-s, --secret-key secret_key

Your AWS secret access key.

Example: -s DMADSSfPfdaDjbK+RRUhS/aDrjsiZadgAUm8gRU2

Yes

--acl acl

The access control list policy of the bundled image.

Valid Values: public-read | aws-exec-read

Default: aws-exec-read

Example: --acl public-read

No

--ec2cert certificate

The path to the Amazon EC2 X509 public key certificate.

Default: /etc/aes/amiutil/cert-ec2.pem

Example: --ec2cert /etc/aes/amiutil/cert-ec2.pem

No

-d, --directory directory

The directory containing the bundled AMI parts.

Default: The directory containing the manifest file (see the -m option).

Example: -d /var/run/my-bundle

No

--part part

Starts uploading the specified part and all subsequent parts.

Example: --part

No

--url url

The S3 service URL.

Default: https://s3.amazonaws.com

Example: --url https://s3.amazonaws.ie

No

--retry

Automatically retries failed uploads. Use with caution.

Example: --retry

No

--skipmanifest

Does not upload the manifest.

Example: --skipmanifest

No

--help

Display the help message.

Example: --help

No

--manual

Display the manual entry.

Example: --manual

No

Output

Amazon EC2 displays status messages that indicate the stages and status of the upload process.

Example

This example uploads the bundle specified by the bundled/fred.manifest.xml manifest.

$ ec2-upload-bundle -b my-s3-bucket -m bundled/fred.manifest.xml -a 10QMXFEV71ZS32XQFTR2 -s DMADSSfPfdaDjbK+RRUhS/aDrjsiZadgAUm8gRU2 -d bundled
Encrypting bundle manifest...
Completed encryption.
Uploading encrypted manifest...
Uploaded encrypted manifest to http://s3.amazonaws.com:80/alpowell-images/fred.manifest.xml.
Uploading bundled AMI parts to http://s3.amazonaws.com:80/alpowell-images...
Uploaded fred.part.00 to http://s3.amazonaws.com:80/alpowell-images/fred.part.00.
Uploaded fred.part.01 to http://s3.amazonaws.com:80/alpowell-images/fred.part.01.
Uploaded fred.part.02 to http://s3.amazonaws.com:80/alpowell-images/fred.part.02.
Uploaded fred.part.03 to http://s3.amazonaws.com:80/alpowell-images/fred.part.03.
Uploaded fred.part.04 to http://s3.amazonaws.com:80/alpowell-images/fred.part.04.
Uploaded fred.part.05 to http://s3.amazonaws.com:80/alpowell-images/fred.part.05.
Uploaded fred.part.06 to http://s3.amazonaws.com:80/alpowell-images/fred.part.06.
Uploaded fred.part.07 to http://s3.amazonaws.com:80/alpowell-images/fred.part.07.
Uploaded fred.part.08 to http://s3.amazonaws.com:80/alpowell-images/fred.part.08.
Uploaded fred.part.09 to http://s3.amazonaws.com:80/alpowell-images/fred.part.09.
Uploaded fred.part.10 to http://s3.amazonaws.com:80/alpowell-images/fred.part.10.
Uploaded fred.part.11 to http://s3.amazonaws.com:80/alpowell-images/fred.part.11.
Uploaded fred.part.12 to http://s3.amazonaws.com:80/alpowell-images/fred.part.12.
Uploaded fred.part.13 to http://s3.amazonaws.com:80/alpowell-images/fred.part.13.
Uploaded fred.part.14 to http://s3.amazonaws.com:80/alpowell-images/fred.part.14.
Upload Bundle complete.

Related Topics

previous page start next page