Ansible Role Moodle

This role installs and sets up Moodle on your system.

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

This example comes from molecule/default/converge.yml and is confirmed to work with each change, pull request, and release.

---
- name: converge
  hosts: all
  become: true
  gather_facts: true

  pre_tasks:
    - name: Update apt cache.
      apt: update_cache=yes cache_valid_time=600
      when: ansible_os_family == 'Debian'
      changed_when: false

    - name: Check if python3.11 EXTERNALLY-MANAGED file exists
      ansible.builtin.stat:
        path: /usr/lib/python3.11/EXTERNALLY-MANAGED
      register: externally_managed_file_py311

    - name: Rename python3.11 EXTERNALLY-MANAGED file if it exists
      ansible.builtin.command:
        cmd: mv /usr/lib/python3.11/EXTERNALLY-MANAGED /usr/lib/python3.11/EXTERNALLY-MANAGED.old
      when: externally_managed_file_py311.stat.exists
      args:
        creates: /usr/lib/python3.11/EXTERNALLY-MANAGED.old

    - name: Check if python3.12 EXTERNALLY-MANAGED file exists
      ansible.builtin.stat:
        path: /usr/lib/python3.12/EXTERNALLY-MANAGED
      register: externally_managed_file_py312

    - name: Rename python3.12 EXTERNALLY-MANAGED file if it exists
      ansible.builtin.command:
        cmd: mv /usr/lib/python3.12/EXTERNALLY-MANAGED /usr/lib/python3.12/EXTERNALLY-MANAGED.old
      when: externally_managed_file_py312.stat.exists
      args:
        creates: /usr/lib/python3.12/EXTERNALLY-MANAGED.old

  roles:
    - role: buluma.moodle

The machine must be prepared first. In Continuous Integration (CI), this is done using molecule/default/prepare.yml:

---
- name: prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: buluma.bootstrap
    - role: buluma.buildtools
    - role: buluma.epel
    - role: buluma.mysql
      mysql_databases:
        - name: moodle
          encoding: utf8mb4
          collation: utf8mb4_unicode_ci
      mysql_users:
        - name: moodle
          password: moodle
          priv: "moodle.*:ALL"
    - role: buluma.python_pip
    - role: buluma.openssl
      openssl_items:
        - name: apache-httpd
          common_name: "{{ ansible_fqdn }}"
    - role: buluma.php
    - role: buluma.selinux
    - role: buluma.httpd
      httpd_vhosts:
        - name: moodle
          servername: moodle.example.com
    - role: buluma.cron
    - role: buluma.core_dependencies

For more information on how to use these roles, see the full explanation and example.

Role Variables

Default variable values are set in defaults/main.yml:

---
# defaults file for moodle

# Moodle version to install.
moodle_version: 401

# Path for saving data.
moodle_data_directory: /opt/moodledata

# Permissions for created directories.
moodle_directory_mode: "0750"

# Database connection details.
moodle_database_type: mysqli
moodle_database_hostname: localhost
moodle_database_name: moodle
moodle_database_username: moodle
moodle_database_password: moodle
moodle_database_prefix: ""

# URL to serve content.
moodle_wwwroot: "https://{{ ansible_default_ipv4.address }}/moodle"

Requirements

• Pip packages listed in requirements.txt.

State of Used Roles

Several roles are used to prepare the system. You may use other methods for preparation.

Requirement	GitHub	Version
buluma.bootstrap
buluma.buildtools
buluma.cron
buluma.core_dependencies
buluma.epel
buluma.httpd
buluma.mysql
buluma.openssl
buluma.php
buluma.python_pip
buluma.selinux

Context

This role is part of many compatible roles. For more details, check out the documentation of these roles.

Here is a visual overview of related roles:

Compatibility

This role has been tested on these container images:

The minimum required version of Ansible is 2.12. Tests have been conducted for:

• The previous version.
• The current version.
• The development version.

If you encounter any issues, please report them on GitHub.

Changelog

For historical changes, refer to the Role History.

License

This project is licensed under the Apache-2.0.

Author Information

Authored by Shadow Walker.