mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Add intro to playbook docs using YAML dictionaries
This commit is contained in:
parent
07dfbaedc3
commit
1e787bd91e
1 changed files with 37 additions and 0 deletions
|
@ -73,6 +73,43 @@ For starters, here's a playbook that contains just one play::
|
||||||
- name: restart apache
|
- name: restart apache
|
||||||
service: name=httpd state=restarted
|
service: name=httpd state=restarted
|
||||||
|
|
||||||
|
We can also break task items out over multiple lines using the YAML dictionary
|
||||||
|
types to supply module arguments. This can be helpful when working with tasks
|
||||||
|
that have really long parameters or modules that take many parameters to keep
|
||||||
|
them well structured. Below is another version of the above example but using
|
||||||
|
YAML dictionaries to supply the modules with their key=value arguments.::
|
||||||
|
|
||||||
|
---
|
||||||
|
- hosts: webservers
|
||||||
|
vars:
|
||||||
|
http_port: 80
|
||||||
|
max_clients: 200
|
||||||
|
remote_user: root
|
||||||
|
tasks:
|
||||||
|
- name: ensure apache is at the latest version
|
||||||
|
yum:
|
||||||
|
pkg: httpd
|
||||||
|
state: latest
|
||||||
|
- name: write the apache config file
|
||||||
|
template:
|
||||||
|
src: /srv/httpd.j2
|
||||||
|
dest: /etc/httpd.conf
|
||||||
|
notify:
|
||||||
|
- restart apache
|
||||||
|
- name: ensure apache is running
|
||||||
|
service:
|
||||||
|
name: httpd
|
||||||
|
state: started
|
||||||
|
handlers:
|
||||||
|
- name: restart apache
|
||||||
|
service:
|
||||||
|
name: httpd
|
||||||
|
state: restarted
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
The above example using YAML dictionaries for module arguments can also be accomplished using the YAML multiline string syntax with the `>` character but this can lead to string quoting errors.
|
||||||
|
|
||||||
Below, we'll break down what the various features of the playbook language are.
|
Below, we'll break down what the various features of the playbook language are.
|
||||||
|
|
||||||
.. _playbook_basics:
|
.. _playbook_basics:
|
||||||
|
|
Loading…
Reference in a new issue