.TH cloud\-publish\-tarball 1 "17 Feb 2010" cloud\-utils "cloud\-utils"
.SH NAME
cloud\-publish\-tarball \- publish a cloud archive

.SH SYNOPSIS
.BI "cloud\-publish\-tarball [OPTIONS] TARFILE BUCKET [ARCH]"

.SH OPTIONS
.TP
.B -k | --kernel  k
Use previously registered kernel with id 'k' specify 'none' for no kernel
.TP
.B -K | --kernel-file f
Bundle, upload, use file 'f' as kernel
.TP
.B -q | --quiet
Be quiet, only output produced image ids
.TP
.B -r | --ramdisk r
Use previously registered ramdisk with id 'r' specify 'none' for no ramdisk
.TP
.B -R | --ramdisk-file f
Bundle, upload, use file 'f' as ramdisk
.TP
.B --rename-image i
rename the image file before publishing (publish to <bucket>/i)
.TP
.B --rename-kernel k
rename the kernel file before publishing (publish to <bucket>/k)
.TP
.B --rename-ramdisk r
rename the ramdisk file before publishing (publish to <bucket>/r)
.TP
.B --save-downloaded d
save the download image to directory 'd' (applicable only if TARBALL is an URL)

.SH ARGUMENTS
.TP
.B TARFILE
Target archive.  This may be a URL.
.TP
.B BUCKET
Target bucket
.TP
.B ARCH
Image architecture; if is not provided, a name-based attempt is made to guess

.SH ENVIRONMENT
Behavior of this program can be modified by environment variables as described below:

.TP
.B EC2PRE
Underlying tools will be invoked using this prefix.  The default is 'euca-', which results in using tools like 'euca-register' and 'euca-bundle-image'.  To use the ec2-api-tools or ec2-ami-tools, set EC2PRE='ec2-'

.SH DESCRIPTION
Register a Ubuntu Cloud image tarball per http://cloud-images.ubuntu.com

.SH EXAMPLES
  cloud\-publish\-tarball lucid-cloud-i386.tar.gz my-lucid-bucket i386

.SH AUTHOR
This manpage was written by Dustin Kirkland <kirkland@canonical.com> for Ubuntu systems (but may be used by others).  Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.