puppet-maas

A puppet module for deploying and managing MaaS

(This is unaffiliated with MaaS.io or Canonical )

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with maas
   • What maas affects
   • Setup requirements
   • Beginning with maas
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

Overview

Metal as a Service – MAAS – lets you treat physical servers like virtual machines in the cloud. Rather than having to manage each server individually, MAAS turns your bare metal into an elastic cloud-like resource. More information can be found at https://maas.ubuntu.com/docs/

Module Description

This Puppet module deploys the MAAS packages and provides puppetized Administration of the MAAS Server/Cluster

Setup

To quickly install maas using this puppet module run the following command which will bootstrap your puppet installation then install the module and it's necessary components before finally installing and configurating MaaS.

wget https://raw.githubusercontent.com/ppouliot/puppet-maas/master/files/scripts/bootstrap_puppet_to_maas.sh -O - | sh

Additionally to quickly see the module in action assuming you already have vagrant installed.

git clone https://github.com/ppouliot/puppet-maas
cd puppet-maas && vagrant up

What maas affects

• Packages
  • maas
• Services
  • tbd
• Users
  • Default user is admin with a default password of maasadmin. Additionally examples of created additional superusers can be found here
• Files
  • tbd

Setup Requirements

• Ubuntu 12.04
• Ubuntu 14.04
• Ubuntu 16.04

Beginning with maas

Either simply include maas and use hiera for changing params, use PE Console to include maas and put in params there or instanciate class maas and change params within this class (e.g. when using profiles).

Make sure you to install depencency modules (e.g. apt and stdlib) as well (r10k and librarian-puppet should recognize them).

Usage

class{'maas':}

Classes

• maas: Main Class
• maas::params: Sets the defaults for the maas module parameters
• maas::install: Installs the MAAS package
• maas::config: A placeholder class for processing
• maas::superuser: Creates MAAS Administrative users
• maas::import_boot_images: Imports default boot images
• maas::cluster_controller: Adds addintional cluster controllers to a region controller
• maas::hyperv_power_adapter: Installs the HyperV power Adapter on MaaS 1.9

Resources

• https://github.com/CanonicalLtd/maas-docs/blob/master/en/installconfig-checklist.md

Limitations

• Ubuntu platforms only, specifcally 14.04, 16.04 and 18.04.

Development

Feel free to open pull requests or issues at https://github.com/ppouliot/puppet-maas

Contributors

• Peter Pouliot peter@pouliot.net

Copyright and License

Copyright 2015 Peter J. Pouliot

Peter Pouliot can be contacted at: peter@pouliot.net

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.