Running on Azure
This starter guide provides a quick start for running Pinot on Microsoft Azure
This document provides the basic instruction to set up a Kubernetes Cluster on Azure Kubernetes Service (AKS)

1. Tooling Installation

1.1 Install Kubectl

Please follow this link (https://kubernetes.io/docs/tasks/tools/install-kubectl) to install kubectl.
For Mac User
1
brew install kubernetes-cli
Copied!
Please check kubectl version after installation.
1
kubectl version
Copied!
QuickStart scripts are tested under kubectl client version v1.16.3 and server version v1.13.12

1.2 Install Helm

Please follow this link (https://helm.sh/docs/using_helm/#installing-helm) to install helm.
For Mac User
1
brew install kubernetes-helm
Copied!
Please check helm version after installation.
1
helm version
Copied!
This QuickStart provides helm supports for helm v3.0.0 and v2.12.1. Please pick the script based on your helm version.

1.3 Install Azure CLI

For Mac User
1
brew update && brew install azure-cli
Copied!

2. (Optional) Login to your Azure account

Below script will open default browser to sign-in to your Azure Account.
1
az login
Copied!

3. (Optional) Create a Resource Group

Below script will create a resource group in location eastus.
1
AKS_RESOURCE_GROUP=pinot-demo
2
AKS_RESOURCE_GROUP_LOCATION=eastus
3
az group create --name ${AKS_RESOURCE_GROUP} \
4
--location ${AKS_RESOURCE_GROUP_LOCATION}
Copied!

4. (Optional) Create a Kubernetes cluster(AKS) in Azure

Below script will create a 3 nodes cluster named pinot-quickstart for demo purposes.
Please modify the parameters in the example command below:
1
AKS_RESOURCE_GROUP=pinot-demo
2
AKS_CLUSTER_NAME=pinot-quickstart
3
az aks create --resource-group ${AKS_RESOURCE_GROUP} \
4
--name ${AKS_CLUSTER_NAME} \
5
--node-count 3
Copied!
Once the command is succeed, it's ready to be used.

5. Connect to an existing cluster

Simply run below command to get the credential for the cluster pinot-quickstart that you just created or your existing cluster.
1
AKS_RESOURCE_GROUP=pinot-demo
2
AKS_CLUSTER_NAME=pinot-quickstart
3
az aks get-credentials --resource-group ${AKS_RESOURCE_GROUP} \
4
--name ${AKS_CLUSTER_NAME}
Copied!
To verify the connection, you can run:
1
kubectl get nodes
Copied!

6. Pinot Quickstart

Please follow this Kubernetes QuickStart to deploy your Pinot Demo.

7. Delete a Kubernetes Cluster

1
AKS_RESOURCE_GROUP=pinot-demo
2
AKS_CLUSTER_NAME=pinot-quickstart
3
az aks delete --resource-group ${AKS_RESOURCE_GROUP} \
4
--name ${AKS_CLUSTER_NAME}
Copied!
Last modified 1yr ago