lint-playbook

Lint Ansible Playbook

Context

• Current directory: !pwd
• Available playbooks: !find . -name "*.yml" -o -name "*.yaml" | grep -E "(playbook|site)" | head -20
• Ansible version: !ansible --version 2>&1 | head -1 || echo "Ansible not installed"
• ansible-lint installed: !ansible-lint --version 2>&1 || echo "ansible-lint not installed"

Your Task

Lint and validate the specified Ansible playbook for syntax errors, best practices violations, and potential issues.

Arguments

• $1: Path to Ansible playbook file (required)

Steps

1. Verify playbook file exists

   • Check if the specified file exists
   • If not provided, list available playbooks and ask user to specify

2. Run syntax check

   ansible-playbook --syntax-check $1
   

   • Verify YAML syntax
   • Check for undefined variables
   • Validate task structure
   • Report syntax errors

3. Run ansible-lint (if available)

   ansible-lint $1
   

   • Check best practices
   • Identify deprecated syntax
   • Check for security issues
   • Report warnings and errors
   • If not installed, suggest: pip install ansible-lint

4. Run yamllint (if available)

   yamllint $1
   

   • Check YAML formatting
   • Verify indentation
   • Check line length
   • If not installed, suggest: pip install yamllint

5. Analyze and summarize results

   • Categorize issues by severity
   • Highlight critical issues
   • Provide specific recommendations
   • Show line numbers for issues

6. Provide actionable recommendations

   • Explain each issue
   • Suggest specific fixes
   • Prioritize by impact
   • Reference best practices

Output Format

## Ansible Playbook Lint Results

**Playbook:** [filename]
**Size:** [file size]

### Syntax Check
✓ Passed / ✗ Failed
[Details of syntax check]

### ansible-lint Analysis
✓ Passed / ✗ Failed
- Errors: [count]
- Warnings: [count]

[List of issues with line numbers and rules]

### YAML Lint
✓ Passed / ✗ Failed
- Errors: [count]
- Warnings: [count]

### Summary

**Critical Issues:** [count]
- [Issue 1 with fix]
- [Issue 2 with fix]

**Warnings:** [count]
- [Warning 1 with recommendation]

**Recommendations:**
1. [Priority 1 fix with code example]
2. [Priority 2 fix with code example]