diff --git a/docs/partials/helm/_helm-install-prereqs.mdx b/docs/partials/helm/_helm-install-prereqs.mdx index 2855f83967..40f9d540c9 100644 --- a/docs/partials/helm/_helm-install-prereqs.mdx +++ b/docs/partials/helm/_helm-install-prereqs.mdx @@ -1,5 +1,7 @@ -* You must have a customer in the Replicated Vendor Portal with a valid email address. This email address is only used as a username for the Replicated registry and is never contacted. For more information about creating and editing customers in the Vendor Portal, see [Creating a Customer](/vendor/releases-creating-customer). +* The customer used to install must have a valid email address. This email address is only used as a username for the Replicated registry and is never contacted. For more information about creating and editing customers in the Vendor Portal, see [Creating a Customer](/vendor/releases-creating-customer). + +* The customer used to install must have the **Existing Cluster (Helm CLI)** install type enabled. For more information about enabling install types for customers in the Vendor Portal, see [Managing Install Types for a License](licenses-install-types). * To ensure that the Replicated proxy registry can be used to grant proxy access to your application images during Helm installations, you must create an image pull secret for the proxy registry and add it to your Helm chart. To do so, follow the steps in [Using the Proxy Registry with Helm Installations](/vendor/helm-image-registry). -* (Recommended) To install the Replicated SDK alongside the application, declare the SDK as a dependency. For more information, see [Install the SDK as a Subchart](replicated-sdk-installing#install-the-sdk-as-a-subchart) in _Installing the Replicated SDK_. \ No newline at end of file +* Declare the SDK as a dependency in your Helm chart. For more information, see [Install the SDK as a Subchart](replicated-sdk-installing#install-the-sdk-as-a-subchart) in _Installing the Replicated SDK_. \ No newline at end of file diff --git a/docs/partials/helm/_installer-only-annotation.mdx b/docs/partials/helm/_installer-only-annotation.mdx new file mode 100644 index 0000000000..e63ec7ae0d --- /dev/null +++ b/docs/partials/helm/_installer-only-annotation.mdx @@ -0,0 +1,13 @@ +Any other Kubernetes resources in the release (such as Kubernetes Deployments or Services) must include the `kots.io/installer-only` annotation. + +The `kots.io/installer-only` annotation indicates that the Kubernetes resource is used only by the Replicated installers (Embedded Cluster, KOTS, and kURL). + +Example: +```yaml +apiVersion: v1 +kind: Service +metadata: + name: my-service + annotations: + kots.io/installer-only: "true" +``` \ No newline at end of file diff --git a/docs/vendor/licenses-install-types.mdx b/docs/vendor/licenses-install-types.mdx index 20e9917df6..ed7f97e42d 100644 --- a/docs/vendor/licenses-install-types.mdx +++ b/docs/vendor/licenses-install-types.mdx @@ -1,3 +1,5 @@ +import InstallerOnlyAnnotation from "../partials/helm/_installer-only-annotation.mdx" + # Managing Install Types for a License (Beta) This topic describes how to manage which installation types and options are enabled for a license. @@ -34,13 +36,16 @@ The following describes each installation type available, as well as the require - + - - + + @@ -48,7 +53,7 @@ The following describes each installation type available, as well as the require @@ -77,20 +82,6 @@ The following describes each installation type available, as well as the require
Install TypeDescriptionDescription Requirements
Existing Cluster (Helm CLI)

The customer does not have access to the Replicated installers.

When the Helm CLI Air Gap Instructions (Helm CLI only) install option is also enabled, the Download Portal displays instructions on how to pull Helm installable images into a local repository. See Understanding Additional Install Options below.

The latest release promoted to the channel where the customer is assigned must contain only Helm charts and Replicated Custom Resources. Any other Kubernetes resources must include the `kots.io/installer-only` annotation. See kots.io/installer-only Annotation below.

Allows the customer to install with Helm in an existing cluster. The customer does not have access to the Replicated installers (Embedded Cluster, KOTS, and kURL).

When the Helm CLI Air Gap Instructions (Helm CLI only) install option is also enabled, the Download Portal displays instructions on how to pull Helm installable images into a local repository. See Understanding Additional Install Options below.

 +

The latest release promoted to the channel where the customer is assigned must contain one or more Helm charts. It can also include Replicated custom resources, such as the Embedded Cluster Config custom resource, the KOTS HelmChart, Config, and Application custom resources, or the Troubleshoot Preflight and SupportBundle custom resources.

+ +
Existing Cluster (KOTS install)
  • Your Vendor Portal team must have the KOTS entitlement
    • -
  • The latest release promoted to the channel where the customer is assigned must contain KOTS custom resources
    • +
  • The latest release promoted to the channel where the customer is assigned must contain KOTS custom resources, such as the KOTS HelmChart, Config, and Application custom resources. For more information, see [About Custom Resources](/reference/custom-resource-about).
-### `kots.io/installer-only` Annotation {#installer-only-annotation} - -The `kots.io/installer-only` annotation indicates that the Kubernetes resource is only used by the Replicated installers (Embedded Cluster, KOTS, or kURL). This annotation is required for releases that support the `Existing Cluster (Helm CLI)` install type and include resources other than Helm charts. - -Example: -```yaml -apiVersion: v1 -kind: Service -metadata: - name: my-service - annotations: - kots.io/installer-only: "true" -``` - ## Understanding Additional Install Options {#install-options} After enabling installation types in the **Available install types** field, you can also enable the following options in the **Additional install options** field: