Helm Commands Cheat Sheet

Introduction

Helm is a Kubernetes package manager for deploying helm charts (collections of pre-configured Kubernetes application resources). It features all the necessary commands for simpler management of apps in a Kubernetes cluster.

This tutorial covers all important Helm operations and provides examples to help you understand its syntax and features.

Helm Cheat Sheet

Prerequisites

Note: This tutorial covers Helm 3 commands. Aside from the command syntax, Helm 3 is also architecturally different from Helm 2. The most significant distinction is that Helm 3 improves security by eliminating Tiller, the server-side component present in Helm 2.

Basic Helm Concepts

Helm commands work with several Helm-related concepts. Understanding them makes the syntax easier to follow.

  • The most important Helm concept is a chart. A chart is a set of Kubernetes yaml manifests packaged together for easy manipulation. Helm charts make it possible to deploy a containerized application using a single command.
  • Charts are grouped in online collections called repositories. Each repository has a name and URL, making the charts easy to locate, download, and install.
  • Helm Hub is an online collection of distributed repositories available on the internet. It works as an information center, where you can find apps and their repository addresses. As of today, it is not possible to install an app directly from Helm Hub.
  • A release is a single instance of a chart deployed in a Kubernetes cluster.

List of Helm Commands

Use the commands listed below as a quick reference when working with Helm inside Kubernetes.

Install and Uninstall Apps

The main function of Helm is Kubernetes app management. Besides the basic operations of installing and uninstalling apps, Helm enables you to perform test installations and customize the installation process.

Install an app:

helm install [app-name] [chart]

Install an app in a specific namespace:

helm install [app-name] [chart] --namespace [namespace]

Override the default values with those specified in a file of your choice:

helm install [app-name] [chart] --values [yaml-file/url]

Run a test installation to validate and verify the chart:

helm install [app-name] --dry-run --debug

Uninstall a release:

helm uninstall [release]

Perform App Upgrade and Rollback

Helm offers users multiple options for app upgrades, such as automatic rollback and upgrading to a specific version. Rollbacks can also be executed on their own. For detailed instructions on how to perform a rollback, check out How to Roll Back Changes with Helm.

Upgrade an app:

helm upgrade [release] [chart]

Instruct Helm to rollback changes if the upgrade fails:

helm upgrade [release] [chart] --atomic

Upgrade a release. If it does not exist on the system, install it:

helm upgrade [release] [chart] --install

Upgrade to a specified version:

helm upgrade [release] [chart] --version [version-number]

Roll back a release:

helm rollback [release] [revision]

Download Release Information

The helm get command lets you download information about a release.

Download all the release information:

helm get all [release]

Download all hooks:

helm get hooks [release]

Download the manifest:

helm get manifest [release]

Download the notes:

helm get notes [release]

Download the values file:

helm get values [release]

Fetch release history:

helm history [release] 

Add, Remove, and Update Repositories

The command helm repo helps you manipulate chart repositories.

Add a repository from the internet:

helm repo add [repository-name] [url]

Remove a repository from your system:

helm repo remove [repository-name]

Update repositories:

helm repo update

List and Search Repositories

Use the helm repo and helm search commands to list and search Helm repositories. helm search also enables you to find apps and repositories in Helm Hub.

List chart repositories:

helm repo list

Generate an index file containing charts found in the current directory:

helm repo index

Search charts for a keyword:

helm search [keyword]

Search repositories for a keyword:

helm search repo [keyword]

Search Helm Hub:

helm search hub [keyword]

Release Monitoring

The helm list command enables listing releases in a Kubernetes cluster according to several criteria, including using regular (Pearl compatible) expressions to filter results. Commands such as helm status and helm history provide more details about releases.

List all available releases in the current namespace:

helm list

List all available releases across all namespaces:

helm list --all-namespaces

List all releases in a specific namespace:

helm list --namespace [namespace]

List all releases in a specific output format:

helm list --output [format]

Apply a filter to the list of releases using regular expressions:

helm list --filter '[expression]'

See the status of a specific release:

helm status [release]

Display the release history:

helm history [release]

See information about the Helm client environment:

helm env

Note: Learn more about managing Kubernetes cluster namespaces and unwanted or multiple copies of Helm deployments by referring to our article How To Delete Helm Deployment And Namespace.

Plugin Management

Install, manage and remove Helm plugins by using the helm plugin command.

Install plugins:

helm plugin install [path/url1] [path/url2] ...

View a list of all installed plugins:

helm plugin list

Update plugins:

helm plugin update [plugin1] [plugin2] ...

Uninstall a plugin:

helm plugin uninstall [plugin]

Chart Management

Helm charts use Kubernetes resources to define an application. To find out more about their structure and requirements for their creation, refer to How to Create a Helm Chart.

Create a directory containing the common chart files and directories (chart.yaml, values.yaml, charts/ and templates/):

helm create [name]

Package a chart into a chart archive:

helm package [chart-path]

Run tests to examine a chart and identify possible issues:

helm lint [chart]

Inspect a chart and list its contents:

helm show all [chart] 

Display the chart’s definition:

helm show chart [chart] 

Display the chart’s values:

helm show values [chart]

Download a chart:

helm pull [chart]

Download a chart and extract the archive’s contents into a directory:

helm pull [chart] --untar --untardir [directory]

Display a list of a chart’s dependencies:

helm dependency list [chart]

Get Help and Version Information

Display the general help output for Helm:

helm --help

Show help for a particular helm command:

helm [command] --help

See the installed version of Helm:

helm version

Helm Cheat Sheet PDF

Below you can find a one-page reference sheet containing all the Helm commands listed above. Download the Helm cheat sheet PDF and save it for future reference.

DOWNLOAD Cheat Sheet

Conclusion

The tutorial listed the most common Helm commands used for app management in your Kubernetes cluster. The downloadable cheat sheet included is a handy one-page guide useful for a quick reference.

Was this article helpful?
YesNo
Marko Aleksic
Marko Aleksić is a Technical Writer at phoenixNAP. His innate curiosity regarding all things IT, combined with over a decade long background in writing, teaching and working in IT-related fields, led him to technical writing, where he has an opportunity to employ his skills and make technology less daunting to everyone.
Next you should read
Install Elasticsearch on Kubernetes Using Helm Chart
March 18, 2021

There are several methods for deploying Elasticsearch and the rest of the ELK stack on Kubernetes. Using Helm…
Read more
What is Helm? Helm and Helm Charts Explained
March 11, 2021

Helm automates application deployment to Kubernetes clusters. Helm provides a templating approach to…
Read more
How to Use Environment Variables with Helm Charts
February 24, 2021

Helm charts are used to collect and package Kubernetes resources into simple and efficient clusters. In this…
Read more
Get Helm Values For a Helm Release
February 10, 2021

Helm releases get updated and so do the values. Each change of Helm values is tracked. Learn how to get Helm…
Read more
  • © 2021 Copyright phoenixNAP | Global IT Services. All Rights Reserved.