Editing Ansible playbooks

Ansible playbooks<ref>https://docs.ansible.com/ansible/latest/user_guide/playbooks.html</ref> are written in [[YAML]] text files and define actions to execute against host/devices, check official Ansible playbook introduction: https://docs.ansible.com/ansible/devel/user_guide/playbooks_intro.html

=== Task definitions or Playbooks ===
Task definitions are defined in text files, called playbooks in Ansible terminology, in [[DevOps/YAML|YAML]] format. Execution of task definitions or playbooks are make using <code>ansible-playbook</code> command followed by your desired playbook to execute. Playbooks can also use [[Jinja]] templates to enable dynamic expressions and access to variables<ref>https://docs.ansible.com/ansible/latest/user_guide/playbooks_templating.html</ref>.

[[Ansible Playbooks|Ansible Playbook]] execution:
* <code>ansible-playbook my_new_created_playbook.yml</code>
* <code>ansible-playbook my_new_created_playbook.yml -f 10</code> -f 10 parallelize 10 executions
:: <code>-f forks</code>

=== Create "Executable" Playbooks ===
Add the following line <code>#!/usr/bin/env ansible-playbook</code> at the beginning of your playbooks and make it executable <code>chmod +x /path/to/your/playbook.yml</code> to execute without calling ansible-playbook binary.

=== [[Ansible Playbooks Examples]]===
Create a new file ''touch /tmp/test_file.txt'',  REMOTE_SERVER should be already present in your [[Ansible inventory]]:<code>/etc/ansible/host</code>

Playbook using module <code>file</code><ref>https://docs.ansible.com/ansible/latest/modules/file_module.html#file-module</ref>:

 #![[/usr/bin/env]] ansible-playbook
 
 - hosts: REMOTE_SERVER_HOSTNAME
   tasks:
   - name: Ansible create a new file called test_fle.txt in /tmp directory
     file:
       path: "/tmp/test_file.txt"
       state: touch

Important Note: dash symbol (-) and [[indentation]] has to be properly formatted.

Additional examples:
* [[Installing sysstat using Ansible]]


== Errors ==
 [[A playbook must be a list of plays]]

=== Variables ===
You can use variables in your playbooks, check official documentation for further information: https://docs.ansible.com/ansible/devel/user_guide/playbooks_variables.html


== Activities ==
# Read Ansible introduction to playbooks: https://docs.ansible.com/ansible/devel/user_guide/playbooks_intro.html
# Review different options for running playbooks, including: <code>--limit</code>
# Review <code>--check</code> option
# Review [[Ansible playbooks examples]]

== See also ==
* {{ansible}}

[[Category:Server administration]]


{{CC license}}
Source: wikiversity