helm-charts

Helm Charts Repository

This repository contains Helm charts for deploying applications to Kubernetes. Helm is a package manager for Kubernetes that simplifies the deployment and management of applications.

What is Helm?

Helm is the package manager for Kubernetes. It helps you:

Package applications: Bundle Kubernetes resources into reusable charts
Manage dependencies: Handle complex application dependencies
Version management: Track and manage different versions of your applications
Simplify deployments: Deploy complex applications with a single command
Configuration management: Customize deployments using values files

Key Concepts

Chart: A collection of files that describe a related set of Kubernetes resources
Release: An instance of a chart running in a Kubernetes cluster
Repository: A location where packaged charts are stored and shared
Values: Configuration parameters that customize chart deployments

Prerequisites

Before using Helm, ensure you have:

Kubernetes cluster (1.19+)
kubectl configured to access your cluster
Helm 3.0+ installed

Installing Helm

macOS

brew install helm

Linux

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Windows

choco install kubernetes-helm

Verify Installation

helm version

Repository Setup

Add This Repository

helm repo add novacaap https://novacaap.github.io/helm-chart
helm repo update

List Available Charts

helm search repo novacaap

Available Charts

This repository contains the following Helm charts:

acute: A flexible Helm chart supporting Deployments, StatefulSets, Jobs, and CronJobs with extensive configuration options

For detailed documentation on each chart, see their respective README files in the chart directories.

Essential Helm Commands

Repository Commands

Add a Repository

helm repo add <repo-name> <repo-url>

Example:

helm repo add novacaap https://novacaap.github.io/helm-chart

List Repositories

helm repo list

Update Repository Index

helm repo update

Remove a Repository

helm repo remove <repo-name>

Search Charts

# Search in all repositories
helm search repo <keyword>

# Search in a specific repository
helm search repo <repo-name>/<chart-name>

Installation Commands

Install a Chart

helm install <release-name> <repo-name>/<chart-name>

Example:

helm install my-app novacaap/acute

Install with Custom Values

helm install <release-name> <repo-name>/<chart-name> -f values.yaml

Install with Inline Values

helm install <release-name> <repo-name>/<chart-name> \
  --set key1=value1 \
  --set key2=value2

Install to Specific Namespace

helm install <release-name> <repo-name>/<chart-name> -n <namespace> --create-namespace

Install with Dry Run (Preview)

helm install <release-name> <repo-name>/<chart-name> --dry-run --debug

Upgrade Commands

Upgrade a Release

helm upgrade <release-name> <repo-name>/<chart-name>

Upgrade with Values File

helm upgrade <release-name> <repo-name>/<chart-name> -f values.yaml

Upgrade with Rollback on Failure

helm upgrade <release-name> <repo-name>/<chart-name> --atomic

Upgrade with Timeout

helm upgrade <release-name> <repo-name>/<chart-name> --timeout 5m

List and Status Commands

List All Releases

helm list

List Releases in Namespace

helm list -n <namespace>

List All Releases (Including Deleted)

helm list --all

Show Release Status

helm status <release-name>

Show Release History

helm history <release-name>

Uninstall Commands

Uninstall a Release

helm uninstall <release-name>

Uninstall with Keep History

helm uninstall <release-name> --keep-history

Rollback Commands

Rollback to Previous Version

helm rollback <release-name>

Rollback to Specific Revision

helm rollback <release-name> <revision-number>

Template and Debug Commands

Render Templates Locally

helm template <release-name> <repo-name>/<chart-name>

Render with Values

helm template <release-name> <repo-name>/<chart-name> -f values.yaml

Validate Chart

helm lint <chart-path>

Show Chart Values

helm show values <repo-name>/<chart-name>

Show Chart Information

helm show chart <repo-name>/<chart-name>

Show All Chart Information

helm show all <repo-name>/<chart-name>

Package Commands

Package a Chart

helm package <chart-path>

Package with Version

helm package <chart-path> --version 1.0.0

Create Index File

helm repo index <directory>

Common Workflows

Basic Deployment Workflow

Add the repository

helm repo add novacaap https://novacaap.github.io/helm-chart
helm repo update

Search for charts
```
helm search repo novacaap
```
View chart values
```
helm show values novacaap/acute
```

Create custom values file

helm show values novacaap/acute > my-values.yaml
# Edit my-values.yaml with your configuration

Install the chart

helm install my-release novacaap/acute -f my-values.yaml

Check status

helm status my-release
kubectl get pods

Upgrade when needed

helm upgrade my-release novacaap/acute -f my-values.yaml

Rollback if needed
```
helm rollback my-release
```

Development Workflow

Clone and modify chart locally

git clone https://github.com/novacaap/helm-charts.git
cd helm-chart/acute
# Make your changes

Lint the chart
```
helm lint .
```

Test with dry-run

helm install test-release . --dry-run --debug

Package the chart
```
helm package .
```

Test installation

helm install test-release ./acute-1.0.0.tgz

Values Files

Values files allow you to customize chart deployments. You can:

Use default values from the chart
Override with -f values.yaml
Override with --set key=value
Combine multiple values files: -f values1.yaml -f values2.yaml
Use --set-file for file contents: --set-file config=config.yaml

Values Precedence

--set command line arguments (highest priority)
-f or --values files
Chart’s values.yaml (lowest priority)

Best Practices

Always use values files for production deployments
Version your values files in version control
Use namespaces to organize releases
Test with dry-run before actual deployment
Keep release names descriptive and consistent
Use --atomic flag for critical upgrades
Monitor releases with helm status and kubectl
Document custom values for team knowledge sharing

Troubleshooting

Check Release Status

helm status <release-name>

View Release Manifest

helm get manifest <release-name>

View Release Values

helm get values <release-name>

View All Release Information

helm get all <release-name>

Debug Template Rendering

helm template <release-name> <chart> --debug

Check Kubernetes Resources

kubectl get all -l app.kubernetes.io/instance=<release-name>

View Pod Logs

kubectl logs -l app.kubernetes.io/instance=<release-name>

Describe Resources

kubectl describe pod -l app.kubernetes.io/instance=<release-name>

Useful Tips

Use helm list -A to see releases across all namespaces
Use helm uninstall --dry-run to preview what will be deleted
Use helm diff plugin to see changes before upgrading
Use helm test to run test hooks after installation
Use helm dependency update when charts have dependencies

Additional Resources

Repository Information

Repository URL: https://github.com/novacaap/helm-charts
Helm Repository: https://novacaap.github.io/helm-chart
Issues: https://github.com/novacaap/helm-charts/issues

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

See individual chart directories for license information.

This site is open source. Improve this page.