community.general.gluster_heal_info (2.5.9) — module

Install collection

Install with ansible-galaxy collection install community.general:==2.5.9

Add to requirements.yml

  collections:
    - name: community.general
      version: 2.5.9

Description

Gather facts about either self-heal or rebalance status.

This module was called C(gluster_heal_facts) before Ansible 2.9, returning C(ansible_facts). Note that the M(community.general.gluster_heal_info) module no longer returns C(ansible_facts)!

Requirements

• GlusterFS > 3.2

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Gather self-heal facts about all gluster hosts in the cluster
  community.general.gluster_heal_info:
    name: test_volume
    status_filter: self-heal
  register: self_heal_status

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- ansible.builtin.debug:
    var: self_heal_status

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Gather rebalance facts about all gluster hosts in the cluster
  community.general.gluster_heal_info:
    name: test_volume
    status_filter: rebalance
  register: rebalance_status

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- ansible.builtin.debug:
    var: rebalance_status

Inputs

    
name:
    aliases:
    - volume
    description:
    - The volume name.
    required: true

status_filter:
    choices:
    - self-heal
    - rebalance
    default: self-heal
    description:
    - Determines which facts are to be returned.
    - If the C(status_filter) is C(self-heal), status of self-heal, along with the number
      of files still in process are returned.
    - If the C(status_filter) is C(rebalance), rebalance status is returned.

Outputs

heal_info:
  description: List of files that still need healing process
  returned: On success
  type: list
name:
  description: GlusterFS volume name
  returned: always
  type: str
rebalance_status:
  description: Status of rebalance operation
  returned: On success
  type: list
status_filter:
  description: Whether self-heal or rebalance status is to be returned
  returned: always
  type: str