NAME

       adt-buildvm-ubuntu-cloud - Create Ubuntu cloud image based VM for adt-virt-qemu

SYNOPSYS

       adt-buildvm-ubuntu-cloud [options]

DESCRIPTION

       adt-buildvm-ubuntu-cloud  downloads an Ubuntu cloud image and configures it for autopkgtest's QEMU runner
       (adt-virt-qemu):

       *   Resize the image to 6 GB (by default, you can  change  this  with  an  option),  which  ought  to  be
           sufficient for most tests.

       *   Create an user "ubuntu" with password "ubuntu".

       *   Add apt sources for "restricted" and "multiverse" components.

       *   Create  an  init.d  script  to start a root shell on ttyS1 at boot, so that adt-virt-qemu can be used
           without additional arguments or logging in through ttyS0.

           You can select release, architecture, apt proxy, etc. with options. The defaults are aimed at testing
           the development series of the architecture of your host system.

OPTIONS

       -a arch | --arch=arch
              Ubuntu architecture name, e. g. "i386" or "amd64". Default is the host system architecture.

       -r codename | --release=codename
              Ubuntu release code name, e. g. "trusty". Default is the current development  series  (this  needs
              python-distro-info installed).

       -m URL | --mirror=URL
              Mirror for apt (default: http://archive.ubuntu.com/ubuntu).

       -p URL | --proxy=URL
              Proxy for apt (no default).

       --cloud-image-url=URL
              URL from where to download the cloud images (default: http://cloud-images.ubuntu.com).

       -s DISK_SIZE | --disk-size=DISK_SIZE
              Grow  downloaded  image  (which  have  a default size of 2GB) by this size (default: 4G, i. e. the
              image will be 6GB big in total).

       -o DIR | --output-dir=DIR
              Output directory for generated image (default: current directory).

       -q command | --qemu-command=command
              QEMU command to run. This defaults to the qemu-system-* that matches your system architecture.

       -v | --verbose
              Show VM guest and cloud-init output.

       --no-apt-upgrade
              Do not run apt-get dist-upgrade during initialization.

CONFIGURATION FILES

       If you use lots of options, you can put parts of, or the whole command line into a text  file,  with  one
       line per option. E. g. you can create a file trusty-i386.cfg with contents like

              -rtrusty
              -ai386
              --proxy=http://mysquid.mynetwork
              -v

       and then run

              adt-buildvm-ubuntu-cloud @trusty-i386.cfg

       The  contents of the configuration file will be expanded in-place as if you would have given its contents
       on the command line. Please ensure that you don't place spaces between short options  and  their  values,
       they would become a part of the argument value.

SEE ALSO

       adt-virt-qemu(1), adt-run(1), http://cloud-images.ubuntu.com, /usr/share/doc/autopkgtest/.

AUTHORS AND COPYRIGHT

       adt-buildvm-ubuntu-cloud was written by Martin Pitt <martin.pitt@ubuntu.com>

       This manpage is part of autopkgtest, a tool for testing Debian binary packages.  autopkgtest is Copyright
       (C) 2006-2014 Canonical Ltd and others.

       See /usr/share/doc/autopkgtest/CREDITS for the list of contributors and full copying conditions.

Linux Programmer's Manual                             2014                           adt-buildvm-ubuntu-cloud(1)