Ansible-lint
ansible-lint checks playbooks for practices and behavior that could
potentially be improved. As a community-backed project ansible-lint supports
only the last two major versions of Ansible.
Visit the Ansible Lint docs site
Using ansible-lint as a GitHub Action
This action allows you to run ansible-lint on your codebase without having to
install it yourself.
# .github/workflows/ansible-lint.yml
name: ansible-lint
on:
pull_request:
branches: ["main", "stable", "release/v*"]
jobs:
build:
name: Ansible Lint # Naming the build is important to use it as a status check
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@v6
- name: Run ansible-lint
uses: ansible/ansible-lint@main # or vX.X.X version
# optional (see below):
with:
args: ""
gh_action_ref: "<version - e.g. `v25.5.0`>" # Not recommended for non-composite action use
setup_python: "true"
python_version: "3.14"
working_directory: ""
requirements_file: ""
By default, the workflow uses ansible-lint installed from main. For production or stable workflows, it is recommended to specify a particular release tag (in format v.X.X.X).
All the arguments are optional:
args: Arguments to be passed to ansible-lint command.gh_action_ref: The git branch, tag, or commit to use for ansible-lint. Not recommended for standard use - only use with composite actions whereGH_ACTION_REFis set to the parent action version.requirements_file: Path to the requirements.yml file to install role and collection dependencies.setup_python: If python should be installed. Default istrue.python_version: The version of python to install. Default is3.14.working_directory: The directory where to run ansible-lint from. Default isgithub.workspace. Needed if you want to lint only a subset of your repository.
For more details, see ansible-lint-action.
Communication
Refer to the Talk to us section of the Contributing guide to find out how to get in touch with us.
You can also find more information in the Ansible communication guide.
Contributing
Please read Contribution guidelines if you wish to contribute.
Code of Conduct
Please see the Ansible Community Code of Conduct.
Licensing
The ansible-lint project is distributed as GPLv3 due to use of GPLv3 runtime
dependencies, like ansible and yamllint.
For historical reasons, its own code-base remains licensed under a more liberal MIT license and any contributions made are accepted as being made under original MIT license.
Authors
ansible-lint was created by Will Thames and is now maintained as part of the Ansible by Red Hat project.
4 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ansible_lint-26.8.0.tar.gz.
File metadata
- Download URL: ansible_lint-26.8.0.tar.gz
- Upload date:
- Size: 776.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
65cb5efab1ffaedbe23af0fff241a8834294f8ac80a8c838c2143024afc103a4
|
|
| MD5 |
ab26ca9094c5dc722175696ef698974a
|
|
| BLAKE2b-256 |
791723a03a6595a42445095da9d73883aeb2432002ecb4c130628a6241d44eb9
|
Provenance
The following attestation bundles were made for ansible_lint-26.8.0.tar.gz:
Publisher:
release.yml on ansible/ansible-lint
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ansible_lint-26.8.0.tar.gz -
Subject digest:
65cb5efab1ffaedbe23af0fff241a8834294f8ac80a8c838c2143024afc103a4 - Sigstore transparency entry: 2433054286
- Sigstore integration time:
-
Permalink:
ansible/ansible-lint@665d9e07a1943254d2910faffc106adaf7ea7294 -
Branch / Tag:
refs/tags/v26.8.0 - Owner: https://github.com/ansible
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@665d9e07a1943254d2910faffc106adaf7ea7294 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ansible_lint-26.8.0-py3-none-any.whl.
File metadata
- Download URL: ansible_lint-26.8.0-py3-none-any.whl
- Upload date:
- Size: 335.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
94e58501cc7fafaa505dd9daea3bddb4affa6e8efe8217323c06d7194a312f57
|
|
| MD5 |
ef9483d85f6a21d3af1799400c797dde
|
|
| BLAKE2b-256 |
6927c9707a6165683c85ff67cb8e5efa5238ecf26dac0626955971ef02108e84
|
Provenance
The following attestation bundles were made for ansible_lint-26.8.0-py3-none-any.whl:
Publisher:
release.yml on ansible/ansible-lint
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ansible_lint-26.8.0-py3-none-any.whl -
Subject digest:
94e58501cc7fafaa505dd9daea3bddb4affa6e8efe8217323c06d7194a312f57 - Sigstore transparency entry: 2433054635
- Sigstore integration time:
-
Permalink:
ansible/ansible-lint@665d9e07a1943254d2910faffc106adaf7ea7294 -
Branch / Tag:
refs/tags/v26.8.0 - Owner: https://github.com/ansible
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@665d9e07a1943254d2910faffc106adaf7ea7294 -
Trigger Event:
release
-
Statement type:
