Ubuntu image building scripts. Report bugs at Launchpad.
Clone or download
Łukasz 'sil2100' Zemczak
Łukasz 'sil2100' Zemczak Bump snap version.
Latest commit 514f0bc Aug 10, 2018


Ubuntu image builder

This tool is used to build Ubuntu images. Currently it only builds Snappy images from a model assertion, but it will be generalized to build more (eventually all) Ubuntu images.


Ubuntu 16.04 (Xenial Xerus) is the minimum platform requirement, but Ubuntu 17.04 (Zesty Zapus) or newer is recommended. Python 3.5 is the minimum Python version required. All required third party packages are available in the Ubuntu archive.

If you want to run the test suite locally, you should install all the build dependencies named in the debian/control file. The easiest way to do that is to apt install devscripts equivs and then run:

$ sudo mk-build-deps --remove --install --tool '/usr/bin/apt-get -y'

from the directory containing the debian subdirectory. Alternatively of course, you can just install the packages named in the Build-Depends field.


ubuntu-image is licensed under the terms of the GPLv3 and Copyright by Canonical Ltd.

ubuntu_image/testing/flake8.py and ubuntu_image/testing/nose.py are copyright Barry Warsaw and licensed under the terms of the Apache License, 2.0.

Project details

The gadget.yaml specification has moved to the snapcore repository.


You'll need the tox tool to run the test suite (see above for testing requirements). You can run the full test suite, including coverage and code quality tests via:

$ tox

You can run individual tests like this:

$ tox -e py35 -- -P <pattern>

where <pattern> is a Python regular expression matching a test name, e.g.:

$ tox -e py35 -- -P test_smoke

Pull requests run the same test suite that archive promotion (i.e. -proposed to release pocket) runs. You can reproduce this locally by building the source package (with gbp buildpackage -S) and running:

$ autopkgtest ubuntu-image_0.8+16.10ubuntu1.dsc -- schroot zesty-amd64

with changes to the version number and Ubuntu distroseries as appropriate.