{% extends "base.html" %} {% block title %}Инструкция - AWM{% endblock %} {% block content %}

📖 Инструкция по использованию

Назад

🚀 Добро пожаловать в AWM

Централизованная система управления инфраструктурой через Ansible. Изучите возможности платформы и начните автоматизировать свои задачи.

📝

1. Плейбуки

Плейбуки - это YAML файлы, описывающие задачи для автоматизации инфраструктуры. Они содержат набор задач, которые Ansible выполняет на удаленных хостах.

  • Создание плейбука: Нажмите "Создать вручную" для создания с нуля или используйте "Конструктор" для создания плейбука из готового шаблона
  • Редактирование: Нажмите кнопку "Редактировать" рядом с плейбуком для внесения изменений
  • Удаление: Нажмите кнопку "Удалить" (будет запрошено подтверждение для безопасности)
📋

2. Инвентори

Инвентори - это файлы, содержащие список хостов для управления. Они определяют, на каких серверах будут выполняться ваши плейбуки.

  • Формат INI: Традиционный формат Ansible, простой и понятный
  • Формат YAML: Более структурированный формат с поддержкой вложенных групп
  • Создание: Используйте "Создать вручную" для полного контроля или "Конструктор" для быстрого создания

Пример INI инвентори:

[webservers] web1.example.com ansible_host=192.168.1.10 web2.example.com ansible_host=192.168.1.11 [webservers:vars] ansible_user=admin ansible_ssh_private_key_file=~/.ssh/id_rsa
▶️

3. Запуск плейбуков

Для запуска плейбука выполните следующие шаги:

  1. Нажмите "Запустить плейбук" на вкладке "Запуски"
  2. Выберите плейбук из выпадающего списка
  3. Выберите инвентори (опционально) - если не выбран, будет использован localhost
  4. Настройте дополнительные параметры:
    Check Mode Режим проверки (dry-run)
    Diff Mode Показывает различия
    Tags Запуск только задач с тегами
    Skip Tags Пропуск задач с тегами
    Limit Ограничение на хосты
  5. Нажмите "Запустить" и следите за выполнением в реальном времени
📄

4. Просмотр логов

После запуска плейбука вы можете отслеживать его выполнение:

  • Нажмите кнопку "Лог" рядом с запуском для просмотра полного вывода выполнения
  • Логи обновляются в реальном времени через WebSocket соединение
  • Статус запуска отображается цветным бейджем для быстрой визуальной оценки:
    ✓ Успешно ✗ Ошибка ⟳ Выполняется ⏳ Ожидание
🔄

5. Повтор запуска

Для повторного запуска плейбука с теми же параметрами:

  1. Найдите завершенный запуск (успешный или с ошибкой) в списке
  2. Нажмите кнопку "Повторить" рядом с запуском
  3. Будет создан новый запуск с теми же параметрами и сразу начнется выполнение
💡 Совет

Используйте функцию повтора для быстрого перезапуска после исправления ошибок или для повторного применения конфигурации.

🔧

6. Конструктор плейбуков

Конструктор позволяет создавать плейбуки из готовых шаблонов без необходимости писать YAML вручную:

  1. Выберите категорию шаблона (базовые операции, контейнеризация, Kubernetes, CI/CD и др.)
  2. Заполните необходимые параметры через удобный интерфейс
  3. Просмотрите сгенерированный YAML код перед сохранением
  4. Сохраните плейбук с уникальным именем
📊

7. Статистика

На главной странице в шапке отображается краткая статистика:

📝 Плейбуки Общее количество
📋 Инвентори Доступные инвентори
▶️ Запуски Всего выполнено

Подробную статистику с графиками, метриками успешности и анализом использования можно посмотреть на странице "Статистика".

💡

8. Советы и лучшие практики

💡 Рекомендации
  • Используйте описательные имена для плейбуков и инвентори (например: "deploy-web-app" вместо "playbook1")
  • Добавляйте описания для лучшей организации и понимания назначения
  • Перед выполнением на продакшене всегда используйте Check Mode для проверки изменений
  • Регулярно проверяйте логи для выявления проблем и оптимизации
  • Используйте теги для организации задач в плейбуках и выборочного выполнения
  • Храните инвентори в актуальном состоянии и регулярно обновляйте информацию о хостах
🆘

9. Поддержка и решение проблем

При возникновении проблем выполните следующие проверки:

⚠️ Чек-лист устранения неполадок
  • Проверьте логи выполнения - они содержат детальную информацию об ошибках
  • Убедитесь, что Ansible установлен и доступен в системе (команда ansible --version)
  • Проверьте правильность формата YAML в плейбуках (используйте валидатор YAML)
  • Убедитесь, что инвентори содержит корректные данные о хостах и доступности
  • Проверьте SSH подключение к хостам из инвентори
  • Убедитесь, что на целевых хостах установлен Python (требование Ansible)

🎉 Готовы начать?

Теперь вы знаете все основные возможности платформы. Начните с создания первого плейбука или выполнения команды на ваших хостах!

📝 К плейбукам Выполнить команду
{% endblock %} {% block scripts %} {% endblock %}