quiso's Introduction

quiso, the quick ISO builder for cloud-init

Simple cross-platform CLI with cloud-init with presets designed to make building images painless and simple, designed to work everywhere for quick iteration on cloud-init development. There are also unsupported clouds where the NoCloud method of injecting user-data is the best method of using cloud-init.

This CLI was inspired by work done for rancher-machine to accommodate vSphere without relying on the guestinfo implementation which requires VMWare Tools. Other examples of this same solution can be found in Canonical's multipass and countless bash implementations which rely on genisoimage, mkisofs or hdiutil. This tool takes these ideas and coalesces them into a single tool with easy defaults allowing any devops engineer in any environment (mac, win, linux) to call quiso and immediately get an ISO.

Releases

Find everything you need to start in your architecture on the releases page.

Usage

quiso was designed with simple defaults, run in any directory containing a user-data and meta-data file and it will automatically create user-data.iso.

$ tree
   .
   ├── meta-data
   └── user-data
$ quiso
$ tree
   .
   ├── meta-data
   └── user-data
   └── user-data.iso

Calling quiso with no parameters is equivalent of

quiso build --user-data ./user-data --meta-data ./meta-data --output ./user-data.iso

Examples

Check out the ./examples directory for how to use vagrant and virtualbox to test ISOs locally and how to use quiso with terraform's template_cloudinit_config.