maas-autobuilder/README.md

# MAAS Auto-builder

This is a quick-and-dirty shell script 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.

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 './bootstra-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