Go to file
Kienan Stewart f1fc7573cb Change conditions on setting debconf preseeds for aegir
Apparently in Puppet, empty strings resolve to true. Liens were
being added to the preseed that caused installations to fail
(eg. empty aegir_root).
2017-03-26 00:31:29 -04:00
manifests Change conditions on setting debconf preseeds for aegir 2017-03-26 00:31:29 -04:00
LICENSE.txt added license 2016-11-30 16:35:41 -05:00
README.md Update README.md with example and limitations 2017-03-24 20:10:59 -04:00
metadata.json Fix syntax error in metadata.json 2017-03-25 21:48:39 -04:00

README.md

aegir

Module Description

This module is intended to install aegir simply.

License

Copyright (C) 2017 Kienan Stewart

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Requirements

Modules from forge.puppet.com:

  • puppetlabs-stdlib (tested with 4.15.0)
  • puppetlabs-apt (tested with 2.3.0)

Operating systems: Debian derivatives.

Puppet: 4.x

Setup

Nothing special.

Limitations

  • Currently only supports apache
  • Depends on the the aegir${version} package to correctly install dependencies

Example Usage

Install a hostmaster

# Assumes mysql or mariadb is installed
# and that there is a user aegir_root
# with all grants etc permissions on *.*
class { '::aegir::hostmaster': {
  database => {
    host     => 'localhost',
    user     => 'aegir_root',
    password => 'examplepassword'
  }
}

Reference

Classes

Public Classes

  • aegir::hostmaster

Class: aegir::hostmaster

Debian package based hostmaster installation.

Parameters:

  • database: A hash containing user, host, and password. Required.
  • frontend_url: The url for the hostmaster drupal installation. Optional, defaults to the fully qualified domain name.
  • version: The major aegir version to install. Optional, default: 3
  • user: The user name to use for the installation of aegir. Optional, default: aegir
  • home: The home directory of the user. Optional, default: /var/aegir
  • server: Which webserver to use. Optional, default: apache. Supports: apache2, nginx
  • release: Which release to use from the package source. Optional, default: stable.
  • makefile: If a custom makefile should be used, specify it here. Optional, default: ''
  • email: The email to set for the admin user in the hostmaster installation. Optional, default: '' (aegir will pick the user@fqdn).
  • working_copy: Keep the hostmaster platform git directories? Optional, default: false.
  • drush_version: Which version of drush to install with provision. Optional, default '' (stable).