This project aims to generate JSON/YAML validation schemas for Ansible files such as playbooks, tasks, requirements, meta or vars and also for Zuul and Molecule configuration.
Keep in mind that these schemas will limit your freedom of choice regarding the syntax you can use to write Ansible tasks as they do not allow some historical forms which are still allowed by Ansible itself.
Not any file accepted by Ansible will pass these schemas but we do expect that any file that passed these schemas should be accepted by Ansible.
- YAML 1.2 booleans are required as
true
orfalse
, while Ansible itself allows you to use more relaxed forms likeyes
orno
. - Inline actions are not allowed, as schema cannot validate them
- Non builtin modules must be called using
action:
blocks - Module arguments are not yet verified but we plan to implement it
As these schemas are still experimental, creating pull-requests to improve the schema is of much greater help. Though you are still welcome to report bugs but expect them to take a longer time until someone finds time to fix them.
If you want to help improve the schemas, have a look at the development documentation.
At this moment installing Ansible VS Code Extension by Red Hat will activate these schemas. The file patterns used to trigger their use can be seen here
Because these schemas are generic, you can easily use them with any validators that support them.