Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
play

GitHub Action

Ansible Lint Action

v1.1.0

Ansible Lint Action

play

Ansible Lint Action

Run Ansible Lint

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Ansible Lint Action

uses: osism-archive/[email protected]

Learn more about this action in osism-archive/ansible-lint-action

Choose a version

Ansible Lint for GitHub Actions

This action allows you to run ansible-lint with no additional options.

Version ansible-lint ansible
main 5.3.2 5.2.0
v1.0.0 5.3.2 5.2.0
v1.1.0 5.4.0 5.4.0

Usage

To use the action simply create an check-ansible-syntax.yml file (or choose custom *.yml name) in the .github/workflows/ directory.

For example:

name: Check ansible syntax  # feel free to pick your own name

on: [push, pull_request]

jobs:
  check-ansible-syntax:

    runs-on: ubuntu-latest

    steps:
    # Important: This sets up your GITHUB_WORKSPACE environment variable
    - uses: actions/checkout@v2

    - name: Lint Ansible Playbook
      # replace "main" with any valid ref
      uses: osism/ansible-lint-action@main
      with:
        # [required]
        # Paths to ansible files (i.e., playbooks, tasks, handlers etc..)
        # or valid Ansible directories according to the Ansible role
        # directory structure.
        # If you want to lint multiple ansible files, use the following syntax
        # targets: |
        #   playbook_1.yml
        #   playbook_2.yml
        targets: ""
        # [optional]
        # Arguments to override a package and its version to be set explicitly.
        # Must follow the example syntax.
        override-deps: |
          ansible==5.2.0
          ansible-lint==5.3.2
        # [optional]
        # Arguments to be passed to the ansible-lint

        # Options:
        #   -q                    quieter, although not silent output
        #   -p                    parseable output in the format of pep8
        #   --parseable-severity  parseable output including severity of rule
        #   -r RULESDIR           specify one or more rules directories using one or
        #                         more -r arguments. Any -r flags override the default
        #                         rules in ansiblelint/rules, unless -R is also used.
        #   -R                    Use default rules in ansiblelint/rules in addition to
        #                         any extra
        #                         rules directories specified with -r. There is no need
        #                         to specify this if no -r flags are used
        #   -t TAGS               only check rules whose id/tags match these values
        #   -x SKIP_LIST          only check rules whose id/tags do not match these
        #                         values
        #   --nocolor             disable colored output
        #   --exclude=EXCLUDE_PATHS
        #                         path to directories or files to skip. This option is
        #                         repeatable.
        #   -c C                  Specify configuration file to use. Defaults to ".ansible-lint"
        args: ""

License

The Dockerfile and associated scripts and documentation in this project are released under the MIT.

Credits

This fork is based on ansible/ansible-lint-action.

The initial GitHub action has been created by Stefan Stölzle at stoe/actions.