Skip to main content

About Helm Installations with Replicated

This topic provides an introduction to Helm installations for applications distributed with Replicated.

Overview​

Helm is a popular open source package manager for Kubernetes applications. Many ISVs use Helm to configure and deploy Kubernetes applications because it provides a consistent, reusable, and sharable packaging format. For more information, see the Helm documentation.

Replicated strongly recommends that all applications are packaged using Helm because many enterprise users expect to be able to install an application with the Helm CLI.

Existing releases in the Replicated Platform that already support installation with Replicated KOTS and Replicated Embedded Cluster (and that include one or more Helm charts) can also be installed with the Helm CLI; it is not necessary to create and manage separate releases or channels for each installation method.

For information about how to install with Helm, see:

The following diagram shows how Helm charts distributed with Replicated are installed with Helm in online (internet-connected) customer environments:

diagram of a helm chart in a custom environment

View a larger version of this image

As shown in the diagram above, when a release containing one or more Helm charts is promoted to a channel, the Replicated Vendor Portal automatically extracts any Helm charts included in the release. These charts are pushed as OCI objects to the Replicated registry. The Replicated registry is a private OCI registry hosted by Replicated at registry.replicated.com. For information about security for the Replicated registry, see Replicated Registry Security.

For example, if your application in the Vendor Portal is named My App and you promote a release containing a Helm chart with name: my-chart to a channel with the slug beta, then the Vendor Portal pushes the chart to the following location: oci://registry.replicated.com/my-app/beta/my-chart.

Customers can install your Helm chart by first logging in to the Replicated registry with their unique license ID. This step ensures that any customer who installs your chart from the registry has a valid, unexpired license. After the customer logs in to the Replicated registry, they can run helm install to install the chart from the registry.

During installation, the Replicated registry injects values into the global.replicated key of the parent Helm chart's values file. For more information about the values schema, see Helm global.replicated Values Schema.

Limitations​

Helm installations have the following limitations:

  • Installing with Helm in air gap environments is an Beta feature. For more information, see Installing and Updating with Helm in Air Gap Environments.
  • Helm CLI installations do not provide access to any of the features of the Replicated KOTS installer, such as:
    • The KOTS Admin Console
    • Strict preflight checks that block installation
    • Backup and restore with snapshots
    • Required releases with the Prevent this release from being skipped during upgrades option