frr_status

Role Documentation

Welcome to the “frr_status” role documentation.

Role Variables: main.yml

metadata:
  description: 'Runs ''show watchfrr'' and checks for any non-operational daemon.

    '
  groups:
  - post-deployment
  name: FRR status check

Molecule Scenarios

Molecule is being used to test the “frr_status” 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: Dockerfile
  environment:
    http_proxy: '{{ lookup(''env'', ''http_proxy'') }}'
    https_proxy: '{{ lookup(''env'', ''https_proxy'') }}'
  hostname: ubi8
  image: ubi8/ubi-init
  name: ubi8
  pkg_extras: python*-setuptools
  privileged: true
  registry:
    url: registry.access.redhat.com
  ulimits:
  - host
  volumes:
  - /etc/ci/mirror_info.sh:/etc/ci/mirror_info.sh:ro
  - /etc/pki/rpm-gpg:/etc/pki/rpm-gpg
  - /opt/yum.repos.d:/etc/yum.repos.d:rw
provisioner:
  env:
    ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-/usr/share/ansible/plugins/modules}
    ANSIBLE_STDOUT_CALLBACK: yaml
  inventory:
    hosts:
      all:
        hosts:
          ubi8:
            ansible_python_interpreter: /usr/bin/python3
  log: true
  name: ansible
scenario:
  test_sequence:
  - destroy
  - create
  - prepare
  - converge
  - verify
  - destroy
verifier:
  name: testinfra
Molecule Inventory
hosts:
  all:
    hosts:
      ubi8:
        ansible_python_interpreter: /usr/bin/python3
Example default playbook
- gather_facts: false
  hosts: all
  name: Converge
  tasks:
  - include_role:
      name: frr_status
    name: run validation
    vars:
      enabled_services:
      - frr

Scenario: faulty

Example faulty configuration
driver:
  name: podman
log: true
platforms:
- dockerfile: Dockerfile
  environment:
    http_proxy: '{{ lookup(''env'', ''http_proxy'') }}'
    https_proxy: '{{ lookup(''env'', ''https_proxy'') }}'
  hostname: ubi8
  image: ubi8/ubi-init
  name: ubi8
  pkg_extras: python*-setuptools
  privileged: true
  registry:
    url: registry.access.redhat.com
  ulimits:
  - host
  volumes:
  - /etc/ci/mirror_info.sh:/etc/ci/mirror_info.sh:ro
  - /etc/pki/rpm-gpg:/etc/pki/rpm-gpg
  - /opt/yum.repos.d:/etc/yum.repos.d:rw
provisioner:
  env:
    ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-/usr/share/ansible/plugins/modules}
    ANSIBLE_STDOUT_CALLBACK: yaml
  inventory:
    hosts:
      all:
        hosts:
          ubi8:
            ansible_python_interpreter: /usr/bin/python3
  log: true
  name: ansible
scenario:
  test_sequence:
  - destroy
  - create
  - prepare
  - converge
  - verify
  - destroy
verifier:
  name: testinfra
Molecule Inventory
hosts:
  all:
    hosts:
      ubi8:
        ansible_python_interpreter: /usr/bin/python3
Example faulty playbook
- gather_facts: false
  hosts: all
  name: Converge
  tasks:
  - block:
    - include_role:
        name: frr_status
      name: run validation
      vars:
        enabled_services:
        - frr
    name: make validation fail
    rescue:
    - meta: clear_host_errors
      name: Clear host errors
    - assert:
        that:
        - has_errors is defined
      name: check at least one FRR daemon is down
    - meta: end_play
      name: End play
  - fail:
      msg: 'The frr_status validation didn''t properly detect non-operational FRR

        daemons!

        '
    name: Fail playbook if reached