bionic (1) euca-bundle-and-upload-image.1.gz

NAME

       euca-bundle-and-upload-image - Prepare and upload an image for use in the cloud

SYNOPSIS

       euca-bundle-and-upload-image [--preserve-bundle]

       [--max-pending-parts MAX_PENDING_PARTS] -i
              FILE  [-p PREFIX] [-d DIR] -r {i386,x86_64,armhf,ppc,ppc64,ppc64le} [-k FILE] [-c FILE] [--ec2cert
              FILE]  [-u  ACCOUNT]  [--kernel  IMAGE]  [--ramdisk  IMAGE]  [--bootstrap-url  BOOTSTRAP_URL]  [-B
              VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...]      [--productcodes     CODE1,CODE2,...]     [--image-size
              IMAGE_SIZE]     -b     BUCKET[/PREFIX]     [--acl     {public-read,aws-exec-read,ec2-bundle-read}]
              [--upload-policy   POLICY   |  --upload-policy-file  FILE]  [--upload-policy-signature  SIGNATURE]
              [--location LOCATION] [--retry] [--progress | --no-progress] [-U URL] [--region  USER@REGION]  [-I
              KEY_ID] [-S KEY] [--security-token TOKEN] [--debug] [--debugger] [--version] [-h]

DESCRIPTION

       Prepare and upload an image for use in the cloud

   optional arguments:
       --preserve-bundle
              do not delete the bundle as it is being uploaded

       --max-pending-parts MAX_PENDING_PARTS
              pause  the  bundling  process  when  more  than  this  number  of parts are waiting to be uploaded
              (default: 2)

       -i FILE, --image FILE
              file containing the image to bundle (required)

       -p PREFIX, --prefix PREFIX
              the file name prefix to give the bundle's files (required when bundling stdin; otherwise  defaults
              to the image's file name)

       -d DIR, --destination DIR
              location  to  place  the  bundle's  files  (default: dir named by TMPDIR, TEMP, or TMP environment
              variables, or otherwise /var/tmp)

       -r {i386,x86_64,armhf,ppc,ppc64,ppc64le}, --arch {i386,x86_64,armhf,ppc,ppc64,ppc64le}
              the image's architecture (required)

       -k FILE, --privatekey FILE
              file containing your private key to sign the bundle's manifest with. If one is not  available  the
              bundle will not be signed.

       -c FILE, --cert FILE
              file  containing  your  X.509  certificate.  If  one  is  not available it will not be possible to
              unbundle the bundle without cloud administrator assistance.

       --ec2cert FILE
              file containing the cloud's X.509 certificate.  If  one  is  not  available  locally  it  must  be
              available from the bootstrap service.

       -u ACCOUNT, --user ACCOUNT
              your account ID

       --kernel IMAGE
              ID of the kernel image to associate with this machine image

       --ramdisk IMAGE
              ID of the ramdisk image to associate with this machine image

       --bootstrap-url BOOTSTRAP_URL
              [Eucalyptus only] bootstrap service endpoint URL (used for obtaining --ec2cert automatically

       -B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,..., --block-device-mappings VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...
              block device mapping scheme with which to launch instances of this machine image

       --productcodes CODE1,CODE2,...
              comma-separated list of product codes for the image

       --image-size IMAGE_SIZE
              the image's size (required when bundling stdin)

       -b BUCKET[/PREFIX], --bucket BUCKET[/PREFIX]
              bucket to upload the bundle to (required)

       --acl {public-read,aws-exec-read,ec2-bundle-read}
              canned ACL policy to apply to the bundle (default: aws-exec-read)

       --upload-policy POLICY
              upload policy to use for authorization

       --upload-policy-file FILE
              file containing an upload policy to use for authorization

       --upload-policy-signature SIGNATURE
              signature for the upload policy (required when an 'upload policy is used)

       --location LOCATION
              location  constraint  of  the destination bucket (default: inferred from s3-location-constraint in
              configuration, or otherwise none)

       --retry
              retry failed uploads up to 5 times

       --progress
              show progress (the default when run interactively)

       --no-progress
              do not show progress (the default when run noninteractively)

       -U URL, --url URL
              object storage service endpoint URL

       --region USER@REGION
              region and/or user names to search when looking up config file data

       -I KEY_ID, --access-key-id KEY_ID

       -S KEY, --secret-key KEY

       --security-token TOKEN

       --debug
              show debugging output

       --debugger
              launch interactive debugger on error

       --version
              show the program's version and exit

       -h, --help
              show this help message and exit