plucky (1) autopkgtest-buildvm-ubuntu-cloud.1.gz

Provided by: autopkgtest_5.44_all bug

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


SYNOPSIS
       autopkgtest-buildvm-ubuntu-cloud [options]


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

       *   Resize the image adding 20 GB to its default size (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 autopkgtest-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. If you have an apt proxy configured on the local host, the  VM  will  automatically
              use this; otherwise there is 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 by this size (default: 20G).

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

       --force-use-cached
              Use cached image without verifying it against the currently published digests.

       -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.

       --post-command=COMMAND
              Run shell command in the VM after the setup.

       --metadata=METADATA_FILE
              Use a custom cloud-init metadata file to initialize the cloud image VM.

       --userdata=USERDATA_FILE
              Use a custom cloud-init userdata file to initialize the cloud image VM.

       --timeout=SECONDS
              Timeout for cloud-init. Default is 3600 s.

       --ram-size=MiB
              VM RAM size in MiB. Default is 512 MiB.

       --cpus=CPUS
              VM number of CPUs. Default is 1.


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

              autopkgtest-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.


ENVIRONMENT
       If  the   $AUTOPKGTEST_KEEP_APT_SOURCES   environment   variable   is   set   to   a   non-empty   value,
       autopkgtest-buildvm-ubuntu-cloud  will  keep  whatever  /etc/apt/sources.list  was  set in the downloaded
       image.

       Otherwise, if the $AUTOPKGTEST_APT_SOURCES_FILE environment variable is set to  a  non-empty  value,  for
       example  AUTOPKGTEST_APT_SOURCES_FILE=/home/me/ubuntu/sources.list, then autopkgtest-buildvm-ubuntu-cloud
       will read that file (on the host system) and use it to  populate  /etc/apt/sources.list  in  the  virtual
       machine; or if the $AUTOPKGTEST_APT_SOURCES environment variable is set to a non-empty value, for example
       AUTOPKGTEST_APT_SOURCES=$(cat /home/me/ubuntu/sources.list), autopkgtest-buildvm-ubuntu-cloud will  write
       it directly into /etc/apt/sources.list in the virtual machine.

       When $AUTOPKGTEST_APT_SOURCES_FILE or $AUTOPKGTEST_APT_SOURCES contain sources in the deb822 format, then
       sources are written  to  /etc/apt/sources.list.d/ubuntu.sources  in  the  virtual  machine,  rather  than
       /etc/apt/sources.list.


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


       autopkgtest-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.