Installing Agones on Azure Kubernetes Service using Terraform

You can use Terraform to provision an AKS cluster and install Agones on it.


Install az utility by following these instructions.

The example of AKS submodule configuration could be found here: Terraform configuration with Agones submodule

Copy file into a separate folder.

Log in to Azure CLI:

az login

Configure your terraform:

terraform init

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>"

Once you created all resources on AKS you can get the credentials so that you can use kubectl to configure your cluster:

az aks get-credentials --resource-group agonesRG --name test-cluster

Check that you have access to the Kubernetes cluster:

kubectl get nodes

Configurable parameters:

  • log_level - possible values: Fatal, Error, Warn, Info, Debug (default is “info”)
  • cluster_name - the name of the AKS cluster (default is “agones-terraform-example”)
  • agones_version - the version of agones to install (an empty string, which is the default, is the latest version from the Helm repository)
  • machine_type - node machine type for hosting game servers (default is “Standard_D2_v2”)
  • disk_size - disk size of the node
  • region - the location of the cluster
  • node_count - count of game server nodes for the default node pool (default is “4”)
  • feature_gates - a list of alpha and beta version features to enable. For example, “PlayerTracking=true&ContainerPortAllocation=true”
  • gameserver_minPort - the lower bound of the port range which gameservers will listen on (default is “7000”)
  • gameserver_maxPort - the upper bound of the port range which gameservers will listen on (default is “8000”)
  • gameserver_namespaces - a list of namespaces which will be used to run gameservers (default is ["default"]). For example ["default", "xbox-gameservers", "mobile-gameservers"]
  • force_update - whether or not to force the replacement/update of resource (default is true, false may be required to prevent immutability errors when updating the configuration)

Uninstall the Agones and delete AKS cluster

Run next command to delete all Terraform provisioned resources:

terraform destroy


Details on how you can authenticate your AKS terraform provider using official instructions.

Next Steps

Last modified June 13, 2024: Change Slack channel description from #developers to #development (#3868) (b37fc35)