Что выполнит команда ansible inventory

Разбор команды ansible inventory

Команда ansible inventory - это утилита командной строки в Ansible, предназначенная для работы с инвентарями (inventory) - файлами или скриптами, которые определяют управляемые хосты (узлы) и группы хостов. Её основная цель - не выполнять задачи на хостах, а исследовать, проверять и отображать информацию о структуре инвентаря. Это критически важный инструмент для DevOps-инженера при отладке, аудите и понимании окружения.

Основные возможности и выполняемые действия

Команда ansible inventory в базовой форме (без дополнительных флагов) отобразит список всех хостов из указанного инвентаря, но её реальная сила раскрывается с использованием опций (флагов).

Вот ключевые сценарии использования и то, что команда выполнит в каждом случае:

1. Отображение структуры инвентаря (--graph, --list)

• ansible-inventory -i inventory.yml --graph выведет визуальное дерево групп и хостов в ASCII-формате. Это неоценимо для понимания иерархии.

  @all:
    |--@ungrouped:
    |--@webservers:
    |  |--web01.example.com
    |  |--web02.example.com
    |--@databases:
    |  |--db01.example.com
  

• ansible-inventory -i inventory.yml --list выведет полную структуру инвентаря в формате JSON. Это "сырые" данные, которые видит Ansible, включая все переменные (по умолчанию только хостовые и групповые переменные из самого инвентаря, без group_vars/ и host_vars/, если не указан флаг --export).

  {
      "_meta": {
          "hostvars": {}
      },
      "all": {
          "children": ["ungrouped", "webservers", "databases"]
      },
      "databases": {
          "hosts": ["db01.example.com"]
      },
      "webservers": {
          "hosts": ["web01.example.com", "web02.example.com"]
      }
  }
  

2. Отображение информации о конкретном хосте (--host)

• ansible-inventory -i inventory.yml --host web01.example.com покажет все переменные, примененные к указанному хосту из инвентаря (опять же, без переменных из group_vars//host_vars/ по умолчанию). Это быстрый способ проверить, с какими параметрами Ansible будет соединяться с хостом.

3. Экспорт с учетом всех источников переменных (--export, -v)

• Для получения полной картины, включая переменные из каталогов group_vars/, host_vars/, и других плагинов динамического инвентаря, используют комбинацию флагов.

  ansible-inventory -i inventory.yml --list --export
  

• Добавление флага -v (verbose) увеличит детализацию вывода, что полезно для отладки сложных инвентарей.

4. Проверка синтаксиса и валидация инвентаря

• Запуск команды с указанием файла инвентаря автоматически проверяет его базовую синтаксическую корректность. Если в инвентаре есть ошибки (неправильный YAML, несуществующие группы-родители и т.д.), команда завершится с ошибкой, указав на проблему. Это простой способ валидации перед запуском плейбуков.

5. Использование с динамическими инвентарями

• Команда универсальна и работает с любым источником инвентаря: статическими файлами (YAML, INI), скриптами (исполняемыми файлами, возвращающими JSON) или плагинами (например, aws_ec2, vmware).

  # Для статического файла
  ansible-inventory -i production.ini --graph
  
  # Для динамического инвентаря (скрипт)
  ansible-inventory -i ./my_cloud_inventory.py --list
  
  # Для плагина (например, AWS EC2, используя конфигурацию из ansible.cfg)
  ansible-inventory -i aws_ec2.yml --graph
  

• Это позволяет "заглянуть" в динамически сгенерированный инвентарь без реального выполнения задач, что экономит время и ресурсы.

Практический пример для DevOps-инженера

Представьте, что вы только присоединились к проекту и хотите понять окружение. Выполнив несколько команд, вы быстро получите полную картину:

# 1. Смотрим общую структуру групп
ansible-inventory -i environments/prod/ --graph

# 2. Получаем детальный список всех хостов и их переменных из всех источников
ansible-inventory -i environments/prod/ --list --export > full_inventory_dump.json

# 3. Проверяем конкретные параметры для критичного хоста базы данных
ansible-inventory -i environments/prod/ --host db-primary-01

Итог: Команда ansible inventory (ansible-inventory) — это диагностический и исследовательский инструмент. Она не выполняет плейбуки, не копирует файлы и не перезапускает службы. Её задача — дать инженеру максимально полное и понятное представление о том, с чем именно Ansible собирается работать: какие хосты, к каким группам относятся и какие переменные им назначены. Это первый шаг при отладке проблем, аудите безопасности (проверка переменных с паролями) и документировании инфраструктуры.