terraform

FADI Terraform scripts

GKE provisioning

This repository contains a Terraform project that builds a Google Kubernetes Engine cluster with a custom node pool.

Deploy a Kubernetes Cluster (GKE) with Terraform

The creation of the infrastructure and its modifications are done with Terraform.

HashiCorp Terraform enables you to safely and predictably create, change, and improve infrastructure. It is an open source tool that codifies APIs into declarative configuration files that can be shared amongst team members, treated as code, edited, reviewed, and versioned.

Requirements

Before this module can be used in a project, you must ensure that the following pre-requisites are fulfilled:

Install:

• Terraform >= 0.9.0
• gcloud-sdk
• kubernetes-cli

1. Terraform and kubectl are installed on the machine where Terraform is executed.

2. The Service Account you execute the module with has the right permissions:

   • Create a service account with the following roles:
     • Add Kubernetes Engine Admin role.
     • Add Service Account User role
     • Add the Editor role.
     • Add the Storage Object Admin role (for Terraform tfstate bucket).
     • download the json key
   • Activate the service account to be used for auth:

   gcloud auth activate-service-account --key-file sa_gke.json
   

3. The Compute Engine and Kubernetes Engine APIs are active on the project you will launch the cluster in. Enable the GKE API.

4. If using a Shared VPC, the APIs must also be activated on the Shared VPC host project and your service account needs the proper permissions there.

5. Create a bucket to store the tfstate. (This step should be done with Terraform)

   gsutil mb -c regional -l europe-west1 gs://<your-project-id>-tfstate
   

Important note: The settings above are "loose", you will need to fine tune permissions and setup security measures depending on your deployment.

Usage

Then perform the following commands on the root folder:

1. Fill in your project id and change configuration to your liking in the terraform config file

2. Make sure the SA json key sa_gke.json is in this folder

3. terraform init to fetch the relevant plug-ins,

4. terraform plan to see the infrastructure plan

5. terraform apply to build the cluster,

6. gcloud auth activate-service-account --key-file sa_gke.json

7. gcloud config set project <your-project-id> set the current project,

8. gcloud container clusters list (to list clusters),

9. gcloud container clusters get-credentials gke-fadi --zone europe-west1-d to setup kubeconfig,

   Now you can access your cluster using the Kubernetes CLI: kubectl cluster-info.

10. terraform destroy to destroy the built infrastructure.