Create clusters and node pools with Arm nodes

gcloud

Create a new zonal cluster with the default node pool using Arm nodes:

gcloud container clusters create CLUSTER_NAME \
    --zone ZONE  \
    --node-locations NODE_LOCATIONS \
    --machine-type T2A_MACHINE_TYPE \
    --num-nodes NUM_NODES

Replace the following:

• CLUSTER_NAME: the name of your new cluster with an Arm node pool.
• ZONE: the zone for your cluster, such as us-central1-a. The zone must be one of the available zones for the Tau T2A machine series. To create a regional cluster, use the --region=REGION flag. The region must be one of the available regions for the Tau T2A machine series.
• NODE_LOCATIONS: the zone(s) for your node pool, such as us-central1-a. You must choose from the available zones for the Tau T2A machine series or node pool creation might fail.
• T2A_MACHINE_TYPE: one of the available T2A machine shapes, such as t2a-standard-16.
• NUM_NODES: the number of nodes for your Arm node pool.

If you want to set additional settings for your cluster, see the gcloud container clusters create reference for a complete list of available settings on cluster creation.

Console

1. Go to the Google Kubernetes Engine page in the Google Cloud console.

   Go to Google Kubernetes Engine

2. Click add_box Create.

3. Configure your cluster as desired. For more information, see the instructions for Creating a zonal cluster, or Creating a regional cluster.

4. Choose a location where Arm nodes are available.

   1. In the Cluster basics section, under Location type, choose Zonal or Regional:
   2. In the dropdown menu, choose a zone or region where Arm nodes are available.
   3. Check the box to Specify default node locations. Select zone(s) where Arm nodes are available.

5. To select an Arm machine type, in the Nodes subsection, under Configure node settings > Machine configuration > Machine family, select GENERAL-PURPOSE. In the Series dropdown menu, select T2A. In the Machine type dropdown menu, choose from the available options.

6. Click Create.

Terraform

To create a zonal cluster with the default node pool using Arm nodes using Terraform, refer to the following example:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-arm-cluster"
  location           = "us-central1-a"
  node_locations     = ["us-central1-b", "us-central1-f"]
  initial_node_count = 2

  node_config {
    machine_type    = "t2a-standard-1"
    service_account = google_service_account.default.email
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

To learn more about using Terraform, see Terraform support for GKE.

gcloud

Add an Arm node pool to an existing cluster:

gcloud container node-pools create NODE_POOL_NAME \
    --cluster CLUSTER_NAME \
    --zone ZONE \
    --node-locations NODE_LOCATIONS \
    --machine-type T2A_MACHINE_TYPE \
    --num-nodes NUM_NODES \
    --service-account SERVICE_ACCOUNT

Replace the following:

• NODE_POOL_NAME: the name of the new Arm node pool for your existing cluster.
• ZONE: the zone of the existing cluster. For a regional cluster, use the --region=REGION flag with the region of the cluster.
• CLUSTER_NAME: the name of the cluster where you want to add an Arm node pool.
• NODE_LOCATIONS: the zone(s) for your node pool, such as us-central1-a. You must choose from the available zones for the Tau T2A machine series or node pool creation might fail.
• T2A_MACHINE_TYPE: one of the available T2A machine shapes, such as t2a-standard-16.
• NUM_NODES: the number of nodes for your Arm node pool.
• SERVICE_ACCOUNT: the name of the IAM service account for your nodes to use. If omitted, the node pool uses the Compute Engine default service account.

If you want to set additional settings for your node pool, see the gcloud container node-pools create reference for a complete list of available settings on node pool creation.

Console

To add an Arm node pool to an existing cluster, perform the following steps:

1. Go to the Google Kubernetes Engine page in the Google Cloud console.

   Go to Google Kubernetes Engine

2. In the cluster list, click the name of the cluster you want to modify.

3. Click add_box Add node pool.

4. Configure your node pool.

5. Choose node locations where Arm nodes are available.

   1. In the Node pool details section, check the Specify node locations box.
   2. Select zone(s) where Arm nodes are available.

6. To select an Arm machine type, in the Nodes subsection, under Configure node settings > Machine configuration > Machine family, select GENERAL-PURPOSE. In the Series dropdown menu, select T2A. In the Machine type dropdown menu, choose from the available options.

7. In the navigation menu, click Security.

8. In the Service account drop-down menu, select the IAM service account for your node pool to use. By default, the node pool uses the Compute Engine default service account.

9. Click Create to add the node pool.

Terraform

To add a node pool that uses Arm nodes to an existing cluster using Terraform, refer to the following example:

resource "google_container_node_pool" "default" {
  name           = "gke-standard-zonal-arm-node-pool"
  cluster        = google_container_cluster.default.id
  node_locations = ["us-central1-a"]
  node_count     = 1

  node_config {
    machine_type = "t2a-standard-1"

    service_account = google_service_account.default.email
  }
}

Replace google_container_cluster.default.id with the name of your cluster.

To learn more about using Terraform, see Terraform support for GKE.