autopkgtest-buildvm-ubuntu-cloud(1)

Create Ubuntu cloud image based VM for autopkgtest-virt-qemu

Section 1 autopkgtest bookworm source

Description

autopkgtest-buildvm-ubuntu-cloud

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.

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.

AUTHORS AND COPYRIGHT

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

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