Euca2ools Guide / EC2-Compatible Commands |
Bundles an image for use with Eucalyptus or Amazon EC2, compressing, encrypting and signing a snapshot of the local machine's root file system.
euca-bundle-vol [-p PREFIX] [-d DIR] [-r {i386,x86_64,armhf,ppc,ppc64}] [-e PATH,...] [-i PATH,...] [-s MiB] [--no-filter] [--all] [--inherit | --no-inherit] [-v DIR] [-P {mbr,gpt,none}] [-S FILE] [--fstab FILE | --generate-fstab] [--grub-config FILE] [-k FILE] [-c FILE] [--ec2cert FILE] [-u ACCOUNT] [--kernel IMAGE] [--ramdisk IMAGE] [-B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...] [--productcodes CODE1,CODE2,...] [--progress | --no-progress] [--debug] [--debugger] [--version] [-h]
Option | Description | Required |
---|---|---|
-p,--prefix prefix | File name prefix for the bundle files. Default is "image". | No |
-k,--privatekey private_key | Path to user's PEM-encoded private key. | Yes |
-u,--user user_id | 12-digit account ID of the person who is bundling the image. | Yes |
-c,--cert | Path the user's PEM-encoded certificate. | Yes |
-r architecture, --arch architecture | Target architecture for the image.
Default: x86_64 Valid values: i386 | x86_64 | armhf | ppc | ppc64 |
Yes |
-s,--size size_in_mib | Size of the image in MiB. Default: 10240 MiB |
No |
-B,--block-device-mapping | Default block device mapping for the image. The format of the mapping is a comma-separated list of key=value pairs. | No |
-d directory, --destination directory | Directory where the bundle image files go. Eucalyptus
recommends that you include this option where
allowed. This is the directory specified by
TMPDIR, TEMP, or TMP environment variables.
Default: /var/tmp |
No |
-e,--exclude directory_1, directory_2,... | Comma-separated list of directories to exclude. Default exclusions are stored in /etc/euca2ools/bundle-vol/excludes. | No |
-i,--include directory_1, directory_2,... | Comma-separated list of directories to include. | No |
-a,--all | Bundle all directories (including mounted filesystems). | No |
--inherit | Explicitly inherit instance metadata and add it to the bundled image (this is the default behavior). | No |
--no-inherit | Do not inherit instance metadata and add it to the bundled image. | No |
-P, --partition | Which partition standard you want to use: Master Boot Record, GUID Partition Table, or
no partition
Valid values: mbr | gpt | none |
|
--no-filter | Do not use the default filtered files list. | No |
--fstabpath | Path to the fstab to bundle in the image. | No |
--generate-fstab | Generate fstab to bundle in the image. | No |
--ec2certfile | File containing the cloud's X.509 certificate. | No |
--kernelimage | ID of the kernel image to associate with the machine bundle. | No |
--ramdiskimage | ID of the ramdisk image to associate with the machine bundle. | No |
-\-productcodescode1 [, code2, ...] | Comma-delimited list of product codes. | No |
--progress | Show a progress bar during command execution. This is the default when this command is run interactively. | No |
--no-progress | Do not show a progress bar during command execution. This is the default when this command is run non-interactively. | No |
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 |
--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 |
Eucalyptus returns status messages describing the stages and status of the bundling.
euca-bundle-vol -d /mnt/ebsvol -p myimage -s 2048 --arch x86_64 1+0 records in 1+0 records out 1048576 bytes (1.0 MB) copied, 0.00358811 s, 292 MB/s mke2fs 1.41.9 (22-Aug-2009) Filesystem label= OS type: Linux Block size=4096 (log=2) Fragment size=4096 (log=2) 131072 inodes, 524288 blocks 26214 blocks (5.00%) reserved for the super user First data block=0 Maximum filesystem blocks=536870912 16 block groups 32768 blocks per group, 32768 fragments per group 8192 inodes per group Superblock backups stored on blocks: 32768, 98304, 163840, 229376, 294912 Writing inode tables: done Creating journal (16384 blocks): done Writing superblocks and filesystem accounting information: done This filesystem will be automatically checked every 39 mounts or 180 days, whichever comes first. Use tune2fs -c or -i to override. Checking image Tarring image Encrypting image Splitting image... Part: myimage.part.0 Part: myimage.part.1 Part: myimage.part.2 Part: myimage.part.3 Part: myimage.part.4 Part: myimage.part.5 Part: myimage.part.6 Part: myimage.part.7 Part: myimage.part.8 Part: myimage.part.9 Part: myimage.part.10 Part: myimage.part.11 Part: myimage.part.12 Part: myimage.part.13 Part: myimage.part.14 Part: myimage.part.15 Part: myimage.part.16 Part: myimage.part.17 Part: myimage.part.18 Part: myimage.part.19 Part: myimage.part.20 Part: myimage.part.21 Part: myimage.part.22 Generating manifest /mnt/ebsvol/myimage.manifest.xml