This is the multi-page printable view of this section. Click here to print.
gcloud,
awscli, or az utility installed)All our Terraform modules and examples use a Helm 3 Module.
The last Code Blind release to include a Helm 2 module was 1.9.0.
Take the following steps to enable the Kubernetes Engine API:
To complete this quickstart, we can use either Google Cloud Shell or a local shell.
Google Cloud Shell is a shell environment for managing resources hosted on Google Cloud Platform (GCP). Cloud Shell comes preinstalled with the gcloud and kubectl command-line tools. gcloud provides the primary command-line interface for GCP, and kubectl provides the command-line interface for running commands against Kubernetes clusters.
If you prefer using your local shell, you must install the gcloud and kubectl command-line tools in your environment.
To launch Cloud Shell, perform the following steps:
gcloud and kubectl commands.us-west1-a. A full list can be found here.gcloud config set compute/zone [COMPUTE_ZONE]
To install gcloud and kubectl, perform the following steps:
gcloud command-line tool.Do you want to configure a default Compute Region and Zone? (Y/n)?, enter Y and choose a zone in your geographical region of choice.gcloud init
kubectl command-line tool by running the following command:gcloud components install kubectl
An example configuration can be found here: Terraform configuration with Code Blind submodule.
Copy this file into a local directory where you will execute the terraform commands.
The GKE cluster created from the example configuration will contain 3 Node Pools:
"default" node pool with "game-server" tag, containing 4 nodes."agones-system" node pool for Code Blind Controller."agones-metrics" for monitoring and metrics collecting purpose.Configurable parameters:
"default" node pool (default is true)["default"]). For example ["default", "xbox-gameservers", "mobile-gameservers"]On the lines that read source = "git::https://github.com/googleforgames/agones.git//install/terraform/modules/gke/?ref=main"
make sure to change ?ref=main to match your targeted Code Blind release, as Terraform modules can change between
releases.
For example, if you are targeting release-1.38.0, then you will want to have
source = "git::https://github.com/googleforgames/agones.git//install/terraform/modules/gke/?ref=release-1.38.0"
as your source.
In the directory where you created module.tf, run:
terraform init
This will cause terraform to clone the Code Blind repository and use the ./install/terraform folder as the starting point of
the Code Blind submodule, which contains all necessary Terraform configuration files.
Next, make sure that you can authenticate using gcloud:
gcloud auth application-default login
To create your GKE cluster in the default VPC just specify the project variable.
terraform apply -var project="<YOUR_GCP_ProjectID>"
To create the cluster in a custom VPC you must specify the project, network and subnetwork variables.
terraform apply -var project="<YOUR_GCP_ProjectID>" -var network="<YOUR_NETWORK_NAME>" -var subnetwork="<YOUR_SUBNETWORK_NAME>"
To verify that the cluster was created successfully, set up your kubectl credentials:
gcloud container clusters get-credentials --zone us-west1-c agones-terraform-example
Then check that you have access to the Kubernetes cluster:
kubectl get nodes
You should have 6 nodes in Ready state.
To delete all resources provisioned by Terraform:
terraform destroy -var project="<YOUR_GCP_ProjectID>"
You can use Terraform to provision your Amazon EKS (Elastic Kubernetes Service) cluster and install Code Blind on it using the Helm Terraform provider.
An example of the EKS submodule config file can be found here: Terraform configuration with Code Blind submodule
Copy this file into a separate folder.
Configure your AWS CLI tool CLI configure:
aws configure
Initialise your terraform:
terraform init
By editing modules.tf you can change the parameters that you need to. For instance, the - machine_type variable.
Configurable parameters:
["default"]). For example ["default", "xbox-gameservers", "mobile-gameservers"]Now you can create an EKS cluster and deploy Code Blind on EKS:
terraform apply [-var agones_version="1.38.0"]
After deploying the cluster with Code Blind, you can get or update your kubeconfig by using:
aws eks --region us-west-2 update-kubeconfig --name agones-cluster
With the following output:
Added new context arn:aws:eks:us-west-2:601646756426:cluster/agones-cluster to /Users/user/.kube/config
Switch kubectl context to the recently created one:
kubectl config use-context arn:aws:eks:us-west-2:601646756426:cluster/agones-cluster
Check that you are authenticated against the recently created Kubernetes cluster:
kubectl get nodes
Run the following commands to delete all Terraform provisioned resources:
terraform destroy -target module.helm_agones.helm_release.agones -auto-approve && sleep 60
terraform destroy
terraform destroy will timeout and never succeed.
Remove all created resources manually in that case, namely: 3 Auto Scaling groups, EKS cluster, and a VPC with all dependent resources.Install az utility by following these instructions.
The example of AKS submodule configuration could be found here: Terraform configuration with Code Blind submodule
Copy module.tf 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:
["default"]). For example ["default", "xbox-gameservers", "mobile-gameservers"]Run next command to delete all Terraform provisioned resources:
terraform destroy
Details on how you can authenticate your AKS terraform provider using official instructions.