shepherdjerred/monorepo/helm-helper

# Search Artifact Hub (public charts)
helm search hub nginx
 
# Search local repositories
helm search repo bitnami/nginx
 
# Show all versions
helm search repo bitnami/nginx --versions
 
# Search with version constraints
helm search repo bitnami/nginx --version "^10.0.0"

# Basic install
helm install my-release bitnami/nginx
 
# Install with custom values file
helm install my-release bitnami/nginx -f values.yaml
 
# Install with inline values
helm install my-release bitnami/nginx --set replicaCount=3
 
# Install to specific namespace (create if missing)
helm install my-release bitnami/nginx -n production --create-namespace
 
# Dry run with server-side validation
helm install my-release bitnami/nginx --dry-run=server
 
# Install with wait and timeout
helm install my-release bitnami/nginx --wait --timeout 5m
 
# Atomic install (rollback on failure)
helm install my-release bitnami/nginx --atomic
 
# Install from OCI registry
helm install my-release oci://registry.example.com/charts/nginx --version 1.0.0

# Upgrade existing release
helm upgrade my-release bitnami/nginx -f values.yaml
 
# Install or upgrade (idempotent)
helm upgrade --install my-release bitnami/nginx
 
# Reuse previous values and add new ones
helm upgrade my-release bitnami/nginx --reuse-values --set image.tag=v2
 
# Reset to chart defaults
helm upgrade my-release bitnami/nginx --reset-values
 
# Rollback on upgrade failure
helm upgrade my-release bitnami/nginx --atomic
 
# Force replace resources
helm upgrade my-release bitnami/nginx --force

# View release history
helm history my-release
 
# Rollback to previous revision
helm rollback my-release
 
# Rollback to specific revision
helm rollback my-release 3
 
# Uninstall release
helm uninstall my-release
 
# Uninstall but keep history
helm uninstall my-release --keep-history

# Add repository
helm repo add bitnami https://charts.bitnami.com/bitnami
 
# Update repository cache
helm repo update
 
# List repositories
helm repo list
 
# Remove repository
helm repo remove bitnami
 
# Add with credentials
helm repo add private https://charts.example.com --username user --password pass

# Create new chart
helm create mychart
 
# Validate chart
helm lint mychart
 
# Render templates locally
helm template my-release mychart
 
# Render specific template
helm template my-release mychart --show-only templates/deployment.yaml
 
# Package chart
helm package mychart
 
# Package with specific version
helm package mychart --version 1.0.0
 
# Update dependencies
helm dependency update mychart
 
# List dependencies
helm dependency list mychart

# Get all release info
helm get all my-release
 
# Get deployed values
helm get values my-release
 
# Get manifest (rendered templates)
helm get manifest my-release
 
# Get release notes
helm get notes my-release
 
# Get hooks
helm get hooks my-release
 
# Show chart info
helm show chart bitnami/nginx
 
# Show default values
helm show values bitnami/nginx
 
# Show README
helm show readme bitnami/nginx

# 1. View available values
helm show values bitnami/nginx > default-values.yaml
 
# 2. Create custom values file
cat > my-values.yaml <<EOF
replicaCount: 3
service:
  type: LoadBalancer
resources:
  limits:
    cpu: 500m
    memory: 256Mi
EOF
 
# 3. Dry run to preview
helm install my-nginx bitnami/nginx -f my-values.yaml --dry-run=server
 
# 4. Install
helm install my-nginx bitnami/nginx -f my-values.yaml --atomic --wait

# 1. Check current status
helm status my-release
 
# 2. Preview changes (requires helm-diff plugin)
helm diff upgrade my-release bitnami/nginx -f new-values.yaml
 
# 3. Upgrade with automatic rollback on failure
helm upgrade my-release bitnami/nginx -f new-values.yaml --atomic --timeout 10m
 
# 4. If manual rollback needed
helm rollback my-release 0  # Previous revision

# Login to registry
helm registry login registry.example.com
 
# Push chart to OCI registry
helm push mychart-1.0.0.tgz oci://registry.example.com/charts
 
# Pull chart
helm pull oci://registry.example.com/charts/mychart --version 1.0.0
 
# Install from OCI
helm install my-release oci://registry.example.com/charts/mychart --version 1.0.0
 
# Logout
helm registry logout registry.example.com

# Access values
{{ .Values.replicaCount }}
 
# Release information
{{ .Release.Name }}
{{ .Release.Namespace }}
{{ .Release.IsUpgrade }}
 
# Chart metadata
{{ .Chart.Name }}
{{ .Chart.Version }}
 
# Common functions
{{ .Values.name | quote }}
{{ .Values.name | upper }}
{{ default "nginx" .Values.image.name }}
{{ required "image.tag is required" .Values.image.tag }}
 
# Conditionals
{{- if .Values.ingress.enabled }}
# ingress config here
{{- end }}
 
# Loops
{{- range .Values.hosts }}
- {{ . | quote }}
{{- end }}

apiVersion: v2
name: mychart
version: 1.0.0
appVersion: "1.16.0"
description: My Helm chart
type: application # or "library"
keywords:
  - nginx
  - web
dependencies:
  - name: postgresql
    version: "12.x.x"
    repository: https://charts.bitnami.com/bitnami
    condition: postgresql.enabled

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": ["replicaCount"],
  "properties": {
    "replicaCount": {
      "type": "integer",
      "minimum": 1
    },
    "image": {
      "type": "object",
      "properties": {
        "repository": { "type": "string" },
        "tag": { "type": "string" }
      }
    }
  }
}

apiVersion: batch/v1
kind: Job
metadata:
  name: {{ .Release.Name }}-db-migrate
  annotations:
    "helm.sh/hook": pre-upgrade,pre-install
    "helm.sh/hook-weight": "-5"
    "helm.sh/hook-delete-policy": hook-succeeded
spec:
  template:
    spec:
      containers:
      - name: migrate
        image: migrate:latest
        command: ["./migrate.sh"]
      restartPolicy: Never

# Check release status
helm status my-release
 
# Get detailed info
helm get all my-release
 
# Check events
kubectl get events --sort-by='.lastTimestamp'
 
# View rendered templates
helm get manifest my-release

# List all releases including pending
helm list --all
 
# Check for stuck releases
helm list --pending
 
# Force rollback
helm rollback my-release 0 --force

# List hooks
helm get hooks my-release
 
# Check hook job status
kubectl get jobs -l app.kubernetes.io/managed-by=Helm
 
# View hook logs
kubectl logs job/my-release-pre-upgrade

# Debug template rendering
helm template my-release mychart --debug
 
# Validate with lint
helm lint mychart --strict
 
# Test with specific values
helm template my-release mychart -f values.yaml --validate

#!/bin/bash
set -e
 
RELEASE="my-app"
CHART="./charts/my-app"
NAMESPACE="production"
VALUES="values-prod.yaml"
 
# Lint chart
helm lint "$CHART" -f "$VALUES" --strict
 
# Dry run
helm upgrade --install "$RELEASE" "$CHART" \
  -n "$NAMESPACE" \
  -f "$VALUES" \
  --dry-run=server
 
# Deploy with atomic
helm upgrade --install "$RELEASE" "$CHART" \
  -n "$NAMESPACE" \
  -f "$VALUES" \
  --atomic \
  --timeout 10m \
  --wait
 
# Verify
helm status "$RELEASE" -n "$NAMESPACE"
kubectl get pods -n "$NAMESPACE" -l app.kubernetes.io/instance="$RELEASE"

# Base values.yaml
replicaCount: 1
image:
  repository: nginx
  tag: "1.25"
 
# values-prod.yaml (overrides)
replicaCount: 3
resources:
  limits:
    cpu: 1
    memory: 512Mi
 
# Deploy to production
helm upgrade --install my-app ./chart \
  -f values.yaml \
  -f values-prod.yaml \
  -n production

# umbrella/Chart.yaml
apiVersion: v2
name: my-platform
version: 1.0.0
dependencies:
  - name: frontend
    version: "1.x.x"
    repository: "file://../frontend"
  - name: backend
    version: "1.x.x"
    repository: "file://../backend"
  - name: postgresql
    version: "12.x.x"
    repository: https://charts.bitnami.com/bitnami

# Update dependencies
cd umbrella
helm dependency update
 
# Install entire platform
helm install my-platform . -f values.yaml