Imply Private on Minikube

The following steps take you through installing Imply on a single machine using Minikube and an Imply-maintained Helm chart. Minikube is a small-scale, single-node Kubernetes engine suitable for exploratory purposes.

If you are new to Imply and Kubernetes, this is a good way to get started. This setup is not recommended for production deployments.

We'll set up a local cluster consisting of:

• Imply Manager
• An Imply cluster with one master node, one query node, and two data nodes
• A MySQL server (metadata storage for both the manager and the Imply cluster)
• A single-node ZooKeeper cluster
• A single-node MinIO server (as deep storage)

The commands assume that you are using OSX, but can be easily adapted for a Windows or Linux OS. Our Kubernetes cluster will use 3 CPUs and 6 GB RAM, so your target machine should be able to support those specifications.

We will be using the Homebrew package manager to install Minikube and Helm. If you do not already have it, get it here.

Follow these steps to install Imply locally:

1. If you already have a Kubernetes environment available to use, you can skip to the next step. Otherwise, set up Minikube on your machine:

   1. Using Homebrew, run the following command:

      brew install minikube hyperkit
      

      For complete installation instructions, including instructions for other operating systems, see Minikube installation instructions in the Kubernetes documentation.

   2. Start a local Kubernetes cluster with the required resources:

      minikube start --cpus 3 --memory 6144 --disk-size 16g --vm-driver=hyperkit
      

2. Set up Helm:

   1. If you already have Helm installed, ensure that it is v3 or later. Otherwise, install Helm with the following command:

      brew install helm
      

   2. Add the Imply repository to Helm by running:

      helm repo add imply https://static.imply.io/onprem/helm
      helm repo update
      

3. By default, a new installation includes a 30-day trial license. If you have a longer-term license that you want to apply, follow these steps:

   1. Create a file named IMPLY_MANAGER_LICENSE_KEY and paste your license key as the content of the file.
   2. Create a Kubernetes secret named imply-secrets by running:

      kubectl create secret generic imply-secrets --from-file=IMPLY_MANAGER_LICENSE_KEY
      

4. Now deploy the Imply chart to install Imply:

   helm install imply imply/imply
   

   The chart will take a minute or two to deploy, after which you will be presented with information on how to access your cluster.

5. Your cluster is now running! As noted in the Helm output, set up port forwarding to access the following services:

   • Imply Manager

     kubectl --namespace default port-forward svc/imply-manager-int 9097
     

   • Pivot and Druid console

     kubectl --namespace default port-forward svc/imply-query 8888 9095
     

You can now access the Imply UIs from your web browser at the following addresses:

• Imply Manager: http://localhost:9097
• Druid console: http://localhost:8888
• Pivot: http://localhost:9095

If you want to learn more about the parameters available in the Helm chart, see Adapting the Imply Manager Helm Chart.

That's it! If you are new to Imply, try the quickstart steps for loading and querying data data.