Quick Start with AKS

Prerequisites

1. Install the Meshery command line client, mesheryctl .

To set up and run Meshery on AKS:

Connect Meshery to Azure Kubernetes Cluster

The following set of instructions expects you to have created a AKS cluster in your resource group Configure Meshery to connect to your AKS cluster by executing:


 

 mesheryctl system config aks

Manual Steps

Alternatively, you may execute the following steps to manually configure Meshery to connect to your AKS cluster.

  • Install Azure CLI(az), and login to your azure account using az login.

  • After successfull login, you have to select the subscription with which your AKS is associated with




az account set --subscription [SUBSCRIPTION_ID]
  • Get the kubeconfig from your AKS cluster



az aks get-credentials --resource-group [RESOURCE_GROUP] --name [AKS_SERVICE_NAME]
  • Set your cluster context and check your cluster-info



kubectl set-context AKS_SERVICE_NAME
kubectl cluster-info

Install Meshery into your AKS cluster


 

 $ helm repo add meshery https://meshery.io/charts/
 $ helm install meshery meshery/meshery --namespace meshery --create-namespace
  • Meshery server supports customizing authentication flow callback URL, which can be configured in the following way

 

 $ helm install meshery meshery/meshery --namespace meshery --set env.MESHERY_SERVER_CALLBACK_URL=https://custom-host --create-namespace

Port forward to the Meshery UI


 

 export POD_NAME=$(kubectl get pods --namespace meshery -l "app.kubernetes.io/name=meshery,app.kubernetes.io/instance=meshery" -o jsonpath="{.items[0].metadata.name}")
 kubectl --namespace meshery port-forward $POD_NAME 9081:8080

Meshery should now be running in your AKS cluster and the Meshery UI should be accessible at the specified endpoint you’ve exposed to. Navigate to the meshery service endpoint to log into Meshery.