- Переписан главный 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 с новыми командами автоматизации - Улучшена навигация по документации
67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# Быстрый старт - Роль 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
|
||
=========================================
|
||
```
|