Scenarios

A scenario is like a real-world use cases of the playbook under test. Scenarios are generally derived from user stories.

Syntax

The monkeyble configuration is given to the playbook to be tested as an extra var. The best approach consist into creating a dedicated var file like monkeyble.yml that contains the set of variable used by the playbook to test as well as the Monkeyble configuration placed in the monkeyble_scenarios variable.

E.g:

# monkeyble.yml
# playbook variables
my_var: "value"
my_other_var: "other value"

# monkeyble config
monkeyble_scenarios:
  scenario1:
    name: "Validate that we can create a VM"
    # config
  scenario2:
    name: "Validate that the playbook stop when wrong DNS name is given"
    # config
  scenario3:
    name: "Validate that the selected network is prod when 'prod' flag is true"
    # config

Scenario

Scenario configuration:

• name: The scenario description
• Test input: Test instantiated arguments of a task module
• Test output: Test the result dictionary of an executed task
• Test state: Check the state of the task (changed, skipped, failed)
• Mock: Mock the executed module of a task
• Task filter: Filter tested tasks by role or playbook name
• Task extra vars: Override the default extra variable set a playbook level

Execute a playbook to test against a scenario:

ANSIBLE_CONFIG="ansible.cfg" ansible-playbook playbook.yml \
-e "@<path_to_extra_var>" \
-e "monkeyble_scenario=<scenario_name>"

E.G:

ANSIBLE_CONFIG="ansible.cfg" ansible-playbook playbook.yml \
-e "@monkeyble.yml" \
-e "monkeyble_scenario=validate_test_1"

Re-using test code

As the configuration is passed as an extra var, usage of jinja template is available to reuse some part of your configuration

E.g:

test_input_config:
  - assert_equal:
      arg_name: msg
      expected: "general kenobi"

monkeyble_scenarios:
  scenario_1:
    name: "Check the general name"
    tasks_to_test:
      - task: "a task"
        test_input: "{{ test_input_config }}"
  scenario_2:
    name: "Check the general name"
    tasks_to_test:
      - task: "another task"
        test_input: "{{ test_input_config }}"

Configuration can be placed in multiple files to be resued by multiple Monkeyble config

# shared_tests.yml
a_shared_test:
  - assert_equal:
      arg_name: msg
      expected: "Hello Monkeyble"

# monkeyble.yml
monkeyble_scenarios:
  validate_test_1:
    name: "Check the general name"
    tasks_to_test:
      - task: "debug task"
        test_input: "{{ a_shared_test }}"

Then call the playbook by passing all extra vars:

ANSIBLE_CONFIG="ansible.cfg" ansible-playbook playbook.yml \
-e "@shared_tests.yml" \
-e "@monkeyble.yml" \
-e "monkeyble_scenario=validate_test_1"

Ansible native test components

The following Ansible components may be placed into playbooks and roles to prevent from failure:

• check_mode
• assert
• fail