From fd8ef1c5c7c725d4874c22115bf1c6bf93aa697f Mon Sep 17 00:00:00 2001
From: Sergey Antropoff <inecs@MacBook-Air-Sergey.local>
Date: Mon, 27 Apr 2026 08:45:15 +0300
Subject: [PATCH] =?UTF-8?q?=D1=84=D0=B8=D0=BA=D1=81=20=D0=B4=D0=BE=D0=BA?=
 =?UTF-8?q?=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/addons.md          | 19 +++++++++++++++++++
 docs/getting-started.md | 26 ++++++++++++++++++++++----
 docs/make-reference.md  | 17 ++++++-----------
 3 files changed, 47 insertions(+), 15 deletions(-)

diff --git a/docs/addons.md b/docs/addons.md
index 7a358ff..df94002 100644
--- a/docs/addons.md
+++ b/docs/addons.md
@@ -18,6 +18,25 @@ make addon-jenkins
 make addon-netbird
 ```
 
+### Проверка аддонов перед деплоем
+
+```bash
+# Проверка конкретного аддона:
+make molecule-addon-argocd
+
+# Полный прогон всех addon-сценариев:
+make molecule-addon-all
+
+# Пройти дальше даже если часть аддонов падает:
+make -k molecule-addon-all
+```
+
+Практический цикл исправления:
+1. `make molecule-addon-all` — получить первый упавший аддон.
+2. Исправить сценарий/шаблон.
+3. Прогнать `make molecule-addon-<name>`.
+4. Снова `make molecule-addon-all`.
+
 ## Каталог аддонов
 
 | Аддон | Флаг | Описание | README |
diff --git a/docs/getting-started.md b/docs/getting-started.md
index f1c607a..8ba4592 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -114,9 +114,21 @@ make build   # ~3-5 минут
 ## Шаг 8 — Прогнать тесты (рекомендуется)
 
 ```bash
-make molecule-all   # ~15-20 минут
+# Быстрый минимум перед первым деплоем:
+make lint
+make molecule-k3s
+make molecule-cluster
+
+# Полный набор (дольше):
+make molecule-addon-all
 ```
 
+Рекомендуемый порядок:
+1. `make lint` — проверка синтаксиса плейбуков.
+2. `make molecule-k3s` — роль k3s.
+3. `make molecule-cluster` — топология 3 master + 2 worker.
+4. `make molecule-addon-all` — аддоны (останавливается на первой ошибке).
+
 ## Шаг 9 — Проверить SSH и dry-run
 
 ```bash
@@ -136,10 +148,13 @@ make install
 3. rpi01: K3S server (join) + taint NoSchedule
 4. CNI (если не Flannel)
 5. kube-vip: VIP + LoadBalancer
-6. NFS server + CSI NFS Driver → StorageClass `nfs-master01`
-7. ingress-nginx
 
-Ожидаемое время: **15-25 минут**.
+Ожидаемое время: **10-20 минут**.
+
+### Важно
+
+`make install` разворачивает только core-компоненты кластера.  
+Аддоны (`nfs-server`, `csi-nfs`, `ingress-nginx`, `cert-manager`, `prometheus-stack` и т.д.) ставятся отдельным шагом.
 
 ## Шаг 11 — Проверить результат
 
@@ -165,6 +180,9 @@ addon_gitea: true
 ```bash
 make install-addons          # все включённые аддоны
 make addon-prometheus-stack  # конкретный аддон
+make addon-ingress-nginx
+make addon-cert-manager
+make addon-nfs               # nfs-server + csi-nfs
 ```
 
 Полный каталог аддонов — [addons.md](addons.md).
diff --git a/docs/make-reference.md b/docs/make-reference.md
index ae71dd6..6ed3c50 100644
--- a/docs/make-reference.md
+++ b/docs/make-reference.md
@@ -23,17 +23,15 @@ make lint           # Проверить синтаксис плейбуков
 ## Установка кластера
 
 ```bash
-make install              # Полный базовый стек
-make install-k3s          # Только K3S HA кластер
-make install-cni          # CNI плагин
+make install              # Core: K3S + kube-vip + cert rotation
+make install-full         # Core + аддоны из group_vars/all/addons.yml
+make install-k3s          # Только K3S кластер
+make install-cni          # Только CNI плагин
 make install-cni K3S_CNI=calico    # Calico
 make install-cni K3S_CNI=cilium    # Cilium
 make install-kubevip      # Только kube-vip
-make install-nfs          # NFS сервер + CSI
-make install-ingress      # ingress-nginx
-make install-cert-manager # cert-manager + ClusterIssuer
-make install-istio        # Istio + Kiali
-make install-monitoring   # Prometheus + Grafana
+make install-addons       # Только аддоны из addons.yml
+make install-etcd         # Внешний etcd (если k3s_etcd_type=external)
 ```
 
 ## Аддоны
@@ -151,9 +149,6 @@ ANSIBLE_TAGS=k3s,kube_vip make install
 # Дополнительные переменные:
 EXTRA_VARS="k3s_version=v1.30.0+k3s1" make install-k3s
 EXTRA_VARS="prometheus_storage_size=20Gi" make addon-prometheus-stack
-
-# Лимитировать по хостам:
-ANSIBLE_LIMIT=master01 make install
 ```
 
 ## Теги деплоя