Provided by: autopkgtest_5.32ubuntu3~23.10.1_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 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
           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 (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.

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

SEE ALSO

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

AUTHORS AND COPYRIGHT

       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.