SYNOPSYS

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

RELATED TO adt-build-lxc…

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

AUTHORS AND COPYRIGHT

adt-build-lxc was written by Martin Pitt <[email protected]>

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.