Files
homelab-infrastructure-as-code/05-monitoring/CLAUDE.md
T
kasun 13549a8d37
Deploy k8s Infra / Pulumi Preview (push) Has been skipped
Deploy k8s Infra / Pulumi Deploy (push) Successful in 58s
Deploy k8s Apps / Pulumi Preview (push) Has been skipped
Deploy k8s Apps / Pulumi Deploy (push) Successful in 48s
Deploy Monitoring / Pulumi Preview (push) Has been skipped
Deploy Monitoring / Pulumi Deploy (push) Successful in 59s
docs: updated documentation to current progress
2026-06-11 22:36:20 +02:00

1.2 KiB

monitoring

This file provides guidance to Claude Code when working in 05-monitoring. See the repo-root CLAUDE.md for shared conventions, deployment order, and CI/CD.

Monitoring stack (Prometheus + Grafana) via the kube-prometheus-stack Helm chart. Reads kubeconfig from k8s-bootstrap and domain from k8s-apps, both via StackReference.

Common Commands

npm install
pulumi up --yes

Architecture

  • Namespace monitoring
  • kube-prometheus-stack Helm release (chart v86.2.0)
    • Grafana: ingress at grafana.<domain> (traefik, letsencrypt-prod), longhorn PVC (2Gi)
    • Prometheus: longhorn PVC (20Gi) via volumeClaimTemplate
    • Alertmanager disabled

Key Notes

  • The monitoring namespace and the Helm release both use the Pulumi import resource option (monitoring, monitoring/kube-prometheus-stack) — they were adopted from pre-existing cluster resources rather than created fresh. Be careful with renames or changes that would force a replace.

Required Pulumi config

pulumi config set --secret grafanaAdminPassword <password>

CI/CD

Workflow: ../.gitea/workflows/05-deploy-monitoring.yaml. Secret: MONITORING_PULUMI_DEV_YAML.