ctlplane_ip_range

Role Documentation

Welcome to the “ctlplane_ip_range” role documentation.

Role Defaults

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

ctlplane_iprange_min_size: 20

Role Variables: main.yml

metadata:
  description: 'Verify that the number of IP addresses defined in `dhcp_start` and
    `dhcp_end` fields in `undercloud.conf` is not too low.

    '
  groups:
  - pre-introspection
  name: Check the number of IP addresses available for the overcloud nodes

Molecule Scenarios

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

Scenario: default

Example default configuration
driver:
  name: podman
log: true
platforms:
- dockerfile: ../../../../.config/molecule/Dockerfile
  environment:
    http_proxy: '{{ lookup(''env'', ''http_proxy'') }}'
    https_proxy: '{{ lookup(''env'', ''https_proxy'') }}'
  hostname: centos
  image: centos/centos:stream8
  name: centos
  pkg_extras: python*-setuptools python*-pyyaml
  privileged: true
  registry:
    url: quay.io
  ulimits:
  - host
  volumes:
  - /etc/ci/mirror_info.sh:/etc/ci/mirror_info.sh:ro
provisioner:
  env:
    ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-/usr/share/ansible/plugins/modules}
    ANSIBLE_ROLES_PATH: ${ANSIBLE_ROLES_PATH}:${HOME}/zuul-jobs/roles
    ANSIBLE_STDOUT_CALLBACK: yaml
  inventory:
    hosts:
      all:
        hosts:
          centos:
            ansible_python_interpreter: /usr/bin/python3
  log: true
  name: ansible
  options:
    vvv: true
scenario:
  test_sequence:
  - destroy
  - create
  - prepare
  - converge
  - verify
  - destroy
verifier:
  name: ansible
Molecule Inventory
hosts:
  all:
    hosts:
      centos:
        ansible_python_interpreter: /usr/bin/python3
Example default playbook
- gather_facts: false
  hosts: all
  name: Converge
  tasks:
  - name: Ensure we get needed facts
    setup:
      gather_subset:
      - '!all'
      - '!any'
      - '!min'
      - env
  - block:
    - copy:
        content: '[ctlplane-subnet]

          dhcp_start = 192.168.12.10

          dhcp_end = 192.168.12.100

          '
        dest: '{{ ansible_env.HOME }}/undercloud.conf'
      name: populate undercloud.conf with right range length
    - include_role:
        name: ctlplane_ip_range
    name: Test good values
  - block:
    - copy:
        content: '[ctlplane-subnet]

          dhcp_start = 192.168.12.10

          dhcp_end = 192.168.12.20

          '
        dest: '{{ ansible_env.HOME }}/undercloud.conf'
      name: populate undercloud.conf with wrong range length
    - include_role:
        name: ctlplane_ip_range
    name: Test failing
    rescue:
    - meta: clear_host_errors
      name: Clear host errors
    - debug:
        msg: The validation works! End the playbook run
    - meta: end_play
      name: End play
  - fail:
      msg: 'The ctlplane-ip-range validation didn''t properly detect too short

        range!

        '
    name: Fail the test