NAME¶
adt-virt-lxc - autopkgtest virtualisation server using LXC
SYNOPSYS¶
adt-virt-lxc [
options]
lxc-container
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.
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):
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
SEE ALSO¶
adt-run(1),
adt-build-lxc(1),
lxc-create(1),
eatmydata(1),
/usr/share/doc/autopkgtest/.
AUTHORS AND COPYRIGHT¶
adt-virt-lxc was written by Robie Basak <robie.basak@canonical.com>
and Martin Pitt <martin.pitt@ubuntu.com>.
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.