autopkgtest-build-qemu - Create autopkgtest virtual machine images for
autopkgtest-virt-qemu
autopkgtest-build-qemu [
OPTIONS]
RELEASE IMAGE
[
MIRROR] [
ARCHITECTURE] [
SCRIPT] [
SIZE]
autopkgtest-build-qemu creates virtual machine images suitable for use
with autopkgtest's QEMU runner
autopkgtest-virt-qemu(1).
Under the hood, it uses
vmdb2(1) to create the images.
Note that you need to call this as root, unless
fakemachine(1) is
available. fakemachine is currently only available on x86_64.
- RELEASE
-
The release to download from the MIRROR. This parameter is required.
- IMAGE
-
The file to write, in qcow2 format. This parameter is required.
-
--mirror=MIRROR
-
Specify which distribution to install. It defaults to
http://deb.debian.org/debian (i.e. Debian), but you can pass a
mirror of any Debian derivative.
The third positional parameter is a deprecated way to specify this.
-
--architecture=ARCHITECTURE
-
Set the architecture for the virtual machine image, specified as a
dpkg(1) architecture. If omitted, the host architecture is assumed.
--arch=ARCH is an alias for this option.
The fourth positional parameter is a deprecated way to specify this.
-
--script=SCRIPT
-
Specifies a user script that will be called with the root filesystem of the
image as its first parameter. This script can them make any necesssary
modifications to the root filesystem.
The script must be a POSIX shell script, and should not depend on
bash-specific features. This script will be executed inside a
chroot(1) call in the virtual machine root filesystem.
The fifth positional parameter is a deprecated way to specify this.
-
--size=SIZE
-
Specifies the image size for the virtual machine, defaulting to 25G.
The sixth positional parameter is a deprecated way to specify this.
-
--apt-proxy=PROXY
-
Specify an apt proxy to use in the virtual machine. By default, if you have
an apt proxy configured on the host, the virtual machine will
automatically use this, otherwise there is no default.
--apt-proxy=DIRECT can be used to force an apt proxy on the host to
be ignored.
-
--boot=auto|bios|efi|ieee1275|none
-
Select the way the generated image will expect to be booted.
auto chooses a suitable boot mode for the architecture, and is the
default.
bios installs an x86 BIOS bootloader on i386 or amd64. auto
selects this mode on i386 or amd64.
efi installs an EFI bootloader on any architecture for which
vmdb2(1) supports it, which currently means amd64, arm64, armhf or
i386. The --efi option is an alias for this mode. auto
selects this mode on arm64 or armhf.
ieee1275 installs an IEEE 1275 (OpenFirmware) bootloader on ppc64el.
auto selects this mode on ppc64el.
none does not do anything special. The image will not be bootable
unless the specified --script arranges for a suitable bootloader to
be installed, or the autopkgtest-virt-qemu(1) --qemu-options
boot the image specially (for example by specifying a kernel directly).
If the
$AUTOPKGTEST_KEEP_APT_SOURCES environment variable is set to a
non-empty value,
autopkgtest-build-qemu will keep whatever
/etc/apt/sources.list was created by
debootstrap.
Otherwise, if the
$AUTOPKGTEST_APT_SOURCES_FILE environment variable is
set to a non-empty value, for example
AUTOPKGTEST_APT_SOURCES_FILE=/home/me/mydistro/sources.list, then
autopkgtest-build-qemu 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/mydistro/sources.list),
autopkgtest-build-qemu will write
it directly into
/etc/apt/sources.list in the virtual machine.
You can specify an apt proxy to use in the virtual machine in the
$AUTOPKGTEST_APT_PROXY environment variable. If you have an apt proxy
configured on the host, the virtual machine will automatically use this,
otherwise there is no default.
# autopkgtest-build-qemu unstable /path/to/debian-unstable.img
$ sudo autopkgtest-build-qemu stable /path/to/debian-stable-i386.img i386
$ sudo autopkgtest-build-qemu bionic /path/to/ubuntu-bionic.img
http://archive.ubuntu.com/ubuntu
autopkgtest-virt-qemu(1),
vmdb2(1),
autopkgtest(1),
/usr/share/doc/autopkgtest/.
autopkgtest-build-qemu was written by Antonio Terceiro
<
[email protected]>
This manpage is part of autopkgtest, a tool for testing Debian binary packages.
autopkgtest is Copyright (C) 2006-2018 Canonical Ltd and others.
See
/usr/share/doc/autopkgtest/CREDITS for the list of contributors and
full copying conditions.