helm-charts

Logic's Kubernetes Helm Charts

Artifact Hub License Release Charts

A collection of opinionated Helm charts for Kubernetes application deployment, built around a shared common library chart and routed through Istio. Infrastructure reference configs (ArgoCD, Istio, observability) live alongside the charts in this repository.

Usage

Helm must be installed to use the charts. Please refer to Helm's documentation to get started.

Once Helm is set up properly, add the repository as follows:

helm repo add logic3579 https://logic3579.github.io/helm-charts
helm repo update

You can then run helm search repo logic3579 to see the charts.

Install a chart:

# Kafka UI
helm install my-kafka-ui logic3579/kafka-ui -f my-values.yaml

# Nightingale (n9e) monitoring system
helm install my-nightingale logic3579/nightingale -f my-values.yaml

Or install directly from an OCI registry — every release is mirrored to GHCR, Docker Hub, and Quay:

# GHCR (primary mirror)
helm install my-kafka-ui oci://ghcr.io/logic3579/helm-charts/kafka-ui --version 0.1.1

# Docker Hub
helm install my-kafka-ui oci://registry-1.docker.io/logic3579/kafka-ui --version 0.1.1

# Quay
helm install my-kafka-ui oci://quay.io/logic3579/kafka-ui --version 0.1.1

Uninstall a chart:

helm uninstall my-kafka-ui

Available Charts

Chart Description Default Port
common Shared library chart (labels, VirtualService, PDB, HPA, ServiceAccount)
kafka-ui Kafka UI dashboard with multi-cluster, schema-registry, and ksqlDB support 8080
nightingale Nightingale (n9e) cloud-native monitoring system — repackaged from flashcatcloud/n9e-helm 80

Infrastructure References

Cluster configuration examples (not published as charts) live under infrastructure/:

Path Description
argocd/ Multi-cluster GitOps with multi-source ApplicationSets and per-env overrides
istio/ Gateway and AuthorizationPolicy configs
observability/grafana-lgtm/ Grafana LGTM stack (Loki + Grafana + Tempo + Mimir) with Alloy/Promtail
observability/victoriametrics/ VictoriaMetrics stack (VMCluster + VictoriaLogs + VictoriaTraces) with vmauth
observability/prometheus-community/ Minimal single-node Prometheus server (alternative to Mimir / VMCluster)
observability/opentelemetry/ OTel Operator + agent/gateway Collectors + auto-injecting Instrumentation CR
observability/nightingale/ Nightingale (n9e) + Categraf with curated dashboards and alert rules

Local Development

Resolve the common library dependency before linting or templating:

# Resolve common library dependency
helm dependency update charts/kafka-ui

# Lint (application charts only — common is a library and not linted standalone)
helm lint charts/kafka-ui

# Inspect rendered manifests
helm template my-release charts/kafka-ui -f charts/kafka-ui/values.yaml

Releasing a New Version

Publishing is fully automated via GitHub Actions. To release a new version:

  1. Modify chart source under charts/
  2. Bump version in Chart.yaml — this is the release trigger
  3. Commit and push to main

The workflow lints, packages, and publishes the new .tgz to the gh-pages branch alongside a regenerated index.yaml. The repo retains the latest 3 versions per chart. No Git tags, no GitHub Releases.

Contributing

The source code for all charts and infrastructure references lives on GitHub: https://github.com/logic3579/helm-charts. Issues and pull requests are welcome.

License

Apache 2.0 License.

Build Status

Release Charts