# Установка и настройка # Установка **На Debian-подобных системах:** ```bash apt-get install ansible ``` **Настройка управляемых хостов** На каждом хосте: 1. Если sudo нет, то ```bash apt install sudo ``` 2. Если создается новый пользователь, то ```bash sudo useradd -G sudo -s /bin/bash ansibleuser ``` 3. Если существующий пользователь, то добавить в группу sudo: ``` usermod -aG sudo sergey ``` 4. Разрешить пользователю повышать привилегии без ввода пароля. Создать файл ```bash sudo nano /etc/sudoers.d/ansibleuser ``` 5. И добавить текст ``` ansibleuser ALL=(ALL) NOPASSWD:ALL ``` Теперь можно использовать в скриптах become: true **Настройка сервера** ```bash ssh-keygen ssh-copy-id username@remote_host ``` 1. Создать ключ доступа 2. Скопировать на каждый управляемый хост, используя логин на хост. Удобнее, если для задач управления на всех хостах сделать одинаковый логин. В настройке каждого хоста нужно использовать соответствующий логин, для которого настроен ключ доступа. # Настройка ansible

**Приоритет поиска файла настроек**

1. ANSIBLE\_CONFIG (environment variable if set) 2. ansible.cfg (in the current directory) 3. ~/.ansible.cfg (in the home directory) 4. /etc/ansible/ansible.cfg (default)

**Генерация настроек**

```bash ansible-config init --disabled > ansible.cfg ```

С плагинами

```bash ansible-config init --disabled -t all > ansible.cfg ```

\# и ; комментарии. Но ; обычно используется для комментария значения по умолчанию.

**Файл инвентаризации**

hosts

Размещение файла может задаваться переменной окружения $ANSIBLE_HOSTS, либо ключ -i при запуске

После : пишется тип данных для группы. Например группа [example], [example:vars] это переменные

:vars переменные для группы

:children группы-потомки

**Пример**

```yaml [example] группа www.example.com сервер # Group 'multi' with all servers [multi:children] example #5 servers in one line [a:z] or [A:Z], or numbers with specific digits, such as [001:250]. [dyngroup] Node[0:4].lab.edu # Variables that will be applied to all servers [multi:vars] ansible_ssh_user=vagrant ```

**Файлы размещения переменных:**

Файлы с переменными групп хранятся в директории “group_vars/имя_группы”;

Файлы с переменными хостов в директории “hosts_vars/имя_хоста”;

Формат файла одинаковый, дочерние переменные заменяются на родительские.

```yaml --- ansible_user=setup ansible_private_ssh_key=/home/user/ansible.key ``` Может применяться и плоское определение, и вложенное, тогда в скрипте {{ db.user }}: ```yaml db: lll user: ppp ``` **Динамический реестр:** Должен поддерживать следующий интерфейс: \--host=hostname - реестр выдает список в JSON { "ansible\_ssh\_host": "127.0.0.1", "ansible\_ssh\_port": 2200, "ansible\_ssh\_user": "vagrant"} \--list реестр выдает список групп {"staging": \[ "ontaro.ехамрlе.сом", "quebec.ехаmple.сом"\], "vagrant": \[ "vagrant1", "vagrant2", "vagrantЗ"\]} "\_meta" : {"hostvars" : {"vagrant1" : {"ansible\_ssh\_host": "127.0.0.1", "ansible\_ssh\_port": 2222, "ansible\_ssh\_user": "vagrant"}, "vagrant2": {"ansible\_ssh\_host": "127.0.0.1", "ansible\_ssh\_port": 2200, "ansible\_ssh\_user": "vagrant"}}} Если создать папку inventory и добавить в ansible.cfg параметр hostfile = inventory то статический hosts и динамический будут объединены Если включить сбор фактов gather\_facts: True то можно во время выполнения задач группировать хосты (например debian/centos) Использование динамического реестра (в примере my\_dynamic\_inventory.py должен быть исполняемым скриптом) ```bash ansible-playbook -i my_dynamic_inventory.py my_playbook.yml ``` В Ссылках есть материал по динамическим реестрам

**Предустановленные переменные**

Переменная	Использование
ansible\_user	пользователь, от имени которого выполняются задачи на хостах данной группы. Значение в файле задач игнорируется.
ansible\_host	Сопоставление ip-имени
ansible\_port	Порт доступа по ssh
ansible\_connection	Может быть ssh, local, docker (запуск команд непосредственно на контейнере)
ansible\_become	+ sudo
ansible\_become\_user	sudo -> another user
ansible\_ssh\_private\_key\_file	адрес ключа

**Ссылки:**

[Описание основного config файла](https://docs.ansible.com/ansible/latest/reference_appendices/config.html)

[Динамический реестр](https://habr.com/ru/articles/704518/)