docs: Обновление документации с новыми функциями

- Добавлена информация об интерактивном управлении ролями
- Обновлены разделы быстрого старта
- Добавлены примеры использования make role list/create/delete
- Обновлена документация по созданию ролей
- Добавлена информация о автоматическом обновлении playbook'ов
- Обновлен раздел результатов с новыми возможностями
This commit is contained in:
Сергей Антропов
2025-10-25 19:25:29 +03:00
parent 5c2b63848c
commit 4c804eeaf0
3 changed files with 90 additions and 6 deletions

View File

@@ -41,6 +41,9 @@ AnsibleTemplate - это универсальная система для тес
- **Автоматическое создание** тестовых окружений
- **Поддержка systemd** в контейнерах
- **DinD/DOoD** поддержка для Docker функциональности
- **Интерактивное управление ролями** - создание, удаление, просмотр ролей
- **Автоматическое обновление** playbook'ов при добавлении новых ролей
- **Комплексное тестирование** всех образов одновременно (all-images preset)
### 🔐 Безопасность и секреты
- **Ansible Vault** интеграция
@@ -147,7 +150,20 @@ make docker build
make docker info
```
### 3. Тестирование ролей
### 3. Управление ролями
```bash
# Просмотр всех ролей
make role list
# Создание новой роли (интерактивно)
make role create
# Удаление роли (интерактивно)
make role delete
```
### 4. Тестирование ролей
```bash
# Просмотр доступных preset'ов
@@ -464,6 +480,22 @@ make role deploy 2>&1 | tee deployment.log
## 🔧 Вспомогательные команды
### Управление ролями
```bash
# Просмотр всех ролей
make role list
# Создание новой роли (интерактивно)
make role create
# Удаление роли (интерактивно)
make role delete
# Проверка синтаксиса ролей
make role lint
```
### Docker команды
```bash
@@ -480,9 +512,6 @@ make docker update
### Другие команды
```bash
# Проверка синтаксиса ролей
make role lint
# Создание секретов
make vault create
@@ -2104,6 +2133,10 @@ MIT License - см. файл [LICENSE](LICENSE)
12.**Собственные Docker образы для различных ОС**
13.**Systemd поддержка в контейнерах**
14.**DinD/DOoD поддержка для Docker функциональности**
15.**Интерактивное управление ролями** - создание, удаление, просмотр ролей
16.**Автоматическое обновление playbook'ов** при добавлении новых ролей
17.**Комплексное тестирование всех образов** одновременно (all-images preset)
18.**Подробная документация по кастомизации deploy.yml** с примерами
## 📚 Навигация по документации

View File

@@ -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}

View File

@@ -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