docs: Обновление документации с новыми функциями
- Добавлена информация об интерактивном управлении ролями - Обновлены разделы быстрого старта - Добавлены примеры использования make role list/create/delete - Обновлена документация по созданию ролей - Добавлена информация о автоматическом обновлении playbook'ов - Обновлен раздел результатов с новыми возможностями
This commit is contained in:
@@ -3,6 +3,29 @@
|
||||
**Автор:** Сергей Антропов
|
||||
**Сайт:** https://devops.org.ru
|
||||
|
||||
## 🚀 Быстрый старт
|
||||
|
||||
### Интерактивное управление ролями
|
||||
|
||||
```bash
|
||||
# Просмотр всех ролей
|
||||
make role list
|
||||
|
||||
# Создание новой роли (интерактивно)
|
||||
make role create
|
||||
|
||||
# Удаление роли (интерактивно)
|
||||
make role delete
|
||||
```
|
||||
|
||||
### Автоматическое обновление
|
||||
|
||||
При создании или удалении роли система автоматически:
|
||||
- ✅ Обновляет `roles/deploy.yml`
|
||||
- ✅ Создает полную структуру папок
|
||||
- ✅ Генерирует README.md с документацией
|
||||
- ✅ Настраивает метаданные роли
|
||||
|
||||
## 📁 Структура роли
|
||||
|
||||
### Стандартная структура
|
||||
@@ -28,6 +51,21 @@ roles/my-role/
|
||||
|
||||
### Создание структуры
|
||||
|
||||
#### Автоматическое создание (рекомендуется)
|
||||
|
||||
```bash
|
||||
# Интерактивное создание роли
|
||||
make role create
|
||||
|
||||
# Система автоматически:
|
||||
# - Создаст структуру папок
|
||||
# - Создаст все необходимые файлы
|
||||
# - Обновит roles/deploy.yml
|
||||
# - Создаст README.md с документацией
|
||||
```
|
||||
|
||||
#### Ручное создание
|
||||
|
||||
```bash
|
||||
# Создание директории роли
|
||||
mkdir -p roles/my-role/{tasks,handlers,templates,files,vars,defaults,meta}
|
||||
|
||||
@@ -37,7 +37,20 @@ make docker info
|
||||
|
||||
## 🧪 Первое тестирование
|
||||
|
||||
### 1. Просмотр доступных preset'ов
|
||||
### 1. Управление ролями
|
||||
|
||||
```bash
|
||||
# Просмотр всех ролей
|
||||
make role list
|
||||
|
||||
# Создание новой роли (интерактивно)
|
||||
make role create
|
||||
|
||||
# Удаление роли (интерактивно)
|
||||
make role delete
|
||||
```
|
||||
|
||||
### 2. Просмотр доступных preset'ов
|
||||
|
||||
```bash
|
||||
# Список всех preset'ов
|
||||
@@ -47,7 +60,7 @@ make presets list
|
||||
make presets info PRESET=default
|
||||
```
|
||||
|
||||
### 2. Тестирование роли ping
|
||||
### 3. Тестирование роли ping
|
||||
|
||||
```bash
|
||||
# Тестирование с default preset
|
||||
|
||||
Reference in New Issue
Block a user