Ansible

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:

[web]
192.168.1.50
192.168.1.51
web-server.ru

[db]
192.168.1.51
db-server.local

Он же но в формате 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

- 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).

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 можно после отработки скрипта автоматически изменить содержимое. Например подставим значение имени хоста:

<!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 в таком виде:

---
root_dir: /var/www/html
web_dir: "{{ root_dir }}/web"
web_adminpanel_dir: "{{ root_dir }}/admin"

Затем в playbook передаем тот фаил с переменной:

vars_files:
- "/path/to/var/file"

Так же можно напрямую в playbook обозначить директивой vars:

vars: http-set-port: 80

Так же можно переменную передавать ad-hoc методом, например

ansible-playbook playbook.yaml -e "http-set-port=80"