Skip to main content
Version: 0.94

Deploying with an Admin Console

Prerequisites

Before installing Snorkel Flow, make sure the following steps have been completed

  • You have access to a Kubernetes cluster with specs outlined in the Snorkel Flow Kubernetes Installation Overview.
  • You have privileges to schedule pods, deployments, services, ingresses, and secrets, as well as to create namespaces, within the Kubernetes (K8s) cluster. When we refer to “the K8s cluster” in the remainder of this document, we will be referring to this cluster.
  • You have access to a workspace with your K8s environment. This guide assumes an Ubuntu virtual machine is available.
  • You have been added to the Vendor Portal under the Stable release by your Snorkel AI contact and you have been provided with a customer license for the installation. There will be another license needed for Snorkel Flow later in the process.

These instructions assume that you will install Snorkel Flow using Amazon's Elastic Kubernetes Service. Snorkel Flow can run on any Kubernetes installation that follows the specs in Snorkel Flow Kubernetes Installation Overview, but for this tutorial, we will focus on EKS. If you have specific questions about how Snorkel Flow is configured, please contact Snorkel support. For other general management questions regarding Kubernetes, or EKS, please refer to their documentation.

System Dependencies

From your workspace, install the command line tools required to set up Kubernetes resources:

Install into an Existing Cluster

All resources created by the Snorkel Flow utilities will live in a single namespace within the EKS cluster.

$ curl https://kots.io/install | bash
$ export PATH=$HOME/bin:$PATH
$ kubectl kots install snorkel-flow

The above commands downloads the kots plugin and sets it up for use. You will be asked to provide a directory to save the kubectl-kots file. In the above example, the directory is $HOME/bin.

Follow the steps below to complete the installation:

  1. Provide a namespace to install to (default is snorkel-flow).
  2. Enter a password for the Admin Console and save it for future use.
  3. At this point, you would need to hit Control-C to get your prompt back and run "kubectl port-forward -n svc/kotsadm --address 0.0.0.0 8805:3000"
  4. Visit ```bash http://<IP_ADDRESS>:8805
5.  Upload your Replicated YAML license file.
6. Configure the platform for your use by filling in the configuration items with assistance from your Snorkel technical representative.
7. Save the configuration and click the "Deploy" button 
8. Check the k8s environment for the pods to come online
9. Access the platform ingress page and provide the Snorkel Flow license to activate the platform.

**At this point Snorkel Flow should be successfully installed into your cluster!**