ansible-playbook_skill

Overview

This skill helps you develop, debug, and run Ansible playbooks, roles, and inventory files for infrastructure automation. It focuses on idempotent configuration, common module patterns, and practical checks to avoid typical YAML or runtime errors. Use it to convert shell scripts into reusable Ansible tasks and to enforce reliable, repeatable deployments.

How this skill works

The skill inspects playbook structure, variable placement, and module usage to surface issues like syntax errors, wrong FQCNs, or variable precedence mistakes. It suggests best-fit modules and patterns (file, copy, template, package, service, command), shows handler and error-handling examples, and recommends verification commands and config settings. It also guides on testing with --check, --diff, and inventory validation.

When to use it

• Creating new playbooks, roles, or inventory layouts
• Debugging YAML syntax and indentation errors
• Troubleshooting module parameter failures or unexpected task results
• Resolving variable precedence and scoping issues
• Converting shell scripts into idempotent Ansible tasks

Best practices

• Always use fully qualified collection names (e.g., ansible.builtin.copy) instead of short module names
• Keep secrets and environment-specific values in group_vars/host_vars or use vault, not hardcoded values
• Follow a consistent project structure (ansible.cfg, inventory, group_vars, host_vars, roles, playbooks)
• Add changed_when/failed_when for commands and use handlers with notify and meta: flush_handlers when needed
• Run ansible-playbook --syntax-check and --check --diff before applying changes to production

Example use cases

• Create a role that installs packages, deploys config templates, and ensures services are enabled and started
• Debug a playbook failing due to an unquoted string containing a colon or a YAML indentation issue
• Convert a maintenance shell script into a playbook with idempotent file and service tasks
• Implement a safe upgrade task using block/rescue/always for rollback and cleanup
• Validate inventory and host-specific variables with ansible-inventory --list and --host hostname