Working With Playbooks
Playbooks are Ansible’s configuration, deployment, and orchestration language. They can describe a policy you want your remote systems to enforce, or a set of steps in a general IT process.
If Ansible modules are the tools in your workshop, playbooks are your instruction manuals, and your inventory of hosts are your raw material.
At a basic level, playbooks can be used to manage configurations of and deployments to remote machines. At a more advanced level, they can sequence multi-tier rollouts involving rolling updates, and can delegate actions to other hosts, interacting with monitoring servers and load balancers along the way.
While there’s a lot of information here, there’s no need to learn everything at once. You can start small and pick up more featuresover time as you need them.
Playbooks are designed to be human-readable and are developed in a basic text language. There are multipleways to organize playbooks and the files they include, and we’ll offer up some suggestions on that and making the most out of Ansible.
You should look at Example Playbooks while reading along with the playbook documentation. These illustrate best practices as well as how to put many of the various concepts together.
- Intro to Playbooks
- Creating Reusable Playbooks
- Using Variables
- Creating valid variable names
- Defining variables in inventory
- Defining variables in a playbook
- Defining variables in included files and roles
- Using variables with Jinja2
- Transforming variables with Jinja2 filters
- Hey wait, a YAML gotcha
- Variables discovered from systems: Facts
- Registering variables
- Accessing complex variable data
- Accessing information about other hosts with magic variables
- Defining variables in files
- Passing variables on the command line
- Variable precedence: Where should I put a variable?
- Using advanced variable syntax
- Templating (Jinja2)
- Conditionals
- Loops
- Blocks
- Advanced Playbooks Features
- Understanding privilege escalation: become
- Asynchronous Actions and Polling
- Check Mode (“Dry Run”)
- Playbook Debugger
- Delegation, Rolling Updates, and Local Actions
- Setting the Environment (and Working With Proxies)
- Working With Language-Specific Version Managers
- Error Handling In Playbooks
- Advanced Syntax
- Working With Plugins
- Prompts
- Tags
- Using Vault in playbooks
- Start and Step
- Playbook Keywords
- Lookups
- Module defaults
- Controlling playbook execution: strategies and more
- Best Practices
- Playbook Example: Continuous Delivery and Rolling Upgrades