SYNOPSYS
adt-virt-lxc [options] lxc-container [-- extra lxc-start args...]
DESCRIPTION
adt-virt-lxc provides an autopkgtest virtualisation server using LXC. It adapts the raw functionality provided by the lxc-* tools for use by autopkgtest.Normally adt-virt-lxc will be invoked by adt-run.
You can conveniently create a suitable container using the adt-build-lxc(1) script.
REQUIREMENTS
adt-virt-lxc assumes that you have already prepared a suitable Debian based LXC container. See lxc-create(1) for how to create containers.
OPTIONS
- -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 expected.
- -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).
- --eatmydata
-
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
manually.
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.
You can pass additional options to LXC: Anything after a -- gets passed verbatim to lxc-start/lxc-start-ephemeral.
INPUT, OUTPUT AND EXIT STATUS
The behaviour of adt-virt-lxc is as described by the AutomatedTesting virtualisation regime specification.
NOTES
adt-run 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).
EXAMPLE
Create a suitable debootstrap-based container for Debian or Ubuntu template, e. g. a Debian sid one (will be named adt-sid):
- adt-build-lxc debian 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 adt-sid, and with an ephemeral overlay for speed:
- adt-run hello_2.8-4.dsc --- adt-virt-lxc -e adt-sid
AUTHORS AND COPYRIGHT
adt-virt-lxc was written by Robie Basak <[email protected]> and Martin Pitt <[email protected]>.This manpage is part of autopkgtest, a tool for testing Debian binary packages. autopkgtest is Copyright (C) 2006-2013 Canonical Ltd and others.
See /usr/share/doc/autopkgtest/CREDITS for the list of contributors and full copying conditions.