No project description provided
Project description
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/
Current targets
- Ubuntu 16.04 (Xenial)
- Ubuntu 18.04 (Bionic)
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.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.