ergonlogic.aegir

Ansible Role: Aegir

This role installs the Aegir hosting system, which is a control panel for launching and managing many Drupal sites.

Requirements

The role works best on Ubuntu Focal (20.04). It should also work on Debian or any OS that supports apt, but results may vary.

You need a MySQL server, which can be on the same machine or a separate one (that's why it's not directly listed as a requirement). Check the example here for installing MySQL using the consensus.mysql role. For configuring MySQL connections, refer to the aegir_mysql_* variables.

Make sure Ansible pipelining is turned on. This is important because the tasks in this role run as the aegir user, who doesn’t have the right permissions for Ansible's temporary files. When pipelining is enabled, those files aren’t used.

For more details on installing Aegir, check the official Aegir documentation.

Role Variables

The default Debian package installation should meet most needs. However, you can customize many parts of the Aegir installation through role variables. For more information, see defaults/main.yml and vars/main.yml.

Example Playbook

---
- name: "Default Aegir install via Debian package."
  hosts: all

  roles:
    - consensus.mysql
    - consensus.aegir

  tasks: 

    # optional
    - name: Generate and print a one-time login link after Aegir installation.
      include_role:
        name: consensus.aegir
        tasks_from: login_link.yml

After running this playbook, the Aegir front-end will be live, along with the Drush extensions (like Provision) that handle most tasks.

You can look at the test playbooks for additional configuration examples:

deb-nginx.yml: Aegir installation with Nginx using the Debian package.
git-deploy.yml: A full Aegir installation from git source.
custom-deploy.yml: A complete Aegir installation from source, with custom git repositories and versions (for Drush, Provision, etc.).