helm-common-chart

Library Helm chart providing reusable templates for Kubernetes workloads, services, autoscaling, and observability.

What this is

A library chart (type: library) — it is not installable standalone. Consume it as a dependency from your application chart and call its helpers and template definitions from your own templates.

Install

Releases are published as OCI artifacts on GitHub Container Registry. In your application chart's Chart.yaml, add:

dependencies:
  - name: common
    version: "^2.0.0"
    repository: "oci://ghcr.io/alexremn/charts"

Then:

helm dependency update

To pull the chart directly:

helm pull oci://ghcr.io/alexremn/charts/common --version 2.0.0

Quick start

Minimal values.yaml for a consumer chart that depends on common:

name: my-app
environment: dev

web:
  replicas: 2
  image:
    repository: ghcr.io/example/my-app
    tag: "1.0.0"
  ports:
    http: 8080

And in your chart's templates/all.yaml:

{{ include "chart.deployment" (dict "Values" .Values "Release" .Release "Chart" .Chart "cmp" "web") }}
---
{{ include "chart.service" (dict "Values" .Values "Release" .Release "Chart" .Chart "cmp" "web") }}

Each per-resource template is invoked the same way — pass a dict carrying the root Values/Release/Chart plus a cmp key naming the component subtree to render (here, web). Available entrypoints include chart.deployment, chart.statefulset, chart.daemonset, chart.job, chart.cronjob, chart.service, chart.service.headless, chart.ingress, chart.httproute, chart.networkpolicy, chart.configmap, chart.binaryconfigmap, chart.secret, chart.extsecret, chart.serviceaccount, chart.rbac, chart.hpa, chart.vpa, chart.scaledobject, chart.triggerauth, chart.pdb, chart.pvc, chart.podmonitor, chart.servicemonitor, chart.prometheusrule, chart.priorityclass.

See tests/smoke/templates/all.yaml for a complete consumer-side template wiring multiple resources, and examples/ for richer fixtures (HPA, VPA, NetworkPolicy, ServiceMonitor, profiles, etc.).

What's inside

Workloads: Deployment, StatefulSet, DaemonSet, Job, CronJob Networking: Service, Ingress, HTTPRoute (Gateway API), NetworkPolicy Scaling: HPA, VPA, KEDA ScaledObject + TriggerAuthentication, PodDisruptionBudget Observability: ServiceMonitor, PodMonitor, PrometheusRule Config & Secrets: ConfigMap, Secret, ExternalSecret RBAC: ServiceAccount, Role, RoleBinding Storage: PersistentVolumeClaim Misc: PriorityClass

Common helper library (templates/common/): workload composition, container building, pod spec, profile defaults, affinity/topology helpers, naming. See Public helpers for the consumer-facing common.* utility API.

Docs

• Values reference — top-level keys grouped by concern
• Examples — working values.*.yaml per feature
• Contributing — dev setup, tests, golden workflow
• values.schema.json — full JSON schema (validated by helm lint)

License

Apache-2.0. See LICENSE.