• Azure
    • AKS
    • AKS-Engine

    Azure

    Follow these instructions to prepare an Azure cluster for Istio.

    You can deploy a Kubernetes cluster to Azure via AKS or AKS-Engine which fully supports Istio.

    AKS

    You can create an AKS cluster via the az cli or the Azure portal.

    For the az cli option, complete az login authentication OR use cloud shell, then run the following commands below.

    • Determine the desired region name which supports AKS
    1. $ az provider list --query "[?namespace=='Microsoft.ContainerService'].resourceTypes[] | [?resourceType=='managedClusters'].locations[]" -o tsv
    • Verify the supported Kubernetes versions for the desired region

    Replace my location using the desired region value from the above step, and then execute:

    1. $ az aks get-versions --location "my location" --query "orchestrators[].orchestratorVersion"

    Ensure a minimum of 1.10.5 is listed.

    • Create the resource group and deploy the AKS cluster

    Replace myResourceGroup and myAKSCluster with desired names, my location using the value from step 1, 1.10.5 if not supported in the region, and then execute:

    1. $ az group create --name myResourceGroup --location "my location"
    2. $ az aks create --resource-group myResourceGroup --name myAKSCluster --node-count 3 --kubernetes-version 1.10.5 --generate-ssh-keys
    • Get the AKS kubeconfig credentials

    Replace myResourceGroup and myAKSCluster with the names from the previous step and execute:

    1. $ az aks get-credentials --resource-group myResourceGroup --name myAKSCluster

    AKS-Engine

    • Follow the instructions to get and install the aks-engine binary.

    • Download the aks-engine API model definition that supports deploying Istio:

    1. $ wget https://raw.githubusercontent.com/Azure/aks-engine/master/examples/service-mesh/istio.json

    Note: It is possible to use other api model definitions which will work with Istio. The MutatingAdmissionWebhook and ValidatingAdmissionWebhook admission control flags and RBAC are enabled by default. See aks-engine api model default values for further information.

    • Deploy your cluster using the istio.json template. You can find referencesto the parameters in theofficial docs.

    ParameterExpected valuesubscription_idAzure Subscription Iddns_prefixCluster DNS PrefixlocationCluster Location

    1. $ aks-engine deploy --subscription-id <subscription_id> \
    2. --dns-prefix <dns_prefix> --location <location> --auto-suffix \
    3. --api-model istio.json

    After a few minutes, you can find your cluster on your Azure subscriptionin a resource group called <dns_prefix>-<id>. Assuming dns_prefix hasthe value myclustername, a valid resource group with a unique clusterID is mycluster-5adfba82. The aks-engine generates your kubeconfigfile in the _output folder.

    • Use the <dns_prefix>-<id> cluster ID, to copy your kubeconfig to yourmachine from the _output folder:
    1. $ cp _output/<dns_prefix>-<id>/kubeconfig/kubeconfig.<location>.json \
    2. ~/.kube/config

    For example:

    1. $ cp _output/mycluster-5adfba82/kubeconfig/kubeconfig.westus2.json \
    2. ~/.kube/config