From a56de6183a8e162e18c8998ebc983f19e4d84100 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=A1=D0=B5=D1=80=D0=B3=D0=B5=D0=B9=20=D0=90=D0=BD=D1=82?=
 =?UTF-8?q?=D1=80=D0=BE=D0=BF=D0=BE=D0=B2?=
 <inecs@MacBook-Air-Sergej-3.local>
Date: Sun, 26 Oct 2025 12:44:20 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=BE=D0=B1=D0=BD=D0=BE=D0=B2=D0=BB?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=BE=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8?=
 =?UTF-8?q?=D0=B5=20=D0=BF=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D0=B0=20DevOpsLab?=
 =?UTF-8?q?=20=D1=81=20=D1=83=D1=87=D0=B5=D1=82=D0=BE=D0=BC=20K8s?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Расширено описание проекта - теперь это DevOps платформа
- Добавлены ключевые компоненты: Ansible, Docker, Kubernetes
- Структурированы возможности по категориям:
  * Ansible (автоматизация)
  * Docker (контейнеризация)
  * Kubernetes (оркестрация)
- Добавлен раздел быстрого старта для K8s
- Расширен раздел Kubernetes с:
  * Основными командами
  * Доступными аддонами
  * Путями доступа к сервисам
---
 README.md | 93 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 88 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 979f522..333b95b 100644
--- a/README.md
+++ b/README.md
@@ -6,18 +6,36 @@
 
 ## 📋 Описание
 
-DevOpsLab - это универсальная система для разработки, тестирования и развертывания Ansible ролей с использованием Docker, Molecule и preset конфигураций. Система поддерживает тестирование на различных ОС через Docker контейнеры.
+DevOpsLab - это универсальная DevOps платформа для разработки, тестирования и развертывания инфраструктуры. Система объединяет Ansible роли, Docker контейнеры и Kubernetes кластеры в единую среду для автоматизации и управления инфраструктурой.
+
+**Ключевые компоненты:**
+- **Ansible** - автоматизация конфигурации и развертывания
+- **Docker** - контейнеризация для изоляции и переносимости
+- **Molecule** - тестирование Ansible ролей
+- **Kubernetes (Kind)** - локальные K8s кластеры для разработки
+- **Multi-arch поддержка** - сборка для amd64 и arm64 архитектур
 
 ## ✨ Ключевые возможности
 
+### 🔧 Ansible
 - **Тестирование ролей** через Molecule с Docker
 - **Preset система** для быстрого выбора окружений тестирования
 - **Мультиплатформенное тестирование** (Ubuntu, Debian, CentOS, AlmaLinux, RHEL и другие)
 - **Автоматическая проверка** синтаксиса Ansible ролей
 - **Управление секретами** через Ansible Vault
-- **Готовые Docker образы** для разных ОС
-- **Kubernetes Kind кластеры** для тестирования в среде Kubernetes
-- **Автоматическая установка аддонов** (Istio, Prometheus, Grafana, Kiali и другие)
+
+### 🐳 Docker
+- **Готовые Docker образы** для разных ОС с поддержкой systemd
+- **Multi-arch сборка** (amd64, arm64)
+- **Автоматическая публикация** в Docker Hub
+- **Контейнеры для тестирования** Ansible ролей
+
+### ☸️ Kubernetes
+- **Kind кластеры** для локального тестирования
+- **Автоматическая установка аддонов** (Istio, Prometheus, Grafana, Kiali, Ingress, Metrics Server)
+- **Управление через Helm** и Kubernetes манифесты
+- **Port-forward** для доступа к сервисам
+- **Детальный мониторинг** состояния кластера
 
 ## 📁 Структура проекта
 
@@ -111,6 +129,27 @@ make role lint docker
 make role lint ping
 ```
 
+### 4. Работа с Kubernetes
+
+```bash
+# Создание Kind кластера с аддонами
+make k8s create kubernetes
+
+# Статус кластера (детальный отчет)
+make k8s status kubernetes
+
+# Создание port-forward для доступа к сервисам
+make k8s portforward create
+
+# Установка Helm чарта
+make k8s helm apply kubernetes nginx bitnami/nginx
+
+# Удаление кластера
+make k8s destroy kubernetes
+```
+
+**Подробная документация:** [docs/kubernetes-kind.md](docs/kubernetes-kind.md)
+
 ## 📚 Доступные роли
 
 ### Docker
@@ -505,7 +544,51 @@ make custom-images                # справка по собственным 
 
 ### Kubernetes
 
-- **[docs/kubernetes-kind.md](docs/kubernetes-kind.md)** - Документация по работе с Kind кластерами
+**Полная документация:** [docs/kubernetes-kind.md](docs/kubernetes-kind.md)
+
+DevOpsLab предоставляет полную поддержку локальных Kubernetes кластеров на базе Kind:
+
+#### Основные команды
+
+```bash
+# Создание кластера с аддонами
+make k8s create kubernetes
+
+# Детальный статус кластера
+make k8s status kubernetes
+
+# Управление port-forward
+make k8s portforward create
+make k8s portforward list
+make k8s portforward clear
+
+# Работа с Helm
+make k8s helm apply kubernetes nginx bitnami/nginx
+make k8s helm list kubernetes
+make k8s helm delete kubernetes nginx
+
+# Работа с манифестами
+make k8s manifest apply kubernetes https://example.com/app.yaml
+
+# Удаление кластера
+make k8s destroy kubernetes
+```
+
+#### Доступные аддоны
+
+- **Ingress NGINX** - маршрутизация трафика
+- **Metrics Server** - сбор метрик
+- **Istio** - Service Mesh
+- **Prometheus Stack** - мониторинг (Prometheus + Grafana)
+- **Kiali** - визуализация Service Mesh
+
+#### Доступ к сервисам
+
+- **Grafana**: http://localhost:3000 (admin/admin)
+- **Prometheus**: http://localhost:9090
+- **Kiali**: http://localhost:20001
+- **Ingress HTTP**: http://localhost:8081
+- **Ingress HTTPS**: https://localhost:8443
 
 ## 🐳 Docker образы