~lucidone/ryo-iso

Roll your own ISO
CI fix: updating for new iso.yml
CI+doc: update for 20.04
Support for Ubuntu 20.04

clone

read-only
https://git.sr.ht/~lucidone/ryo-iso
read/write
git@git.sr.ht:~lucidone/ryo-iso

You can also use your local clone with git send-email.

#ryo-iso


Table of Contents

#Overview

ryo-iso is distributed on PyPI and is available for Python 3.5+ on Linux.

$ pip3 install git+https://git.sr.ht/~lucidone/ryo-iso

#Documentation

Documentation is available at https://ryo-iso.readthedocs.io/

#Currently supported targets

  • Ubuntu 16.04 (Xenial)
  • Ubuntu 18.04 (Bionic)
  • Ubuntu 20.04 (Focal)

#Usage

#TL;DR

$ sudo apt install curl gpgv2 squashfs-tools xorriso apt-utils apt-cacher-ng qemu-system-x86 isolinux
$ pip3 install git+https://git.sr.ht/~lucidone/ryo-iso
$ mkdir ~/iso_test
$ cd ~/iso_test
$ ryo-iso init
$ ryo-iso build
$ ryo-iso start

#Other commands

#Create a new project

$ ryo-iso init

This command will initialize a project with a default iso.yml configuration file in the current directory.

If this is the first time being run it will create the ryo-iso application config file in ~/.config/ryo-iso/config.yml and provides a set of reasonable defaults in ~/.config/ryo-iso/iso_base.yml that can be overridden on a per-project basis.

#Build an ISO

$ ryo-iso build

Builds an iso in build/image.iso

#VM Install

$ ryo-iso install

Generated images can be tested by installing them into a QEMU VM

#VM Start

$ ryo-iso start

This command can provide a means of booting the image as a LiveCD or restarting a previously installed disk image.

#Cleanup

$ ryo-iso clean

This command will remove all build artifacts to prepare the project to be checked into version control.

NOTE: Using this command is preferable to running rm -rf as builds that are aborted with Ctrl-C may leave chrooted filesystems mounted.

#Additional

$ ryo-iso list -p

This will list all intermediate processes that may be useful for debugging.

#Requirements

$ sudo apt install curl gpgv2 squashfs-tools xorriso apt-utils apt-cacher-ng qemu-system-x86 isolinux

#License

ryo-iso is distributed under the terms of both

at your option.