minccino - Lightweight cloud-init server

Server application that provides cloud-init metadata via the nocloud-net provider. Uses the link-local IPv6 address for "authentication" by pulling MAC address information.

Requirements

Only sqlite3 dev libraries are required for Diesel.

Configuration

Configuration is handled either via minccino.toml or MINCCINO_ environment variables. To use the API (required for managing instances), you'll need to generate an API key and relevant hash in the config file. To generate this, run:

minccino genkey

This outputs the API key and the relevant config snippet you'll need to add to minccino.toml for the key.

API Usage

All API endpoints require an X-API-Key header with the key generated above, and for the API client to be connected via localhost. \todo Allow overriding the latter requirement, if needed

To create an instance (all requests sent to http://[::1]):

> POST /_yui/instances HTTP/1.1
> X-API-Key: Your_API_Key
> Content-type: application/json
> [...]
> 
> {
>     "name": "instance_hostname",
>     "os_name": "netbsd|debian|invalid",
>     "mac_address": "0a:42:01:23:45:67"
> }
> 
< HTTP/1.1 201 Created
< Content-type: application/json
< [...]
< 
< {
<     "error": null,
<     "instances": [
<         {
<             "id": 591750913,
<             "name": "instance_hostname",
<             "os_name": "netbsd|debian|invalid",
<             "mac_address": "0a:42:01:23:45:67"
<         }
<     ]
< }
}