Ansible Role: microceph

Role installs a ceph cluster using microceph

Requirements

• Ansible >= 2.7
• Linux Distribution
  • Debian Family
    • Ubuntu
      • Xenial (16.04)
      • Bionic (18.04)
      • Focal (20.04) (untested)
      • Jammy (22.04) (untested)
  • Arch Linux (untested)

License

MIT

Usage

Role Variables

Some variables available in this role are listed here. The full set is defined in [defaults/main.yml](defaults/main.yml).

• microceph_version: Version to utilize, defaults value is latest/edge.
• microceph_cluster_nodes: Hostgroup whose members will form ceph cluster
• microceph_seed_node: Node name that will be used to start cluster formation
• microceph_encrypt_data: Encrypt all the data in the microceph drive at rest see : Full disk encryption
• microceph_disk_devices: List of all the devices the role should add as osds once the nodes join. Make sure they exist prior otherwise the playbook will skip.

Playbook example

- hosts: servers
  roles:
    - role: pitabwire.microceph
      vars:
        microceph_cluster_nodes: ceph_nodes
        microceph_seed_node: ceph-node-1
        microceph_encrypt_data: False

Increasing data nodes

Additional nodes to the cluster can be added at any time. All nodes in the microceph_cluster_nodes hostgroup will run microceph cluster join <join token>, more info on this can be found here: microceph join non primary node.

Testing

Using Molecule wrapper and system Python

• ./moleculew lint
• ./moleculew create
• ./moleculew list
• ./moleculew check
• ./moleculew test

Using Python virtual environment

• Set up virtual environment

  $ python3 -m venv venv
  

• Activate the environment

  $ . venv/bin/activate
  

• Install Molecule with lint and Docker options

  $ pip install molecule molecule-plugins[vagrant]
  

• Install up-to-date Ansible package if necessary

  $ pip install ansible
  

• Run the test commands:
  • molecule lint
  • molecule create
  • molecule list
  • molecule check
  • molecule test