ansible-lint1
Lint tool for ansible playbooks
Overview
usage: ansible-lint [-h] [-P | -L | -T]
- [-f {brief,full,md,json,codeclimate,quiet,pep8,sarif}]
-
[--sarif-file SARIF_FILE] [-q] [--profile {min,basic,moderate,safety,shared,production}] [-p] [--project-dir PROJECT_DIR] [-r RULESDIR] [-R] [-s] [--write [WRITE_LIST]] [--show-relpath] [-t TAGS] [-v] [-x SKIP_LIST] [--generate-ignore] [-w WARN_LIST] [--enable-list ENABLE_LIST] [--nocolor] [--force-color] [--exclude EXCLUDE_PATHS [EXCLUDE_PATHS ...]] [-c CONFIG_FILE] [-i IGNORE_FILE] [--offline] [--version] [lintables ...]
positional arguments:
- lintables
-
One or more files or paths. When missing it will enable auto-detection mode.
options:
-
-h, --help -
show this help message and exit
-
-P, --list-profiles -
List all profiles, no formatting options available.
-
-L, --list-rules -
List all the rules. For listing rules only the following formats for argument
-fare supported: {brief, full, md} with 'brief' as default.
-
-T, --list-tags -
List all the tags and the rules they cover. Increase the verbosity level with `-v` to include 'opt-in' tag and its rules.
-
-f {brief,full,md,json,codeclimate,quiet,pep8,sarif}, --format {brief,full,md,json,codeclimate,quiet,pep8,sarif} -
stdout formatting, json being an alias for codeclimate. (default: None)
-
--sarif-file SARIF_FILE -
SARIF output file
-
-q -
quieter, reduce verbosity, can be specified twice.
-
--profile {min,basic,moderate,safety,shared,production} -
Specify which rules profile to be used.
-
-p, --parseable -
parseable output, same as '-f pep8'
-
--project-dir PROJECT_DIR -
Location of project/repository, autodetected based on location of configuration file.
-
-r RULESDIR, --rules-dir RULESDIR -
Specify custom rule directories. Add
-Rto keep using embedded rules from /usr/lib/python3/dist-packages/ansiblelint/rules
-
-R -
Keep default rules when using
-r
-
-s, --strict -
Return non-zero exit code on warnings as well as errors
-
--write [WRITE_LIST] -
Allow ansible-lint to reformat YAML files and run rule transforms (Reformatting YAML files standardizes spacing, quotes, etc. A rule transform can fix or simplify fixing issues identified by that rule). You can limit the effective rule transforms (the 'write_list') by passing a keywords 'all' or 'none' or a comma separated list of rule ids or rule tags. YAML reformatting happens whenever '--write' or '--write=' is used. '--write' and '--write=all' are equivalent: they allow all transforms to run. The effective list of transforms comes from 'write_list' in the config file, followed whatever '--write' args are provided on the commandline. '--write=none' resets the list of transforms to allow reformatting YAML without running any of the transforms (ie '--write=none,rule-id' will ignore write_list in the config file and only run the rule-id transform).
-
--show-relpath -
Display path relative to CWD
-
-t TAGS, --tags TAGS -
only check rules whose id/tags match these values
-
-v -
Increase verbosity level (
-vvfor more)
-
-x SKIP_LIST, --skip-list SKIP_LIST -
only check rules whose id/tags do not match these values. e.g:
--skip-list=name,run-once
-
--generate-ignore -
Generate a text file '.ansible-lint-ignore' that ignores all found violations. Each line contains filename and rule id separated by a space.
-
-w WARN_LIST, --warn-list WARN_LIST -
only warn about these rules, unless overridden in config file. Current version default value is: experimental, jinja[spacing], fqcn[deep]
-
--enable-list ENABLE_LIST -
activate optional rules by their tag name
-
--nocolor -
disable colored output, same as NO_COLOR=1
-
--force-color -
Force colored output, same as FORCE_COLOR=1
--excludeEXCLUDE_PATHS [EXCLUDE_PATHS ...]-
path to directories or files to skip. This option is repeatable.
-
-c CONFIG_FILE, --config-file CONFIG_FILE -
Specify configuration file to use. By default it will look for '.ansible-lint', '.config/ansible-lint.yml', or '.config/ansible-lint.yaml'
-
-i IGNORE_FILE, --ignore-file IGNORE_FILE -
Specify ignore file to use. By default it will look for '.ansible-lint-ignore' or '.config/ansible-lintignore.txt'
-
--offline -
Disable installation of requirements.yml and schema refreshing
--version
Releases
4 releases since Debian 10 (Buster); the text changed 2 times.
--config-file since Debian 13 (Trixie);
--enable-list since Debian 13 (Trixie);
--format since Debian 13 (Trixie);
--generate-ignore since Debian 13 (Trixie);
--ignore-file since Debian 13 (Trixie);
--list-profiles since Debian 13 (Trixie);
--list-rules since Debian 13 (Trixie);
--list-tags since Debian 13 (Trixie);
--offline since Debian 13 (Trixie);
--parseable since Debian 13 (Trixie);
--profile since Debian 13 (Trixie);
--project-dir since Debian 13 (Trixie);
--rules-dir since Debian 13 (Trixie);
--sarif-file since Debian 13 (Trixie);
--show-relpath since Debian 13 (Trixie);
--skip-list since Debian 13 (Trixie);
--strict since Debian 13 (Trixie);
--tags since Debian 13 (Trixie);
--warn-list since Debian 13 (Trixie);
--write since Debian 13 (Trixie);
-P since Debian 13 (Trixie);
-c since Debian 13 (Trixie);
-f since Debian 13 (Trixie);
-i since Debian 13 (Trixie);
-s since Debian 13 (Trixie);
-w since Debian 13 (Trixie).
--exclude until Debian 12 (Bookworm);
--module-path until Debian 12 (Bookworm);
-M until Debian 12 (Bookworm).