Undercloud-disk-space

An Ansible role to verify if the Undercloud fits the disk space requirements.

Requirements

This role could be used before or/and after the Undercloud installation.

Role Variables

  • Volumes: a dictionary of mount points and their minimum sizes

Dependencies

No Dependencies

Example Playbook

- hosts: servers
  roles:
     - { role: undercloud-disk-space}

License

Apache

Author Information

Red Hat TripleO Validation Team

Full Description

Role Documentation

Welcome to the “undercloud_disk_space” role documentation.

Role Defaults

This section highlights all of the defaults and variables set within the “undercloud_disk_space” role.

volumes:
- {mount: /var/lib/docker, min_size: 10}
- {mount: /var/lib/config-data, min_size: 3}
- {mount: /var/log, min_size: 3}
- {mount: /usr, min_size: 5}
- {mount: /var, min_size: 20}
- {mount: /, min_size: 25}
Role Variables: main.yaml
metadata:
  name: Verify undercloud fits the disk space requirements
  description: >
    Make sure that the root partition on the undercloud node has enough
    free space.

    http://tripleo.org/install/environments/baremetal.html#minimum-system-requirements
  groups:
  - prep
  - pre-introspection
Molecule Scenarios

Molecule is being used to test the “undercloud_disk_space” role. The following section highlights the drivers in service and provides an example playbook showing how the role is leveraged.

Scenario: default
Driver: podman:
Molecule Platform(s)
- name: centos
  hostname: centos
  image: centos/centos:stream8
  registry:
    url: quay.io
  dockerfile: ../../../../.config/molecule/Dockerfile
  pkg_extras: python*-setuptools python*-pyyaml
  volumes:
  - /etc/ci/mirror_info.sh:/etc/ci/mirror_info.sh:ro
  privileged: true
  environment:
    http_proxy: "{{ lookup('env', 'http_proxy') }}"
    https_proxy: "{{ lookup('env', 'https_proxy') }}"
  ulimits:
  - host
Molecule Inventory
hosts:
  all:
    hosts:
      centos:
        ansible_python_interpreter: /usr/bin/python3
Example default playbook
- name: Converge
  hosts: all
  gather_facts: false

  vars:
    volumes:
    - {mount: /var, min_size: 20}
    - {mount: /, min_size: 150}

  tasks:
  - block:
    - include_role:
        name: undercloud_disk_space
    rescue:
    - name: Clear host errors
      meta: clear_host_errors

    - debug:
        msg: The validation works! End the playbook run

    - name: End play
      meta: end_play

  - name: Fail the test
    fail:
      msg: |
        The validation did not detect a too small disk space