ec2-migrate-bundle
Description
Copy a bundled AMI from one region to another. For information on regions, go to the
![[Note]](note.png) | Note |
|---|---|
After copying a bundled AMI to a new region, make sure to register it as a new AMI.
During migration, Amazon EC2 replaces the kernel and RAM disk in the manifest file with a kernel
and RAM disk designed for the destination region. Unless the --no-mapping parameter is given,
|
Syntax
ec2-migrate-bundle
-k private_key
-c cert
-a access_key_id
-s secret_key
--bucket source_s3_bucket
--destination-bucket destination_s3_bucket
--manifest manifest_path
--location {US | EU}
--ec2cert ec2_cert_path
[--kernel kernel-id]
[--ramdisk ramdisk_id]
{--no-mapping}
--region mapping_region_name
Options
| Option | Description | Required |
|---|---|---|
|
|
The path to the user's PEM-encoded RSA key file. Example: |
Yes |
|
|
The user's PEM encoded RSA public key certificate file. Example: |
Yes |
|
|
The AWS access key ID. Example: |
Yes |
|
|
The AWS secret access key. Example: |
Yes |
|
|
The source Amazon S3 bucket where the AMI is located, followed by an optional '/'-delimited path prefix. Default: None Example: |
Yes |
|
|
The destination Amazon S3 bucket, followed by an optional '/'-delimited path prefix. If the destination bucket does not exist, it is created. Default: None Example: |
Yes |
|
|
The location of the Amazon S3 source manifest. Default: None Example: |
Yes |
|
|
The location of the destination Amazon S3 bucket. If the bucket exists and the location is specified, the tool exits with an error. if the specified location does not match the actual location. If the bucket exists and no location is specified, the tool uses the bucket's location. If the bucket does not exist and the location is specified, the tool creates the bucket in the specified location. If the bucket does not exist and location is not specified, the tool creates the bucket without a location constraint (in the US). Default: None Example: |
No |
|
|
The access control list policy of the bundled image. Valid Values: Default: Example: |
No |
|
|
Automatically retries on all Amazon S3 errors, up to five times per operation. Example: |
No |
|
|
The ID of the kernel to select. Example: |
No |
|
|
The ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk. To find kernel requirements, go to the Resource Center and search for the kernel ID. Example: |
No |
|
|
Disables automatic mapping of kernels and RAM disks. Example: |
No |
|
|
Region to look up in the mapping file. If no region is specified, Amazon EC2 attempts to determine the region from the location of the Amazon S3 bucket. Example: |
No |
Output
Status messages describing the stages and status of the bundling process.
Example
This example copies the AMI specified in the my-ami.manifest.xml
manifest from the US to the EU.
$ec2-migrate-bundle --cert cert-THUMBPRINT.pem --privatekey pk-THUMBPRINT.pem --access-key AKIADQKE4SARGYLE --secret-key eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ== --bucket my-us-bucket --destination-bucket my-eu-bucket --manifest my-ami.manifest.xml --location EUDownloading manifest my-ami.manifest.xml from my-us-bucket to /tmp/ami-migration-my-ami.manifest.xml/my-ami.manifest.xml ... Copying 'my-ami.part.00'... Copying 'my-ami.part.01'... Copying 'my-ami.part.02'... Copying 'my-ami.part.03'... Copying 'my-ami.part.04'... Copying 'my-ami.part.05'... Copying 'my-ami.part.06'... Copying 'my-ami.part.07'... Copying 'my-ami.part.08'... Copying 'my-ami.part.09'... Copying 'my-ami.part.10'... Your new bundle is in S3 at the following location: my-eu-bucket/my-ami.manifest.xml