From 32a7c04deb718673eadcdad08df66b09cd99590e Mon Sep 17 00:00:00 2001 From: Viktor Barzin Date: Mon, 16 Feb 2026 19:45:31 +0000 Subject: [PATCH] [ci skip] Remember to use cluster_healthcheck.sh for cluster status checks --- .claude/CLAUDE.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 1200cb0e..ea20350a 100755 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -157,6 +157,12 @@ When configuring services to use the mailserver: ## Useful Commands ```bash +# Cluster health check — ALWAYS use this to check cluster status +bash scripts/cluster_healthcheck.sh # Full color report +bash scripts/cluster_healthcheck.sh --quiet # Only WARN/FAIL +bash scripts/cluster_healthcheck.sh --json # Machine-readable +bash scripts/cluster_healthcheck.sh --fix # Auto-delete evicted pods + # ALWAYS use -target for terraform apply (speeds up execution) terraform apply -target=module.kubernetes_cluster.module. terraform plan -target=module.kubernetes_cluster.module. @@ -164,6 +170,11 @@ terraform fmt -recursive kubectl get pods -A ``` +**Cluster Health Check** (`scripts/cluster_healthcheck.sh`): +- **ALWAYS use this script** when the user asks about cluster status, health, or "what's broken" +- Runs 14 checks: nodes, resources, conditions, pods, evicted, DaemonSets, deployments, PVCs, HPAs, CronJobs, CrowdSec, ingress, Prometheus alerts, Uptime Kuma +- **When adding new healthchecks or monitoring**: Always update this script to validate the new component + **Terraform target examples:** - `terraform apply -target=module.kubernetes_cluster.module.monitoring` - Apply monitoring - `terraform apply -target=module.kubernetes_cluster.module.immich` - Apply immich