# Ansible
![](/IaC/Ansible/ansible_main.jpg)

**Ansible** (Ансибл) - система управления конфигурациями. Написана и работает на Python. Позволяет настраивать удаленные машины на базе nix и windows (сомнительно но окей) используя скрипты с конфигурациями. Если уж совсем без айтишной душноты, то описав конфигурацию один раз, можно раскатить, к примеру, некий сервис на 10, 20 или тысячу тачек всего одним скриптом (плейбуком). Функционал настолько гибкий, что позволяет в зависимости от подключения к тачке, брать данные из конкретной машины (модуль setup) и подставлять данные в конфигурационные файлы. Так же в зависимости от версии Linux можно устанавливать отдельный набор программ для установки и учитывать специфику различных дистрибутивов. Самый простой пример - в RHEL/CentOS пакет apache2 там представлен как пакет httpd, а в Debian - просто apache2. Этот момент можно учесть и скрипт автоматически выберет нужную вилку для действий. Вобщем очень мощный инструмент, его функционал сложно описать в одном абзаце.

Основополагающим фактором отличия от аналогов типа Chef - нет потребности в агенте который будет обрабатывать операции с системой. Нужен только SSH.

## Основные понятия

Простые примеры для понимания:

### Inventory
Список хостов и параметров подключения к ним. Так же инвентарь можно обьединять в группы хостов, что может быть удобно, в случае если часть хостов относится к одному сервису, а часть - к другому. Если инвентарь отсутствует, то Ansible обращается к /etc/ansible/hosts. Если нет и его - /etc/hosts. Может быть представлен в виде ini-файла (простой вариант) и yaml (более гибкий). Это простой пример, поскольку не включает в себя дополнительные и возможно необходимые параметры вроде порта SSH, указания ключа/пароля и т.п.
Пример inventory.ini:
```ini
[web]
192.168.1.50
192.168.1.51
web-server.ru

[db]
192.168.1.51
db-server.local
```
Он же но в формате yaml
```yaml
web:
  hosts:
    192.168.1.50:
    192.168.1.51:
    web-server.ru:
db:
  hosts:
    192.168.1.51:
    db-server.local:
```

### Playbook
Задачи которые выполняются на удаленных машинах. Запускается, как правило, с указанием группы хостов или хоста на котором будут производиться операции. 
Пример playbook.yaml
```yaml
- hosts: web

- name: Create File
  file:
    path: "/var/www/web-server.ru/index.php"
    state: touch
    owner: www-data
    group: www-data
    mode: 0644
```
Задача создаст фаил по пути указанном в path и назначит права/владельца на созданный php-фаил. Этот плейбук будет применен к группе хостов web

### Roles
Организация задач по автоматизации. Имеет свою структуру в папке плейбука и позволяет отдельно выделять задачи для упрощения администрирования парка машин
Пример структуры
```
roles/
    common/               #  Папка с ролью
        tasks/            #
            main.yml      #  Фаил с задачей роли
        handlers/         #
            main.yml      #  Фаил с задачей handler (описано ниже)
        templates/        #  Папка с шаблонами
            nginx.conf.j2 #  Шаблон конфига nginx с синтаксисом jinja2 (описано ниже)
        files/            #
            bar.txt       #  Файлы для копирования на удаленную машину
            foo.sh        #  К примеру конфиги, скрипты или бинарные файлы
        vars/             #
            main.yml      #  Фаил с обьявлением переменных для этой роли
        defaults/         #
            main.yml      #  Переменные с более низким приоритетом для этой роли
        meta/             #
            main.yml      #  Зависимости для этой роли
        library/          #  Библиотеки для этой роли
        module_utils/     #  Модули для этой роли (module_utils)
                          # По аналогии корневая папка с ролями ниже
    somerole/             # С такой же структурой как и выше 
    role2/                # ""
    role3/                # ""
```

### Handlers
Задачи которые выполняются только если их вызвать директивой notify. К примеру есть некое условие (Перезапуск веб сервера), при котором произойдет некое действие (перезапуск сервиса nginx и mysql).
```yaml
tasks:
  - name: Restart WebServices
    command: echo "this task will restart the web services"
    notify: "restart web services"

handlers:
  - name: Restart mariadb
    service:
      name: mariadb
      state: restarted
    listen: "restart web services"

  - name: Restart nginx
    service:
      name: nginx
      state: restarted
    listen: "restart web services"
 ```
 
### Templates
Шаблоны которые заполняются из переменных. Например модуль который запрашивает множество переменных с каждой машины (Ansible Facts) может быть использован в шаблоне файла с расширением j2. К примеру в файле index.html можно после отработки скрипта автоматически изменить содержимое. Например подставим значение имени хоста:
```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>My Website</title>
    <link rel="stylesheet" href="./style.css">
    <link rel="icon" href="./favicon.ico" type="image/x-icon">
  </head>
  <body>
    <main>
        <h1>My name is {{ ansible_facts['hostname'] }}</h1>  
    </main>
  </body>
</html>
```
### Переменные
Переменные они и в Африке переменные. Можно задать самому, можно дергать Ansible Facts. Можно использовать сторонние модули. В случае использования роли, например, можно задавать переменные в vars/main.yaml в таком виде:
```yaml
---
root_dir: /var/www/html
web_dir: "{{ root_dir }}/web"
web_adminpanel_dir: "{{ root_dir }}/admin"
```
Затем в playbook передаем тот фаил с переменной:
```yaml
vars_files:
- "/path/to/var/file"
```

Так же можно напрямую в playbook обозначить директивой vars:
```yaml
vars: http-set-port: 80
```

Так же можно переменную передавать ad-hoc методом, например
```bash
ansible-playbook playbook.yaml -e "http-set-port=80"
```