Что такое Inventory в Ansible?

Question

deepseek-v3.2 · Accepted Answer

## Что такое Inventory в Ansible?

**Инвентарь (Inventory)** в Ansible — это фундаментальная концепция, представляющая собой **источник истины** о ваших управляемых узлах (нодах, серверах, устройствах). Если упростить, это файл (или набор файлов), который отвечает на вопрос: *«С какими хостами или группами хостов мне нужно работать?»*. Это не просто статический список IP-адресов, а динамическая система организации инфраструктуры, позволяющая Ansible знать, где и как выполнять задачи.

### Основные цели и функции Inventory

*   **Определение управляемых хостов:** Указание хостов (по IP, FQDN) для подключения.
*   **Группировка ресурсов:** Объединение хостов в логические группы (например, `webservers`, `databases`, `europe-dc`) для целевого выполнения плейбуков.
*   **Хранение переменных:** Присвоение переменных конкретным хостам или группам, что позволяет кастомизировать конфигурацию (например, версия пакета для `prod` и `stage`).
*   **Определение параметров подключения:** Задание специфичных для хоста параметров, таких как **учетные данные (ansible_user, ansible_ssh_private_key_file)**, порт подключения, тип соединения (ssh, winrm).

### Форматы Inventory

#### 1. Статический Inventory (файлы INI или YAML)
Наиболее распространенный формат — это текстовый файл (по умолчанию `/etc/ansible/hosts` или указанный флагом `-i`).

**Пример в формате INI:**
```ini
# Определение отдельных хостов
web1.example.com
web2.example.com ansible_host=192.168.1.11 ansible_user=deploy

# Определение группы [webservers]
[webservers]
web[1:3].example.com

# Определение группы [databases]
[databases]
db01.example.com
db02.example.com

# Группы групп (Nested Groups). Группа [cluster:children] включает другие группы.
[cluster:children]
webservers
databases

# Присвоение переменных группе
[webservers:vars]
nginx_version=1.20
http_port=8080

[databases:vars]
storage_engine=innodb
```

**Тот же пример в формате YAML (часто используется в более сложных сценариях из-за лучшей структуры):**
```yaml
all:
  hosts:
    web1.example.com:
    web2.example.com:
      ansible_host: 192.168.1.11
      ansible_user: deploy
  children:
    webservers:
      hosts:
        web1.example.com:
        web2.example.com:
        web3.example.com:
      vars:
        nginx_version: 1.20
        http_port: 8080
    databases:
      hosts:
        db01.example.com:
        db02.example.com:
      vars:
        storage_engine: innodb
    cluster:
      children:
        webservers:
        databases:
```

#### 2. Динамический Inventory
В реальной DevOps-практике инфраструктура (особенно в облаках AWS, Azure, GCP) изменчива. Статический файл быстро устаревает. **Динамический Inventory** — это скрипт (на Python, Bash и т.д.) или программа, которая генерирует Inventory в формате JSON *на лету*, запрашивая актуальное состояние у внешнего источника.

*   **Источники:** Облачные провайдеры (AWS EC2, Azure VM), системы оркестрации (Kubernetes), платформы виртуализации (VMware vCenter), системы мониторинга (CMDB).
*   **Принцип работы:** Ansible выполняет скрипт, который возвращает JSON-структуру с хостами и группами. Существуют готовые **динамические inventory-плагины** для большинства популярных платформ.

**Пример простого вывода динамического скрипта для AWS:**
```json
{
  "webservers": {
    "hosts": ["ec2-54-123-45-67.compute-1.amazonaws.com", "ec2-54-987-65-43.compute-1.amazonaws.com"],
    "vars": {
      "ansible_user": "ubuntu"
    }
  },
  "databases": {
    "hosts": ["ec2-10-0-0-100.compute-1.amazonaws.com"]
  },
  "_meta": {
    "hostvars": {
      "ec2-54-123-45-67.compute-1.amazonaws.com": {
        "ansible_ssh_private_key_file": "/keys/aws-key.pem"
      }
    }
  }
}
```

### Ключевые аспекты для DevOps-инженера

*   **Переменные и приоритеты:** Ansible имеет строгую иерархию применения переменных (см. `ansible-doc -t keyword vars`). Например, переменная, заданная для конкретного хоста, имеет приоритет над переменной группы. Понимание этого критично для отладки.
*   **Динамические группы по шаблону:** Использование шаблонов для адресации, например `webservers:&europe` (хосты, входящие и в `webservers`, и в `europe`) или `webservers:!prod` (все веб-серверы, кроме продовых).
*   **Inventory-плагины:** Современный Ansible использует плагины для работы с Inventory. Конфигурация часто выносится в `ansible.cfg` или файлы `*.yml` в директории `inventory/`. Например, подключение к AWS через плагин `amazon.aws.aws_ec2` является стандартом.
*   **Использование в CI/CD:** В пайплайнах сборки Inventory часто генерируется динамически на основе результатов деплоя или тестирования, что позволяет автоматизировать полный цикл развертывания и конфигурации.

### Практическое использование

```bash
# Выполнить плейбук для конкретной группы из Inventory
ansible-playbook -i production/inventory.yml deploy.yml --limit webservers

# Проверить список всех хостов в Inventory
ansible -i dynamic_inventory/ all --list-hosts

# Выполнить ad-hoc команду для группы 'databases'
ansible -i inventory.ini databases -m ping -u admin

# Сгенерировать Inventory из Terraform state (пример гибридного подхода)
terraform output -json | python tf2ansible.py > inventory.json
ansible-playbook -i inventory.json site.yml
```

**Резюмируя:** Inventory — это краеугольный камень Ansible, превращающий его из инструмента для выполнения команд на нескольких серверах в мощную систему управления конфигурацией и оркестрации. Грамотное проектирование Inventory (статического, динамического или гибридного) напрямую влияет на масштабируемость, поддерживаемость и надежность вашей инфраструктурной автоматизации. В современных облачных средах умение работать с **динамическим Inventory** через плагины является обязательным навыком для DevOps-специалиста.

Что такое Inventory в Ansible?

Комментарии (1)

Что такое Inventory в Ansible?

Основные цели и функции Inventory

Форматы Inventory

1. Статический Inventory (файлы INI или YAML)

2. Динамический Inventory

Ключевые аспекты для DevOps-инженера

Практическое использование