Scroll to navigation

autopkgtest-build-lxd(1) General Commands Manual autopkgtest-build-lxd(1)

NAME

autopkgtest-build-lxd, autopkgtest-build-incus - Create or update autopkgtest container for autopkgtest-virt-lxd or autopkgtest-virt-incus

SYNOPSIS

autopkgtest-build-lxd image

autopkgtest-build-incus image

DESCRIPTION

autopkgtest-build-lxd creates or updates a LXD or Incus image which is optimized for autopkgtest's LXD/Incus runner autopkgtest-virt-lxd(1) or autopkgtest-virt-incus(1).

When run as autopkgtest-build-lxd or with the --lxd option, LXD is used. When run as autopkgtest-build-incus or with the --incus option, Incus is used.

The images produced by this tool are intended to be suitable for use with either LXD or Incus.

It builds a temporary container from an existing given image, runs autopkgtest's standard setup-commands/setup-testbed script, and publishes it as a new image with the alias autopkgtest/distro/release/architecture.

OPTIONS

Display help message and exit.

Prepare a VM image instead of a container image, to be used with autopkgtest-virt-lxd --vm or autopkgtest-virt-incus --vm.

Use LXD. This is the default when invoked as autopkgtest-build-lxd.

Use Incus. This is the default when invoked as autopkgtest-build-incus.

Run container or VM on given remote host instead of locally; see lxc remote list or incus remote list.

ENVIRONMENT

If the $AUTOPKGTEST_KEEP_APT_SOURCES environment variable is set to a non-empty value, autopkgtest-build-lxd will keep whatever /etc/apt/sources.list was present in the existing 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/mydistro/sources.list, then autopkgtest-build-lxd will read that file (on the host system) and use it to populate /etc/apt/sources.list in the container; 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-lxd will write it directly into /etc/apt/sources.list in the container.

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/<distro>.sources in the container, rather than /etc/apt/sources.list.

You can specify an apt proxy to use in the container in the $AUTOPKGTEST_APT_PROXY environment variable. If you have an apt proxy configured on the host, the container will automatically use this, otherwise there is no default.

For dist-upgrading image to a newer release you can specify the destination release in the $RELEASE environment variable. This is useful when a new distribution series has just been opened and there are no standard images for that available yet.

EXAMPLE

Build a local autopkgtest container image for Debian sid i386, based on the stock Debian image from the public images.linuxcontainers.org remote:

$ autopkgtest-build-lxd images:debian/sid/i386

or:

$ autopkgtest-build-incus images:debian/sid/i386

SEE ALSO

autopkgtest-virt-lxd(1), autopkgtest(1), lxc(1), /usr/share/doc/autopkgtest/.

AUTHORS AND COPYRIGHT

autopkgtest-build-lxd 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-2015 Canonical Ltd and others.

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

2015 Linux Programmer's Manual