diff --git a/pages/common/ansible-lint.md b/pages/common/ansible-lint.md new file mode 100644 index 0000000000..e0c6a7e0bb --- /dev/null +++ b/pages/common/ansible-lint.md @@ -0,0 +1,24 @@ +# ansible-lint + +> Apply rules and follow best practices with your automation content. +> More information: . + +- Lint a specific playbook and a role directory: + +`ansible-lint {{path/to/playbook_file}} {{path/to/role_directory}}` + +- Lint a playbook while excluding specific rules: + +`ansible-lint {{[-x|--exclude-rules]}} {{rule1,rule2,...}} {{path/to/playbook_file}}` + +- Lint a playbook in offline mode and format output as PEP8: + +`ansible-lint {{[-o|--offline]}} {{[-p|--parseable]}} {{path/to/playbook_file}}` + +- Lint a playbook using a custom rules directory: + +`ansible-lint {{[-r|--rules]}} {{path/to/custom_rules_directory}} {{path/to/playbook_file}}` + +- Lint all Ansible content recursively in a given directory: + +`ansible-lint {{path/to/project_directory}}`