This tool is used to build Ubuntu images. Currently builds Ubuntu Core snap-based images from model assertions and Ubuntu classic preinstalled images using image definition files, but it will be generalized to build more (eventually all) Ubuntu images.
Ubuntu 18.04 (Bionic Beaver) is the minimum platform requirement, but Ubuntu 20.04 (Focal Fossa) or newer is recommended. 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 run::
$ sudo apt build-dep ./
from the directory containing the debian
subdirectory. Alternatively of
course, you can just install the packages named in the Build-Depends
field.
- Project home: https://github.com/Canonical/ubuntu-image
- Report bugs at: https://bugs.launchpad.net/ubuntu-image
- Git clone: https://github.com/Canonical/ubuntu-image.git
- Manual page: man ubuntu-image (https://github.com/Canonical/ubuntu-image/blob/main/ubuntu-image.rst)
The "gadget.yaml" specification has moved to the snapcraft forum
- Ensure golang >= 1.21 is installed
- Clone the git repository using
git clone https://github.com/canonical/ubuntu-image.git
cd
into the newly cloned repository- Run
go build -o . ./...
- The newly compiled executable
ubuntu-image
will be created in the current directory