ec2-upload-bundle

Amazon EC2: API Version 2007-01-03

previous page next page

ec2-upload-bundle

SYNOPSIS

ec2-upload-bundle -b S3-BUCKET -m MANIFEST-PATH -a AWS-ACCESS-KEY-ID -s AWS-SECRET-KEY [--acl ACL] [--ec2cert PATH] [-d DIRECTORY] [--part PART] [--url URL] [--retry] [--skipmanifest]

DESCRIPTION

Upload a bundled AMI to S3 storage.

OUTPUT

Status messages indicating the various stages of the upload process are displayed.

OPTIONS

[Note] Note

Note that this tool does not support the common options

Option Definition Required? Example
-b, --bucket S3-BUCKET The name of the Amazon S3 bucket in which the bundle will be stored. If the bucket doesn't exist it will be created (provided the bucket is available of course). Yes -b aes-cracker-ami
-m, --manifest MANIFEST-PATH 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. Yes -m /var/spool/my-first-bundle/Manifest
-a, --access-key USER The user's AWS access key ID. Yes -a ???????
-s, --secret-key PASSWORD The user's AWS secret access key. Yes -s ???????
--acl ACL The access control list policy of the bundled image. It may be either "public-read" or "aws-exec-read" and defaults to "aws-exec-read" if not specified. No --acl public-read
--ec2cert PATH The path to the EC2 X509 public key certificate. Defaults to "/etc/aes/amiutil/cert-ec2.pem". No --ec2cert /etc/aes/amiutil/cert-ec2.pem
-d, --directory DIRECTORY The directory containing the bundled AMI parts. Defaults to the directory containing the manifest file (see the "-m" option). No -d /var/run/my-bundle
--part PART Start uploading the specified part and upload all subsequent parts. No --part ????
--url URL The S3 service URL. Defaults to https://s3.amazonaws.com. No --url https://s3.amazonaws.ie
--retry Automatically retry failed uploads. Use with caution. No --retry
--skipmanifest Do not upload the manifest. No --skipmanifest
--help Display the help message. No --help
--manual Display the help. No --manual

EXAMPLE 

$ 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.

SEE ALSO

previous page start next page