Create customized image with ubuntu-image

For creating an image with ubuntu-image we need

  • a git repository with the gadget definition

  • a image definition file image-definition.yaml which may be located in the same git repository

Please, execute the Your first Ubuntu image tutorial. This provides a sample project.

Install dependencies

sudo apt-get update
sudo apt-get install git snapd qemu-user-static ubuntu-dev-tools
sudo systemctl restart systemd-binfmt

Install ubuntu-image

ubuntu-image is provided as a snap and can be installed with

sudo snap install --classic ubuntu-image

Create a gadget definition

At a minimum the Gadget definition consists of

  • the definition file gadget.yaml

  • a Makefile where the default target * copies gadget.yaml to directory meta/ * copies all installation files to directory install/

The YAML file format is described in https://yaml.org/spec/.

An overview of the available fields in gadget.yaml is provided in Gadget.yaml fields.

The gadget definition is provided as a Yaml file meta/gadget.yaml. gadget.yaml describes

  • partitions of the image

  • files installed on partitions other than the root partition