Skip to content

Commit

Permalink
Docs: updating GKE and AKS Kubernetes versions (#1791)
Browse files Browse the repository at this point in the history
* Docs: updating GKE and AKS Kubernetes versions

Kubernetes version: GKE website changes, AKS website and Terraform
changes.
  • Loading branch information
aLekSer committed Sep 12, 2020
1 parent fe14aea commit 6fe2a74
Show file tree
Hide file tree
Showing 4 changed files with 50 additions and 2 deletions.
2 changes: 1 addition & 1 deletion install/terraform/modules/aks/aks.tf
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ resource "azurerm_kubernetes_cluster" "agones" {
resource_group_name = azurerm_resource_group.agones_rg.name
dns_prefix = "agones"

kubernetes_version = "1.15.10"
kubernetes_version = "1.16.13"

default_node_pool {
name = "default"
Expand Down
26 changes: 26 additions & 0 deletions site/content/en/docs/Installation/Creating Cluster/aks.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ If you are using Azure CLI from your local shell, you need to log in to your Azu

Here are the steps you need to follow to create a new AKS cluster (additional instructions and clarifications are listed [here](https://docs.microsoft.com/azure/aks/kubernetes-walkthrough)):

{{% feature expiryVersion="1.9.0" %}}
```bash
# Declare necessary variables, modify them according to your needs
AKS_RESOURCE_GROUP=akstestrg # Name of the resource group your AKS cluster will be created in
Expand All @@ -27,6 +28,7 @@ AKS_LOCATION=westeurope # Azure region in which you'll deploy your AKS
az group create --name $AKS_RESOURCE_GROUP --location $AKS_LOCATION

# Create the AKS cluster - this might take some time. Type 'az aks create -h' to see all available options

# The following command will create a four Node AKS cluster. Node size is Standard A1 v1 and Kubernetes version is 1.15.10. Plus, SSH keys will be generated for you, use --ssh-key-value to provide your values
az aks create --resource-group $AKS_RESOURCE_GROUP --name $AKS_NAME --node-count 4 --generate-ssh-keys --node-vm-size Standard_A4_v2 --kubernetes-version 1.15.10

Expand All @@ -36,6 +38,30 @@ sudo az aks install-cli
# Get credentials for your new AKS cluster
az aks get-credentials --resource-group $AKS_RESOURCE_GROUP --name $AKS_NAME
```
{{% /feature %}}

{{% feature publishVersion="1.9.0" %}}
```bash
# Declare necessary variables, modify them according to your needs
AKS_RESOURCE_GROUP=akstestrg # Name of the resource group your AKS cluster will be created in
AKS_NAME=akstest # Name of your AKS cluster
AKS_LOCATION=westeurope # Azure region in which you'll deploy your AKS cluster

# Create the Resource Group where your AKS resource will be installed
az group create --name $AKS_RESOURCE_GROUP --location $AKS_LOCATION

# Create the AKS cluster - this might take some time. Type 'az aks create -h' to see all available options

# The following command will create a four Node AKS cluster. Node size is Standard A1 v1 and Kubernetes version is 1.16.13. Plus, SSH keys will be generated for you, use --ssh-key-value to provide your values
az aks create --resource-group $AKS_RESOURCE_GROUP --name $AKS_NAME --node-count 4 --generate-ssh-keys --node-vm-size Standard_A4_v2 --kubernetes-version 1.16.13

# Install kubectl
sudo az aks install-cli

# Get credentials for your new AKS cluster
az aks get-credentials --resource-group $AKS_RESOURCE_GROUP --name $AKS_NAME
```
{{% /feature %}}

Alternatively, you can use the [Azure Portal](https://portal.azure.com) to create a new AKS cluster [(instructions)](https://docs.microsoft.com/azure/aks/kubernetes-walkthrough-portal).

Expand Down
17 changes: 17 additions & 0 deletions site/content/en/docs/Installation/Creating Cluster/gke.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,7 @@ To install `gcloud` and `kubectl`, perform the following steps:

A [cluster][cluster] consists of at least one *cluster master* machine and multiple worker machines called *nodes*: [Compute Engine virtual machine][vms] instances that run the Kubernetes processes necessary to make them part of the cluster.

{{% feature expiryVersion="1.9.0" %}}
```bash
gcloud container clusters create [CLUSTER_NAME] --cluster-version=1.15 \
--tags=game-server \
Expand All @@ -78,10 +79,26 @@ gcloud container clusters create [CLUSTER_NAME] --cluster-version=1.15 \
--no-enable-autoupgrade \
--machine-type=n1-standard-4
```
{{% /feature %}}
{{% feature publishVersion="1.9.0" %}}
```bash
gcloud container clusters create [CLUSTER_NAME] --cluster-version=1.16 \
--tags=game-server \
--scopes=gke-default \
--num-nodes=4 \
--no-enable-autoupgrade \
--machine-type=n1-standard-4
```
{{% /feature %}}

Flag explanations:

{{% feature expiryVersion="1.9.0" %}}
* cluster-version: Agones requires Kubernetes version 1.15.
{{% /feature %}}
{{% feature publishVersion="1.9.0" %}}
* cluster-version: Agones requires Kubernetes version 1.16.
{{% /feature %}}
* tags: Defines the tags that will be attached to new nodes in the cluster. This is to grant access through ports via the firewall created in the next step.
* scopes: Defines the Oauth scopes required by the nodes.
* num-nodes: The number of nodes to be created in each of the cluster's zones. Default: 4. Depending on the needs of your game, this parameter should be adjusted.
Expand Down
7 changes: 6 additions & 1 deletion site/content/en/docs/Installation/Terraform/aks.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,12 @@ Configure your terraform:
terraform init
```

Now you can deploy your cluster (use variables from the above `az ad sp create-for-rbac` command output):
Create a service principal and configure its access to Azure resources:
```
az ad sp create-for-rbac
```

Now you can deploy your cluster (use values from the above command output):
```
terraform apply -var client_id="<appId>" -var client_secret="<password>"
```
Expand Down

0 comments on commit 6fe2a74

Please sign in to comment.