adt-virt-lxc - autopkgtest virtualisation server using LXC
provides an autopkgtest virtualisation server using LXC. It
adapts the raw functionality provided by the lxc-
* tools for use by
will be invoked by adt-run
You can conveniently create a suitable container using the
assumes that you have already prepared a suitable Debian
based LXC container. See lxc-create(1)
for how to create containers.
- -e | --ephemeral
- This option makes use of lxc-start-ephemeral to create
temporary container overlays, instead of the default behaviour of cloning
your containers. This can be used to dramatically improve performance,
although you may see issues due to the overlayfs filesystem as used by
lxc-start-ephemeral not being completely transparent (e. g. seen with tar
failing when running LXC within Qemu). Before using this option in
automation you should ensure that tests that involve large I/O work as
- -s | --sudo
- Run lxc-* commands through sudo; use this option if you run
adt-run as normal user, but need to run the container itself as root (if
you use LXC system level containers).
- This option is intended for test developer use. It enables
the use of eatmydata(1) inside the container on all commands in
order to improve performance. This requires eatmydata(1) to already
be installed inside the supplied template, which you will need to do
However, since eatmydata is not part of the dep8 specification and may
affect the test environment, it is not recommended for use in automation.
- -d | --debug
- Enables debugging output.
INPUT, OUTPUT AND EXIT STATUS¶
The behaviour of adt-virt-lxc
is as described by the AutomatedTesting
virtualisation regime specification.
does not run apt-get update
at the start of a package
build, which can cause a build failure if you are using a development release
template. You will need to run apt-get update
in the template yourself
(e. g. using --setup-commands
Create a suitable debootstrap-based container for Debian or Ubuntu template, e.
g. a Debian sid one (will be named adt-sid):
Or an Ubuntu one based on the cloud images (faster than adt-build-lxc's
"ubuntu" template with debootstrap, but much bigger):
lxc-create -t ubuntu-cloud -n adt-trusty -- -r trusty -d daily
Run tests against hello_2.8-4.dsc
, using the LXC container
, and with an ephemeral overlay for speed:
adt-run hello_2.8-4.dsc --- adt-virt-lxc -e adt-sid
AUTHORS AND COPYRIGHT¶
was written by Robie Basak <email@example.com>
and Martin Pitt <firstname.lastname@example.org>.
This manpage is part of autopkgtest, a tool for testing Debian binary packages.
autopkgtest is Copyright (C) 2006-2013 Canonical Ltd and others.
for the list of contributors and
full copying conditions.