README.md

ansible-lint

This is the rule-set I use for my ansible roles. By linting the roles and playbooks you get an standarized setup and use best practices.

Setup

You need to have ansible-lint installed:

$ pip install ansible-lint

Check the rules out to a directory of your choice:

$ hub clone lxhunter/ansible-lint /usr/local/src/ansible-lint
# or
$ git clone https://github.com/lxhunter/ansible-lint.git /usr/local/src/ansible-lint

Pro-Tip: I use fresh for this:

$ fresh lxhunter/ansible-lint . --file=/usr/local/src/ansible-lint

Usage

Now you can lint your playbooks by doing:

# just my rules
$ ansible-lint -r /usr/local/src/ansible-lint/rules playbook.yml
# or for the standard rule and mine
$ ansible-lint -R -r /usr/local/src/ansible-lint/rules playbook.yml
# geek

Rules

Code	Message
LX1	Playbook
---
LX2	Role
---
LX3	Task
---
LX4	General Module
LX401	Specific Modules should have owner, group and mode
---
LX5	Specific Module
LX501	Template Module - Template files should have the extension '.j2'

Testing

Setup:

You need to have nodemon installed:

$ npm install

Usage:

I used node for testing:

nodemon LX401

Credits

• Initial Idea from Will Thames
• Learned a lot from shirou and his rules

Contribute

Tutorial

Author

Author:: Alexander Jäger

Copyright 2018