ansible-lint

Lint a playbook

$ ansible-lint [playbook.yml]

$ ansible-lint

$ ansible-lint -p [production] [playbook.yml]

$ ansible-lint -L

$ ansible-lint --skip-list [yaml,risky-shell-pipe] [playbook.yml]

$ ansible-lint -f json [playbook.yml]

ansible-lint [-p profile] [-x skip] [-f format] [playbooks]

ansible-lint checks Ansible playbooks, roles, and collections for practices and behaviors that could potentially be improved. It identifies deprecated syntax, security concerns, style issues, and best practice violations.
The tool helps maintain consistent, high-quality Ansible code and catch common mistakes before deployment.

-L, --list-rules

List all available rules

Skip specific rules

Treat rules as warnings only

Select rule profile (min, basic, moderate, safety, shared, production)

Output format: rich, plain, json, codeclimate, sarif

Attempt to fix linting errors

Quieter output

Treat warnings as errors

Configuration file

Not all rules apply to all use cases; configure skip-list appropriately. The --fix option may not handle all issues. False positives may occur with complex variable usage.

ansible-lint was created to help enforce best practices in Ansible projects. It became an official Ansible project and has been actively maintained with evolving rule sets.

ansible(1), ansible-playbook(1), yamllint(1)