xenial (1) adt-build-lxc.1.gz

Provided by: autopkgtest_3.20.4ubuntu1_all bug

NAME
       adt-build-lxc - Create or update autopkgtest container for adt-virt-lxc


SYNOPSIS
       adt-build-lxc distribution release [architecture]


DESCRIPTION
       adt-build-lxc  creates  or  updates  an LXC container adt-release which is suitable for autopkgtest's LXC
       runner adt-virt-lxc(1).

       It calls lxc-create with the distribution  template  (which  can  currently  be  debian  or  ubuntu)  and
       -rrelease  to  build  a  debootstrap-like  container,  then enables deb-src apt sources, and runs apt-get
       update.

       It defaults to the native architecture, but you can specify a different one as third parameter.

       If the container already exists, it updates it as unintrusively as  possible  by  first  creating  a  new
       temporary  container  adt-release.new,  and  then rsyncing its root file system back to the existing adt-
       release. Note that this could cause some side-effects and breakage if you have  running  containers  with
       ephemeral overlays (i. e. using the --ephemeral option), but it does work in general. This update process
       does not interfere at all if you use adt-virt-lxc with cloning.

       Note that you need to call this as root, unless you set up LXC to allow  per-user  containers.  But  user
       containers will not work with many or even most autopkgtests.

       You  can specify an apt proxy to use in the container in the $ADT_APT_PROXY environment variable. If apt-
       cacher-ng is running on the local host, the container will automatically use this (i. e. use the IP  from
       the lxcbr0 interface) otherwise there is no default.


EXAMPLES
       # adt-build-lxc debian sid

       $ sudo adt-build-lxc ubuntu trusty i386


SEE ALSO
       adt-virt-lxc(1), adt-run(1), lxc-create(1), /usr/share/doc/autopkgtest/.


       adt-build-lxc 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-2014 Canonical Ltd and others.

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