one-deploy-validation

This repository provides a toolset for automating the validation of an OpenNebula deployment.

Requirements

We recommend using Ubuntu 22.04 or 24.04 as the host OS, where the validation is initiated. The following packages must be installed on the host:

• git
• python3
• python3-pip
• python3-venv
• make

Environment Setup

1. Clone the repository and move into its directory.
2. Create and activate a Python virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate

3. Install required tools inside the virtual environment:

   python -m pip install hatch uv

4. Install Ansible collections:

hatch env run -e validation-default -- ansible-galaxy collection install  -r requirements.yml -p ./collections

You may also use alternative virtual environment managers (such as pipx). The key principle is: do not modify or replace system-level Python and/or Ansible packages. Keep everything isolated inside your project environment.

Playbooks/Roles

The development of the tests should be structured in playbooks and roles directories, following Ansible. The available test cases are briefly documented together with their key configuration parameters in all.yml.

Inventory/Execution

1. Inventories are kept in the inventory directory, please take a look at example.yml

2. Customize the configuration of the validation testcases by setting the enabler flags (validation.run_* booleans) in all.yml. This file contains the recommended configuration that should be tested on most deployments. Always intend to enable all testcases that are relevant for the deployment (for example, if VM HA or FE HA are configured, enable those testcases as well). If any testcase is disabled compared to the current all.yml, please provide justification in addition to the generated HTML reports.

3. To execute ansible-playbook you can run

   make I=inventory/reference/example.yml validation

Ensure that your Python virtual environment is activated before running the playbook.

Validation Results

The execution of the all the tests produces the following output files on the Ansible controller (e.g. laptop):

• /tmp/cloud_verification_report.html
• /tmp/conn-matrix-report.html
• /tmp/conn-matrix-raw-data.json
• /tmp/fe_ha_report.html