Intel® Cloud Optimization Modules for Terraform
© Copyright 2022, Intel Corporation
GCP GKE Module
This code base implements the GCP GKE Terraform Module available on Terraform registry (https://registry.terraform.io/modules/terraform-google-modules/kubernetes-engine/google/latest)
This example illustrates how to create a simple regional GKE kubernetes cluster within GCP. The cluster is created on Intel 4th gen Xeon Scalable processor called Sapphire Rapids. At the time of publication of this example, Intel's 4th gen Xeon Scalable processor is not globally available in GCP. It is available in public preview. Hence this example used the region us-central1 and availability zones us-central1-a, us-central1-b, and us-central1-c, where we confirmed with Google support team that C3-Highcpu-4 instances are available during public preview for our GCP project.
Once Saphhire Rapids is globally available in GCP, the GKE cluster can be created based on Sapphire Rapids based GCE instances in all regions where this new instance type will be available.
Usage
See the 'examples' folder for more details
#########################################################
# Local variables, modify for your needs #
#########################################################
# See policies.md for recommended instances
# General Purpose: n2-standard-2, n2-standard-4, n2-standard-8, n2-standard-16, n2-standard-32, n2-standard-48, n2-standard-64,
# n2-standard-80, n2-standard-96, n2-standard-128
# General Purpose: n2-highmem-2, n2-highmem-4, n2-highmem-8, n2-highmem-16, n2-highmem-32, n2-highmem-48, n2-highmem-64,
# n2-highmem-80, n2-highmem-96, n2-highmem-128
# General Purpose: n2-highcpu-2, n2-highcpu-4, n2-highcpu-8, n2-highcpu-16, n2-highcpu-32, n2-highcpu-48, n2-highcpu-64,
# n2-highcpu-80, n2-highcpu-96
# Compute Optimized: c2-standard-4, c2-standard-8, c2-standard-16, c2-standard-30, c2-standard-60, c3-highcpu-4, c3-highcpu-8,
# c3-highcpu-22, c3-highcpu-44, c3-highcpu-88, c3-highcpu-176
#Memory Optimized: m3-ultramem-32, m3-ultramem-64, m3-ultramem-128, m3-megamem-64, m3-megamem-128
locals {
cluster_type = "simple-regional"
# Update the project id that is specific to your own GCP environment
project_id = "your_own_gcp_project_id"
cluster_name_suffix = "-1"
region = "us-central1"
node_locations = ["us-central1-a", "us-central1-b", "us-central1-c"]
network = "default"
subnetwork = "default"
# Machine type is selected as Intel 4th gen Xeon Scalable processor called Sapphire Rapids
machine_type = "c3-highcpu-4"
#Auto scaling configurations, min_node_count is the minimum node count per zone, max_node_count is the max node count per zone
min_node_count = 1
max_node_count = 3
# For the selected network and subnetwork, there needs to exist secondary IP ranges for pods and a different secondary IP range for services. Make sure that these secondary
# IP ranges are setup in your network and remember to use the associated names of these IP ranges for ip_range_pods and ip_range_services defined below. In our example,
# we are caling these secondary ranges as k8s-pods and k8s-services
ip_range_pods = "k8s-pods" # replace with your own ip_range_pods value
ip_range_services = "k8s-services" # replace with your own ip_range_services value
# Update the compute engine service account below with your own compute engine service account
compute_engine_service_account = "123456789012-compute@developer.gserviceaccount.com"
enable_binary_authorization = false
skip_provisioners = false
}
data "google_client_config" "default" {}
provider "kubernetes" {
host = "https://${module.gke.endpoint}"
token = data.google_client_config.default.access_token
cluster_ca_certificate = base64decode(module.gke.ca_certificate)
}
module "gke" {
source = "terraform-google-modules/kubernetes-engine/google"
project_id = local.project_id
name = "${local.cluster_type}-cluster${local.cluster_name_suffix}"
regional = true
region = local.region
network = local.network
subnetwork = local.subnetwork
ip_range_pods = local.ip_range_pods
ip_range_services = local.ip_range_services
create_service_account = false
service_account = local.compute_engine_service_account
enable_cost_allocation = true
enable_binary_authorization = local.enable_binary_authorization
skip_provisioners = local.skip_provisioners
remove_default_node_pool = true
node_pools = [
# See recommended instance types for Intel Xeon 4th Generation Scalable processors (code-named Sapphire Rapids) above
{
name = "my-pool"
machine_type = local.machine_type
min_node_count = local.min_node_count
max_node_count = local.max_node_count
}
]
}
To provision this example, run the following from within this directory:
terraform init
to get the pluginsterraform plan
to see the infrastructure planterraform apply
to apply the infrastructure buildterraform destroy
to destroy the built infrastructure
Considerations
Under the locals block, you will need to update the following inputs:
- project_id: replace the project ID with your GCP project ID
- ip_range_pods: replace "k8s-pods" with the secondary ip range you want to use for your pods
- ip_range_services: replace "k8s-services" with the secondary ip range you want to use for your services
- network: currently set to default but you can replace it to the VPC network you want to host the cluster in
- subnetwork: currently set to default but you can replace it to the subnetwork you want to host the cluster in <<<<<<< HEAD
- region: replace "us-central1" with the region you want to host the cluster in
- node_locations: update the availability zones for your node locations in your GKE cluster based on the region and availability zones of your environment
- computer_engine_service_account: replace the service account with your service account to associate to the nodes in the cluster =======
- region: replace "us-east1" with the region you want to host the cluster in
- computer_engine_service_account: replace the service account with your service account to associate to the nodes in the cluster
Requirements
No requirements.
Providers
No providers.
Modules
No modules.
Resources
No resources.
Inputs
No inputs.
Outputs
No outputs.
54715507bc115126b102ee4e7200adb4184b926e