openstack-ansible/doc/source/install-guide/configure-configurationintegrity.rst
Jean-Philippe Evrard 8edf7fe90c Documentation: Syntax checking before running playbooks
This brings:
1) A new page to explain how can a deployer test its
configuration files.

2) Links on the pages mentionning the playbooks that
traditionally has errors because of the deployer's config.

Change-Id: I434152a14de806e24e5886969dfa15e3ff1c4928
2015-10-08 08:11:53 +00:00

900 B

Home OpenStack-Ansible Installation Guide

Checking the integrity of your configuration files

Here are a few steps to execute before running any playbook:

  1. Make sure all the files edited in /etc/ are ansible YAML compliant. Guidelines can be found here: http://docs.ansible.com/ansible/YAMLSyntax.html

  2. Check the integrity of your yaml files using a yaml linter.

    Note

    Here is an online linter: http://www.yamllint.com/

  3. Run your command with syntax-check, for example, in the playbooks directory:

    $ openstack-ansible setup-infrastructure.yml --syntax-check
  4. Recheck that all indentation seems correct: the syntax of the configuration files can be correct while not being meaningful for openstack-ansible.