Skip to main content

Helm

This guide demonstrates how Helm integrates with Runme to automate processes and reduce repetitive tasks.

Prerequisite​

To follow up on this tutorial, ensure you have the following:

git clone https://github.com/stateful/blog-examples.git
  • Require Packages: Install the required packages (kind,kubectl, Helm ) inside your Markdown file. Runme allows you to achieve this! Simply run the command in the prerequisite section in the repo.
brew install kind
brew install docker
brew install helm

This code cell below deletes the cluster if it already existed.

kind delete cluster --name helm-runme

We're using kind to create a Kubernetes cluster locally. The name of the Kubernetes cluster is helm-runme

kind create cluster --name helm-runme

Check if your cluster is running

kubectl get ns

Using the Runme cell section feature you can run the entire subheading at a go.

Follow the instructions and commands in the above notebook for this guide.

Basic Helm Commands​

Now that you have installed Helm on your local machine, let’s try some basic commands. Run the commands below:

helm search hub Wordpress

This command searches the Helm Hub repository for Helm charts related to WordPress and will return any available WordPress charts from the Helm Hub.

helm list --all

This command lists all releases managed by Helm in the current Kubernetes cluster. The—all flag shows all releases, including superseded ones.

helm repo update

This command updates the local cache of Helm chart repositories.

helm history ingress-nginx

This command displays the release history for a specific Helm release named ingress-nginx. You can check out the release history for any Helm release. Simply change ingress-nginx to the release of your choice.

Let’s dive deeper into more complex Helm configurations in your Markdown file with Runme.

Creating A Helm Chart Within Your Runme Environment​

You can create your helm chart to suit your specific use case however, for this guide, we will be using a helm chart from the helm repo.

The repo adds a Kubernetes Ingress controller called ingress-nginx which helps manage external access to services within the Kubernetes cluster.

Runme is dynamically set. You can run the entire markdown file using the Run all feature. If you want to run just a particular section, you can also do that, or run just a single cell.

Installing Helm Packages with Runme​

The helm install command installs a Helm chart into your Kubernetes cluster. When you run helm install, specify the release name, the chart name (either local or from a repository), and any necessary configuration values or overrides. Helm fetches the specified chart from the repository (if not locally available) and installs it into your cluster, creating a new release.

The code block below installs the Kubernetes Ingress controller and checks the status of the deployment to ensure everything is properly installed.

helm install ingress-nginx ingress-nginx/ingress-nginx

Check the status of helm chart

helm status ingress-nginx

This is a pictorial representation of the output in the Runme terminal.

helm status

Now, you have successfully installed it with your Runme terminal🎉

Upgrading Helm Packages With Runme​

After installing your Helm packages, you can upgrade them. The helm upgrade command upgrades a release to a new version of a chart or applies changes to an existing release. Helm plugins are external tools or extensions that enhance the functionality of the Helm CLI.

With Runme, you can modify the working directory for your code cell to a file directory of your choice. This enables you to easily run values.yaml even if the file is not located in the same directory as your markdown file.

To upgrade the Ingress package installed earlier, run the command below:

helm upgrade ingress-nginx ingress-nginx/ingress-nginx --values values.yaml

To check the status of your deployment, run the command below:

helm status ingress-nginx

If you ever want to uninstall the package, run the command below:

helm uninstall ingress-nginx

Implementing Helm Rollback​

In your Runme notebook, you can revert to a specific historical version of a Helm release within your Kubernetes cluster. Use the helm rollback command alongside the release name and the revision number you want to deploy.

For example, the code block below, when executed, displays the revision history for the Helm release, rolls back the Helm release named ingress-nginx to a specific revision, in this case, revision 1, and provides information about the current state of the release.

helm history ingress-nginx
helm rollback ingress-nginx 1
helm status ingress-nginx

helm rollback

Retrieve Information with Runme​

The helm get command in Helm retrieves information about a specific release or resource within a release. It provides various subcommands to fetch different information related to Helm releases.

To retrieve information about the Ingress package installed, run the command below

helm get manifest ingress-nginx

When the command is executed successfully, this is the output.

helm get manifest

To retrieve the release note associated with the package, run the command below

helm get notes ingress-nginx

Add Helm Plugin​

Helm plugins are external tools or extensions that enhance the functionality of the Helm CLI. For this guide, we installed the sops plugin to use it encrypt our kubernetes secret.

To get the list of the Helm plugins installed on your local system, run the command below:

helm plugin list

To install the Helm plugin named “helm-secrets” from the GitHub repository at the specified version(v4.60), run the command below:

helm plugin install https://github.com/jkroepke/helm-secrets --version v4.6.0

To encrypt sensitive information within the secrets.yaml file, run the command below:

helm secrets encrypt secrets.yaml > sops-secrets.yaml

This command encrypts the file secrets.yaml using the helm-secrets plugin and write the encrypted content to a new file sops-secrets.yaml . Here is the pictorial representation of the commands when executed individually in your Runme cell.

runme-plugins

In addition to creating a runbook to improve your documentation and automate repetitive tasks, Runme offers you an interactive environment to carry out these operations. Runme is power-packed with configuration tools to improve your process. Explore the Runme configuration guide for configuration options.