liveBook · Manning

Helm release

As explained in Platform Engineering on Kubernetes

A Helm release is a named, managed instance of a Helm chart installed in a Kubernetes environment.

A Helm release is a named application instance created when Helm installs a chart into a Kubernetes cluster. The release name identifies that deployed instance, and multiple instances can coexist. section 2.2

A Helm release supports several operational workflows:

  • Install a chart and record its deployed name, status, namespace, revision, and chart version. section 2.2
  • List releases to inspect which named application instances exist in the cluster. section 2.2
  • Represent environment configuration declaratively, with tools such as helmfile defining releases and synchronizing them into a cluster. section 4.1.4

Installing the Conference release

Running `helm install conference oci://docker.io/salaboy/conference-app --version v1.0.0` creates the `conference` release. Helm reports it as deployed in the `default` namespace at revision 1, with the chart version and access instructions. section 2.2

Listing 2.1 Helm installed the chart conference-app version 1.0.0
> helm install conference oci://docker.io/salaboy/conference-app --version 
v1.0.0 
Pulled: registry-1.docker.io/salaboy/conference-app:v1.0.0
Digest: sha256:e5dd1a87a867fd7d6c6caecef3914234a12f23581c5137edf63bfd9add7d5459
NAME: conference
LAST DEPLOYED: Mon Jun 26 08:19:15 2023
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
Cloud-Native Conference Application v1.0.0
Chart Deployed: conference-app - v1.0.0
Release Name: conference
For more information visit: https://github.com/salaboy/platforms-on-k8s
Access the Conference Application Frontend by running 
'kubectl port-forward svc/frontend -n default 8080:80'

Inspect the installation output to see the release name, chart version, namespace, deployment status, revision, and generated access note. section 2.2

How Platform Engineering on Kubernetes covers it

How deep it goes
Explains installation, listing, and declarative synchronization, while stopping short of release internals or lifecycle operations.
Examples
Uses the Conference application installation, `helm list`, Helmfile synchronization, and environment-specific release configurations.
What it assumes
Assumes a Kubernetes cluster and a packaged Helm chart, while demonstrating release naming and discovery through basic Helm commands.
What you can do after
Operate/configure releases by installing charts, listing deployed instances, or synchronizing declarative environment definitions.
How it connects
Connects Helm charts, Kubernetes clusters, Helmfile, environment pipelines, and Kubernetes namespaces.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Platform Engineering on Kubernetes. The section links point to the parts of the book it draws on.