// Licensed to the Apache Software Foundation (ASF) under one or more
// contributor license agreements.  See the NOTICE file distributed with
// this work for additional information regarding copyright ownership.
// The ASF licenses this file to You under the Apache License, Version 2.0
// (the "License"); you may not use this file except in compliance with
// the License.  You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
= Microsoft Azure Kubernetes Service Deployment

:serviceName: AKS
:soft_name: Kubernetes
:command: kubectl
:configDir: ../../code-snippets/k8s
:script: ../../code-snippets/k8s/setup.sh
:javaFile: ../../{javaCodeDir}/k8s/K8s.java

This page is a step-by-step guide on how to deploy an Ignite  cluster on Microsoft Azure Kubernetes Service.

include::installation/kubernetes/generic-configuration.adoc[tag=intro]

include::installation/kubernetes/generic-configuration.adoc[tag=kube-version]

== Creating the AKS Cluster

The first step is to configure the Azure Kubernetes Service (AKS) cluster by following one of the Microsoft guidelines:

*  link:https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough-portal[Deploy an AKS cluster using the Azure portal,window=_blank]
*  link:https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough[Deploy an AKS cluster using the Azure CLI,window=_blank]


In this guide, we'll be using the Azure portal.

1. Create a Microsoft account if you do not have one. Navigate to https://portal.azure.com[,window=_blank] and choose *Create a resource > Kubernetes Service > Create*.
2. On the screen that appears, specify general parameters for your deployment, cluster name as "IgniteCluster", and resource group name as "Ignite".
+
--
image::images/k8s/create-aks-cluster.png[]
--
3. On the same screen, pick the required number of nodes for your AKS cluster:
+
--
image::images/k8s/aks-node-number.png[]
--
4. Configure other parameters as required.
5. When finished with the configuration, click the *Review + create* button.
6. Double check the configuration parameters and click *Create*. Give Azure some time to deploy the cluster.
7. Go to *All Resources > IgniteCluster* to view the state of the cluster.

== Connecting to the AKS Cluster

To configure `kubectl` to connect to your Kubernetes cluster, use the following command:

[source, shell]
----
az aks get-credentials --resource-group Ignite --name IgniteCluster
----

If you encounter any problems, check out the https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough#connect-to-the-cluster[official documentation,window=_blank].

Using the following command, check that all the nodes are in "Ready" state:

[source, shell]
----
$ kubectl get nodes

NAME                                STATUS   ROLES   AGE     VERSION
aks-agentpool-25545244-vmss000000   Ready    agent   6h23m   v1.14.8
aks-agentpool-25545244-vmss000001   Ready    agent   6h23m   v1.14.8
aks-agentpool-25545244-vmss000002   Ready    agent   6h23m   v1.14.8
----

Now you can start creating Kubernetes resources.

== Kubernetes Configuration

include::installation/kubernetes/generic-configuration.adoc[tag=kubernetes-config]