undercloud-debug

this page last updated: 2019-07-23 10:14:29

undercloud-debug¶

Role Documentation¶

Welcome to the “undercloud-debug” role documentation.

Role Defaults¶

This section highlights all of the defaults and variables set within the “undercloud-debug” role.

debug_check: true
services_conf_files:
- /var/lib/config-data/puppet-generated/nova/etc/nova/nova.conf
- /var/lib/config-data/puppet-generated/neutron/etc/neutron/neutron.conf
- /var/lib/config-data/puppet-generated/ceilometer/etc/ceilometer/ceilometer.conf
- /var/lib/config-data/puppet-generated/heat/etc/heat/heat.conf
- /var/lib/config-data/puppet-generated/ironic/etc/ironic/ironic.conf

Role Variables: main.yaml¶

metadata:
  description: 'The undercloud''s openstack services should _not_ have debug enabled.
    This will check if debug is enabled on undercloud services. If debug is enabled,
    the root filesystem can fill up quickly, and is not a good thing.

    '
  groups:
  - pre-deployment
  name: Undercloud Services Debug Check

Molecule Scenarios¶

Molecule is being used to test the “undercloud-debug” 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: docker
lint:
  enabled: false
log: true
platforms:
- easy_install:
  - pip
  environment:
    http_proxy: '{{ lookup(''env'', ''http_proxy'') }}'
    https_proxy: '{{ lookup(''env'', ''https_proxy'') }}'
  hostname: centos7
  image: centos:7
  name: centos7
  pkg_extras: python-setuptools python-enum34
- environment:
    http_proxy: '{{ lookup(''env'', ''http_proxy'') }}'
    https_proxy: '{{ lookup(''env'', ''https_proxy'') }}'
  hostname: fedora28
  image: fedora:28
  name: fedora28
  pkg_extras: python*-setuptools python*-enum
provisioner:
  env:
    ANSIBLE_LIBRARY: ../../../../library
    ANSIBLE_STDOUT_CALLBACK: yaml
  log: true
  name: ansible
scenario:
  test_sequence:
  - destroy
  - create
  - prepare
  - converge
  - verify
  - destroy
verifier:
  lint:
    name: flake8
  name: testinfra

Example default playbook¶

- gather_facts: false
  hosts: all
  name: Converge
  tasks:
  - copy:
      content: '[DEFAULT]

        debug: True

        '
      dest: /tmp/debug_true_1.conf
    name: prepare fake config file
  - include_role:
      name: undercloud-debug
    name: Checking good value
    vars:
      debug_check: false
  - block:
    - include_role:
        name: undercloud-debug
    name: Should fail due to bad value
    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 undercloud-debug should have detected a configuration issue

        '
    name: Fail the test
  vars:
    services_conf_files:
    - /tmp/debug_true_1.conf