фикс документации

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 |

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).

docs/make-reference.md

@@ -23,17 +23,15 @@ make lint           # Проверить синтаксис плейбуков
 ## Установка кластера
 
 ```bash
-make install              # Полный базовый стек
+make install              # Core: K3S + kube-vip + cert rotation
-make install-k3s          # Только K3S HA кластер
+make install-full         # Core + аддоны из group_vars/all/addons.yml
-make install-cni          # CNI плагин
+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-addons       # Только аддоны из addons.yml
-make install-ingress      # ingress-nginx
+make install-etcd         # Внешний etcd (если k3s_etcd_type=external)
-make install-cert-manager # cert-manager + ClusterIssuer
-make install-istio        # Istio + Kiali
-make install-monitoring   # Prometheus + Grafana
 ```
 
 ## Аддоны
@@ -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
 ```
 
 ## Теги деплоя