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.