Hesham-14/Ansible-Labs

Ansible Labs Documentation

This documentation provides step-by-step guides and examples for working with Ansible, covering various topics such as setting up the environment, practicing inventory management, configuration, playbooks, tasks, handlers, roles, and more.

Table of Contents

1. Setup Environment
2. Practicing Inventory
3. Practicing ansible.cfg
4. Practicing Command Escalation (become)
5. Practicing Playbook
6. Install Nginx Task
7. Practicing Tags
8. Always Tag
9. Practicing Variables
10. Practicing Loops
11. Practicing When
12. Practicing Register
13. Practicing Register & When
14. Practicing Handler
15. Practicing Template
16. Roles Project

Setup Environment

1. Install Ansible on your machine.

   $ sudo apt install ansible
   
   # Install using pip to ensure all required Python packages are installed
   $ pip install ansible
   
   # Setup Docker environment

2. Create a key to be associated with the container to SSH into it, in the /.ssh/

   $ ssh-keygen -t rsa -b 2048

3. Create a Dockerfile for the image

   

4. Build the image

   $ docker build -t ansible-ubuntu-image .

5. Create a container using the image

   $ docker run -itd --name "lab1-server01" ansible-ubuntu-image

6. Get the container IP to connect to it

   $ docker inspect lab1-server01

   The IP is typically 172.17.0.2.

7. Move the public key to the container to activate it for SSH

   $ ssh-copy-id -i /home/user/.ssh/ansible-key.pub ansible@172.17.0.2

   

8. Now connect to the container using SSH

   $ ssh ansible@172.17.0.2

   

Practicing Inventory

1. Create an inventory file that contains all the IPs in your environment.

   

2. Ping all the servers using the following command.

   $ ansible all -i ./inventory --private-key /home/h-test/.ssh/ansible-key -u ansible -m ping

   

Practicing ansible.cfg

1. Write your config file

   

2. Now ping the web servers only for example.

   $ ansible webservers -m ping

   

Practicing Command Escalation (become)

If we tried to execute a sudo command that requires a password to has it’s execution privilege. Ansible will response with an error.

$ ansible webservers -m command -a "sudo touch /etc/shadow"

It will cause a runtime error.

So we need to tell ansible that you are going to need the root password, and this gets done using become

To do so, we need to activate the become and password asking either in terminal.

$ ansible webservers -m command --ask-become-pass -b -a "sudo touch /etc/shadow"

or in ansible.cfg

Practicing Playbook

1. Write your playbook file in .yml

   

2. Execute the following command

   $ ansible-playbook pinging-playbook.yml

   

Install Nginx Task

📢 Task

- Update cache
- Install latest nginx
- Copy index.html from controller to server01
- Restart nginx service
- Can you see your index.html file when you hit server01 on port 80 ?

1. Write a simple index.html file

   

2. Write your playbook file

   

3. Execute the following command

   $ ansible-playbook pinging-playbook.yml

4. Hit nginx

   Expose nginx port on the host by restarting the container and modifying the container networking.

Practicing Tags

1. Write your tags-playbook file

   

2. Execute the following command

   $ ansible-playbook tags-playbook.yml --tags install

Always Tag

Using always tag ensures the associated task is executed regardless.

Practicing Variables

1. you can specify your variables in the playbook file directly, as following..

   

2. Or write them in a separate variables.yml file. and refer to them in the playbook file.

   

3. Execute the following command

   $ ansible-playbook variables-playbook.yml

Practicing Loops

1. Write your loops-playbook file

   

   You also can add multiple attributes to the loop item, as following..

   

   Also you can store the item values as a variables, as following..

   

2. Execute the following command

   $ ansible-playbook loops-playbook.yml

Practicing When

1. Write your when-playbook file

   

   Execute using:

   $ ansible-playbook when-playbook.yml

   

Practicing Register

1. Write your register-playbook file

   !

   

   Execute using:

   $ ansible-playbook register-playbook.yml

   

Practicing Register & When

Practicing Handler

Practicing Template

---

Roles Project

Project Directory Files

• vars/main.yml

  

• files/index01.html

  

• templates/index02.html

  

• tasks/main.yml

  

• handlers/main.yml

  

• ./playbook.yml

  

Run the following command

$ ansible-playbook playbook.yml

Result

---

This documentation is a comprehensive guide to using Ansible for various tasks and projects. Each section provides detailed instructions and examples for practical implementation.

For more information and detailed usage, refer to the respective sections in this document.

---