Skip to main content

About Distributing Applications with Replicated

This topic describes the options for using Replicated to distribute applications, including information about supporting installations with the Helm CLI and with the Replicated KOTS installer.

About Installations with the Helm CLI​

You can distribute your Helm chart-based application with Replicated and allow your customers to install with the Helm CLI. The following diagram shows how Helm charts distributed with Replicated are installed with Helm in customer environments:

diagram of a helm chart in a custom environment

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 the Beta channel, 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.

For more information about how to install an application with Helm, see Installing with Helm.

For information about how to get started distributing your Helm chart with Replicated, see Replicated Quick Start.

Replicated SDK​

The Replicated SDK is a Helm chart that can be installed as a small service alongside your application Helm chart. The Replicated SDK provides an in-cluster API that you can use to embed Replicated features into your application such as:

For more information, see About the Replicated SDK.

Limitations​

The following limitations apply when using Helm to install applications distributed with Replicated:

  • Replicated does not support Helm installations into air gap environments.

  • Helm installations do not provide access to any of the features of the Replicated KOTS installer, including:

    • The Replicated 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

About Installations with KOTS​

note

You must have the Replicated KOTS entitlement to use the Replicated KOTS and kURL installers and features.

The Replicated KOTS installer provides highly successful installs of Kubernetes applications or Helm charts in diverse customer environments, including on-prem and air gap environments. Additionally, the Replicated kURL installer allows customers that do not have their own Kubernetes cluster to install your application with KOTS by provisioning a cluster on a virtual machine (VM) or bare metal server. For more information, see About KOTS and kURL.

The following diagram demonstrates how applications distributed with Replicated are installed into an existing cluster or VM with KOTS and kURL:

KOTS and kURL deployments

View larger image

As shown in the diagram above, customers can install an application by first installing KOTS in their existing cluster or in the cluster provisioned by kURL. Then, they can use KOTS to configure and install the application. For more information about installing with KOTS and kURL, see About Installing an Application.

Helm Charts with KOTS​

Helm is a popular package manager for Kubernetes applications. For vendors that support installations with KOTS, Replicated strongly recommends that you distribute your application as a Helm chart. When you distribute your application as a Helm chart, you can support both installations with the Helm CLI and with KOTS from the same release, without having to maintain separate sets of Helm charts or application manifests. This is important because many enterprise users expect to be able to install an application with Helm.

Also, using KOTS to distribute Helm charts provides additional functionality not directly available with the Helm CLI, such as a user interface for collecting user configuration values and backup and restore with snapshots.

For information about how to get started distributing your Helm chart with Replicated so that you can support both installations with the Helm CLI and with KOTS, see Replicated Quick Start.

For more information about how KOTS installs Helm charts, see About Distributing Helm Charts with KOTS.