/ubuntu-image

Official tool to build Ubuntu Images.

Primary LanguageGoGNU General Public License v3.0GPL-3.0

Ubuntu image builder

Build codecov Go Report Card

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.

Requirements

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 details

The "gadget.yaml" specification has moved to the snapcraft forum

Build Instructions

  • Ensure golang >= 1.18 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