A collection of generic ansible playbooks for the Validation Framework
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Zuul be239e8773 Merge "Normalizing VF metadata" 1 week ago
.config/molecule Molecule test restoration 4 months ago
doc Dependency reorganization 8 months ago
playbooks Removing coverchange job 2 months ago
releasenotes Update master for stable/1.6 2 months ago
roles Setting default inventory to 0 length string 2 weeks ago
scripts fix(molecule): Add ability to run molecule on Fedora 4 months ago
tests Molecule test restoration 4 months ago
tools removing callbacks from validations-common 2 months ago
validations_common Bugfix: Add missing become: true to 2 tasks 3 weeks ago
.ansible-lint Update validations for Ansible 2.11 8 months ago
.coveragerc Cover report omits test files 1 year ago
.dockerignore Adds dockerignore to the repo 1 year ago
.gitignore .gitignore now excludes JSON molecule logs 1 year ago
.gitreview Migrate molecule jobs from centos 7 to 8 2 years ago
.pre-commit-config.yaml Bumping the ansible-lint version to 5.3.2 in order to resolve CI failure 4 months ago
.reqcheck_override.yaml Reqcheck job for upstream validations-common 1 year ago
.stestr.conf Make the measuring code coverage test working 1 year ago
.yamllint Enabling indentation rule for yamllint. 11 months ago
.zuul.yaml Merge "Setting default branch of devstack repositories for functional tests" 3 weeks ago
CONTRIBUTING.rst Reorganize CONTRIBUTING information 11 months ago
LICENSE Molecule test restoration 4 months ago
MANIFEST.in Initialization of validations-common 2 years ago
README.rst fix(molecule): Add ability to run molecule on Fedora 4 months ago
ansible-collections-requirements.yml fix(molecule): Add ability to run molecule on Fedora 4 months ago
ansible-test-env.rc [Testing Infra] Apply here the improvements done to tripleo-validations 1 year ago
bindep.txt fix(molecule): Add ability to run molecule on Fedora 4 months ago
molecule-requirements.txt Update validations for Ansible 2.11 8 months ago
requirements.txt Licences are now listed for all requirements. 1 year ago
setup.cfg Merge "Normalizing VF metadata" 1 week ago
setup.py Fix pbr installation issues 2 years ago
test-requirements.txt Molecule test restoration 4 months ago
tox.ini feat(removal): tox-ansible support 4 months ago

README.rst

Validations-common

image

A collection of Ansible roles and playbooks to detect and report potential issues during deployments.

The validations will help detect issues early in the deployment process and prevent field engineers from wasting time on misconfiguration or hardware issues in their environments.

Installation

There are several different ways to install validations-common. However it is recommended to both install and use the package inside python virtual environment.

At the command line using pip.

$ python3 -m pip install validations-common

Or, if you have virtualenvwrapper installed.

$ mkvirtualenv validations-common
$ python3 -m pip install validations-common

Installation with package manager

Alternatively it is possible to install validations-common using package manager.

Such as yum or dnf...

$ yum|dnf install validations-common

or the more modern dnf.

$ dnf install validations-common

Usage

Once the validations-common project has been installed, navigate to the chosen share path, usually /usr/share/ansible to access the installed roles, playbooks, and libraries.

While the validations-common can be run by itself, it nonetheless depends on Ansible and validations-libs. Therefore it isn't recommended to use only validations-common.

Validations Callbacks

http_json callback

The callback http_json sends Validations logs and information to an HTTP server as a JSON format in order to get caught and analysed with external tools for log parsing (as Fluentd or others).

This callback inherits from validation_json the format of the logging remains the same as the other logger that the Validation Framework is using by default.

To enable this callback, you need to add it to the callback whitelist. Then you need to export your http server url and port:

export HTTP_JSON_SERVER=http://localhost
export HTTP_JSON_PORT=8989

The callback will post JSON log to the URL provided. This repository has a simple HTTP server for testing purpose under:

tools/http_server.py

The default host and port are localhost and 8989, feel free to adjust those values to your needs.

Running the molecule tests

In order to run the molecule tests locally on your local machine, please follow the instructions documented in the Tripleo Validations Developers Guide.