Skip to main content

Online Installation in Existing Clusters

This topic describes how to use Replicated to install an application on an existing Kubernetes cluster in an online environment.

Prerequisites​

Complete the following prerequisites:

  • Ensure that your cluster meets the minimum system requirements. See Minimum System Requirements in Requirements for Installation.

  • Ensure that you have at least the minimum RBAC permissions in the cluster required to install the app manager. See RBAC Requirements in Requirements for Installation.

    note

    If you manually created RBAC resources for the app manager as described in Namespace-scoped RBAC Requirements, include both the --ensure-rbac=false and --skip-rbac-check flags when you run the kots install command.

    These flags prevent the app manager from checking for or attempting to create a Role with * * * permissions in the namespace. For more information about these flags, see install or admin-console upgrade.

  • Review the options available with the kots install command before installing. The kots install command includes several optional flags to support different installation use cases. For a list of options, see install in the kots CLI documentation.

Install the Application​

You can install an application to an existing Kubernetes cluster that contains nodes that can access the internet. In an online installation, the Replicated app manager pulls container images from the upstream registries directly.

To install the application:

  1. Run one of the following commands:

    • For the latest version of the application:

      curl https://kots.io/install | bash
      kubectl kots install APP_SLUG

    • For a specific version of the application, use the app-version-label flag and the version label for a particular version of your vendor's application:

      curl https://kots.io/install | bash
      kubectl kots install APP_SLUG --app-version-label=VERSION_LABEL

    Replace, where applicable:

    • APP_SLUG with the unique slug for the application. The application slug is included in the installation command provided by the vendor.
    • VERSION_LABEL with the label for the version of the application to install. For example, --app-version-label=3.0.1.

  2. When prompted by the kots install command:

    1. Provide the namespace where you want to deploy the application and the admin console.

    2. Create a new password for logging in to the admin console.

      Example:

      $ kubectl kots install application-name
      Enter the namespace to deploy to: application-name
        • Deploying Admin Console
          • Creating namespace ✓
          • Waiting for datastore to be ready ✓
      Enter a new password to be used for the Admin Console: ••••••••
        • Waiting for Admin Console to be ready ✓

        • Press Ctrl+C to exit
        • Go to http://localhost:8800 to access the Admin Console

      After the kots install command installs the admin console and the application on the cluster, it creates a port forward to the admin console. The admin console is exposed internally on the cluster and can only be accessed using a port forward.

  3. Log in to the admin console to complete the application setup, run preflight checks, and deploy. See Completing Application Setup and Deploying.