ansibleguy / collection_linuxha

Ansible Modules to manage LinuxHA/CoroSync

Ansible Collection - ansibleguy.linuxha

Functional Test Logs (if failed)

---

Contribute

Feel free to contribute to this project using pull-requests, issues and discussions!

What to contribute:

• add ansible-based tests for some error-case(s) you have encountered
• extend or correct the documentation
• contribute code fixes or optimizations
• implement additional modules
• test unstable modules and report bugs/errors

---

Requirements

LinuxHA

You will have to install the LinuxHA packages on the target server:

• LinuxHA (corosync and pacemaker)
• crm-shell (crmsh)

After that - configure the basic cluster using the 'corosync.conf' file.

Example config: documentation

XML Parsing

The xmltodict python module is used to parse config!

It is only needed on the Ansible controller!

python3 -m pip install xmltodict

Collection

Then - install the collection itself:

# latest version:
ansible-galaxy collection install git+https://github.com/ansibleguy/collection_linuxha.git

# stable/tested version:
ansible-galaxy collection install ansibleguy.linuxha

# install to specific directory for easier development
cd $PLAYBOOK_DIR
ansible-galaxy collection install git+https://github.com/ansibleguy/collection_linuxha.git -p ./collections

---

Usage

See: Docs

You want a simple Ansible GUI? Check-out my Ansible WebUI

---

Modules

Development States:

not implemented => development => testing => unstable (practical testing) => stable

Implemented

Function	Module	Usage	State
Execute raw commands	ansibleguy.linuxha.raw	Docs	unstable
Parsed status	ansibleguy.linuxha.status	Docs	unstable
Parsed config	ansibleguy.linuxha.config	Docs	unstable

Roadmap

• Status
  • Current config
  • Cluster status
  • Cluster health
• Actions
  • Resource Actions
  • Node Actions
• Configuration
  • Property
  • Primitives
  • Monitor
  • Clone
  • Groups
  • Order
  • Location
  • Co-Location
  • Master-Slave