ansible-lint - lint tool for Ansible playbooks, roles and collections

Options you will use

--profile {min,basic,moderate,safety,shared,production}

Specify which rules profile to be used.

-p, --parseable

Parseable output (pep8 format: file:line: rule: message).

-x, --skip-list SKIP_LIST

Only check rules whose id/tags do not match these values.

-w, --warn-list WARN_LIST

Only warn about these rules (default: experimental, jinja[spacing], fqcn[deep]).

-L, --list-rules

List all the rules.

--offline

Disable installation of requirements.yml and schema refreshing.

--version

Show the version and the ansible-core it uses.

Examples

$ ansible-lint

the whole project, auto-detected

$ ansible-lint site.yml

one playbook

$ ansible-lint --profile production

the strictest profile

$ ansible-lint -p

one line per violation (for CI annotations)

Gotchas

• Exit code 2 = violations that are fatal; 0 = passed (warnings allowed).
• Silence one finding with # noqa: rule-id on the line; whole rules with skip_list in .ansible-lint.
• Profiles build on each other: min < basic < moderate < safety < shared < production.

Taught in

• 33.30 Debugging and linting