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

       -h | --help
              Display help message and exit.

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

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

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

       -r REMOTE | --remote REMOTE
              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.

Linux Programmer's Manual                             2015                              autopkgtest-build-lxd(1)