Files
DevOpsLab/roles/ping/QUICKSTART.md
Сергей Антропов 94560ffaaa feat: Полная переработка документации и структуры проекта
- Переписан главный README.md с подробной навигацией
- Создана структурированная документация в docs/:
  - getting-started.md - быстрый старт
  - creating-roles.md - создание ролей
  - cicd-setup.md - настройка CI/CD
  - monitoring.md - мониторинг и диагностика
  - site-yml-guide.md - руководство по site.yml
  - molecule-guide.md - подробное руководство по Molecule
- Переписан dockerfiles/README.md с детальным описанием всех образов
- Перенесен deploy.yml из корня в roles/ для лучшей организации
- Обновлен site.yml для импорта roles/deploy.yml
- Добавлены fallback значения в create.yml для надежности
- Созданы скрипты автоматизации:
  - update-playbooks.sh - обновление playbook'ов
  - generate-role-docs.sh - генерация документации
  - setup-cicd.sh - настройка CI/CD
- Добавлен env.example с примерами переменных
- Обновлен Makefile с новыми командами автоматизации
- Улучшена навигация по документации
2025-10-25 18:11:36 +03:00

67 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Быстрый старт - Роль Ping
## Что делает роль?
Роль выполняет ping yandex.ru из 5 пакетов и выводит результат.
## Основные задачи роли:
1. **Выполнение ping** - отправляет 5 пакетов на yandex.ru
2. **Вывод результата** - показывает строки результата ping
3. **Статистика** - выводит статус и время выполнения
4. **Дополнительная информация** - выводит полный вывод команды
## Как использовать:
### Вариант 1: Использование в roles/deploy.yml (уже добавлено)
```bash
# Запуск только роли ping
make role test minimal ping
# Запуск всех ролей
make role test minimal
```
### Вариант 2: Использование через roles/ping/playbook.yml
```bash
# Запуск напрямую
ansible-playbook -i inventory/hosts.ini roles/ping/playbook.yml
```
### Вариант 3: Использование с кастомными параметрами
```yaml
- name: Тест ping
hosts: all
roles:
- role: ping
vars:
ping_host: google.com
ping_count: 10
```
## Переменные:
- `ping_host` - хост для ping (по умолчанию: yandex.ru)
- `ping_count` - количество пакетов (по умолчанию: 5)
## Теги:
- `ping` - выполнение всех задач
- `test` - тестирование
- `debug` - отладочная информация
- `stats` - статистика
## Пример вывода:
```
=========================================
Результат ping yandex.ru
=========================================
Статус: УСПЕШНО
Время выполнения: 4.234
=========================================
```