Exercise 1.1 - Writing Your First playbook | Red Hat

Section 1: Creating a Directory Structure and Files for your Playbook

There is a best practice on the preferred directory structures for playbooks. We strongly encourage you to read and understand these practices as you develop your Ansible ninja skills. That said, our playbook today is very basic and creating a complex structure will just confuse things.

Instead, we are going to create a very simple directory structure for our playbook, and add just a couple of files to it.

Step 1: Create a directory called `apache_basic` in your home directory and change directories into it

mkdir ~/apache_basic
cd ~/apache_basic

Step 2: Use `vi` or `vim` to open a file called `install_apache.yml`

Section 2: Defining Your Play

Now that you are editing install_apache.yml, let’s begin by defining the play and then understanding what each line accomplishes

---
- hosts: web
  name: Install the apache web service
  become: yes

--- Defines the beginning of YAML
hosts: web Defines the host group in your inventory on which this play will run against
name: Install the apache web service This describes our play
become: yes Enables user privilege escalation. The default is sudo, however su, pbrun, and several others methods are also supported.

Section 3: Adding Tasks to Your Play

Now that we’ve defined your play, let’s add some tasks to get some things done. Align (vertically) the t in task with the b become.
Yes, it does actually matter. In fact, you should make sure all of your playbook statements are aligned in the way shown here.
If you want to see the entire playbook for reference, skip to the bottom of this exercise.

tasks:
 - name: install apache
   package:
     name: httpd
     state: present

 - name: start httpd
   service:
     name: httpd
     state: started

tasks: This denotes that one or more tasks are about to be defined
- name: Each task requires a name which will print to standard output when you run your playbook. Therefore, give your tasks a name that is short, sweet, and to the point

package:
  name: httpd
  state: present

These three lines are calling the Ansible module package to install httpd. Click here to see all options for the package module.

service:
  name: httpd
  state: started

The next few lines are using the ansible module service to start the httpd service. The service module is the preferred way of controlling services on remote hosts. Click here to learn more about the service module.

Section 4: Saving your Playbook

Now that you’ve completed writing your playbook, it would be a shame not to keep it.

Use the write/quit method in vi or vim to save your playbook, i.e. Esc :wq!

And that should do it. You should now have a fully written playbook called install_apache.yml. You are ready to automate!

Ansible (well, YAML really) can be a bit particular about formatting especially around indentation/spacing. When you all get back to the office, read up on this YAML Syntax a bit more and it will save you some headaches later. In the meantime, your completed playbook should look like this. Take note of the spacing and alignment.

---
- hosts: web
  name: Install the apache web service
  become: yes

  tasks:
    - name: install apache
      package:
        name: httpd
        state: present

    - name: start httpd
      service:
        name: httpd
        state: started

Workshop Details

Student ID:

Workshop:

Region:

Domain:
Workshop Name:
Region:
User ID:

Exercise 1.1 - Writing Your First playbook