maas-autobuilder/README.md

# MAAS Auto-builder

This is a quick-and-dirty set of shell scripts that will build out and
bootstrap a MAAS environment with all of the bits and pieces you need to get
it running for any cloud, any workload.

* `manage-maas-nodes`...: Create kvm instances that MAAS will manage
* `bootstrap--maas.sh`..: Build and bootstrap your MAAS environment

There are plenty of options to customize its behavior, as well as drop in to
any step of the process without rebuilding the full MAAS from scratch.


## Requirements

Requires, minimally, `bash`, `jq` and a working Ubuntu environment.  This
has **not** been tested on CentOS or Debian, but should work minimally on
those environments, if you choose to make that your host.  Patches are
welcome, of course.


## Components

```
  -a <cloud_name>    Do EVERYTHING (maas, juju cloud, juju bootstrap)
  -b                 Build out and bootstrap a new MAAS
  -c <cloud_name>    Add a new cloud + credentials
  -i                 Just install the dependencies and exit
  -j <name>          Bootstrap the Juju controller called <name>
  -n                 Create MAAS kvm nodes (to be imported into chassis)
  -r                 Remove the entire MAAS server + dependencies
  -t <cloud_name>    Tear down the cloud named <cloud_name>
```

## Installing and testing MAAS 

Just run `./bootstrap-maas.sh` with the appropriate option above.
Minimally, you'll want to use `./bootstrap-maas.sh -b` or `-i` to install
just the components needed.

I've done all the work needed to make this as idempotent as possible.  It
will need some minor tweaks to get working with MAAS 2.4.x, becauase of the
newer PostgreSQL dependencies.

MAAS from snap is also not supported (yet) again for the same SQL
dependencies which are included inside the MAAS snap.


## TODO and What's Next

* Support for using MAAS from snap vs.  main or PPA.  With snap, postgresql
  and other deps are installed in the snap, so handling has to change