Skip to main content

Checks playbooks for practices and behavior that could potentially be improved

Project description

PyPI version Ansible-lint rules explanation Discussions pre-commit

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@v4
      - name: Run ansible-lint
        uses: ansible/ansible-lint@main
        # optional (see below):
        with:
          args: ""
          setup_python: "true"
          working_directory: ""
          requirements_file: ""

All the arguments are optional and most users should not need them:

  • args: Arguments to be passed to ansible-lint command.
  • setup_python: If python should be installed. Default is true.
  • working_directory: The directory where to run ansible-lint from. Default is github.workspace. That might be needed if you want to lint only a subset of your repository.
  • requirements_file: Path to the requirements.yml file to install role and collection dependencies.

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.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansible_lint-25.6.1.tar.gz (559.3 kB view details)

Uploaded Source

Built Distribution

ansible_lint-25.6.1-py3-none-any.whl (316.9 kB view details)

Uploaded Python 3

File details

Details for the file ansible_lint-25.6.1.tar.gz.

File metadata

  • Download URL: ansible_lint-25.6.1.tar.gz
  • Upload date:
  • Size: 559.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ansible_lint-25.6.1.tar.gz
Algorithm Hash digest
SHA256 6a1dd2b7a9f3f202c9e92a6c80296ff33ca863348c3acf978f80fb0d4536dce4
MD5 f3062f41024449887962973b88cd1592
BLAKE2b-256 5c27f04e69b710efbfde20cfdcdb8eec3b3b1d4b6d480a80afa803386304e829

See more details on using hashes here.

Provenance

The following attestation bundles were made for ansible_lint-25.6.1.tar.gz:

Publisher: release.yml on ansible/ansible-lint

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ansible_lint-25.6.1-py3-none-any.whl.

File metadata

  • Download URL: ansible_lint-25.6.1-py3-none-any.whl
  • Upload date:
  • Size: 316.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ansible_lint-25.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 69fe294a3cc30d8819b5a30625a7e25225f48558cadb83ad3d4dec597c1b8c2c
MD5 d8582df15de44c266b9f5eea0210853b
BLAKE2b-256 ea1d8e4972bc37bc6a2ac87a687076775e631350dd05c3d0517f88e0c46176a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for ansible_lint-25.6.1-py3-none-any.whl:

Publisher: release.yml on ansible/ansible-lint

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page