feat: support gVNIC (#1296)

Co-authored-by: Bharath KKB <bharathkrishnakb@gmail.com>

Author: anoxape

README.md

@@ -60,6 +60,7 @@ module "gke" {
  disk_type = "pd-standard"
  image_type = "COS_CONTAINERD"
  enable_gcfs = false
+ enable_gvnic = false
  auto_repair = true
  auto_upgrade = true
  service_account = "project-service-account@<PROJECT ID>.iam.gserviceaccount.com"
@@ -239,6 +240,7 @@ The node_pools variable takes the following parameters:
 | disk_type | Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd') | pd-standard | Optional |
 | effect | Effect for the taint | | Required |
 | enable_gcfs | Google Container File System (gcfs) has to be enabled for image streaming to be active. Needs image_type to be set to COS_CONTAINERD. | false | Optional |
+| enable_gvnic | gVNIC (GVE) is an alternative to the virtIO-based ethernet driver. Needs a Container-Optimized OS node image. | false | Optional |
 | enable_integrity_monitoring | Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. | true | Optional |
 | enable_secure_boot | Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. | false | Optional |
 | gpu_partition_size | Size of partitions to create on the GPU | null | Optional |

autogen/main/README.md

@@ -109,6 +109,7 @@ module "gke" {
  disk_type = "pd-standard"
  image_type = "COS_CONTAINERD"
  enable_gcfs = false
+ enable_gvnic = false
  auto_repair = true
  auto_upgrade = true
  service_account = "project-service-account@<PROJECT ID>.iam.gserviceaccount.com"
@@ -196,6 +197,7 @@ The node_pools variable takes the following parameters:
 | disk_type | Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd') | pd-standard | Optional |
 | effect | Effect for the taint | | Required |
 | enable_gcfs | Google Container File System (gcfs) has to be enabled for image streaming to be active. Needs image_type to be set to COS_CONTAINERD. | false | Optional |
+| enable_gvnic | gVNIC (GVE) is an alternative to the virtIO-based ethernet driver. Needs a Container-Optimized OS node image. | false | Optional |
 | enable_integrity_monitoring | Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. | true | Optional |
 | enable_secure_boot | Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. | false | Optional |
 | gpu_partition_size | Size of partitions to create on the GPU | null | Optional |

autogen/main/cluster.tf.tmpl

@@ -311,6 +311,13 @@ resource "google_container_cluster" "primary" {
  }
  }
 
+ dynamic "gvnic" {
+ for_each = lookup(var.node_pools[0], "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
+
  service_account = lookup(var.node_pools[0], "service_account", local.service_account)
 
  tags = concat(
@@ -447,6 +454,7 @@ locals {
  "spot",
  "service_account",
  "enable_gcfs",
+ "enable_gvnic",
  "enable_secure_boot",
  ]
 }
@@ -598,6 +606,12 @@ resource "google_container_node_pool" "pools" {
  enabled = gcfs_config.value
  }
  }
+ dynamic "gvnic" {
+ for_each = lookup(each.value, "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
  labels = merge(
  lookup(lookup(local.node_pools_labels, "default_values", {}), "cluster_name", true) ? { "cluster_name" = var.name } : {},
  lookup(lookup(local.node_pools_labels, "default_values", {}), "node_pool", true) ? { "node_pool" = each.value["name"] } : {},

cluster.tf

@@ -181,6 +181,13 @@ resource "google_container_cluster" "primary" {
  }
  }
 
+ dynamic "gvnic" {
+ for_each = lookup(var.node_pools[0], "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
+
  service_account = lookup(var.node_pools[0], "service_account", local.service_account)
 
  tags = concat(
@@ -307,6 +314,12 @@ resource "google_container_node_pool" "pools" {
  enabled = gcfs_config.value
  }
  }
+ dynamic "gvnic" {
+ for_each = lookup(each.value, "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
  labels = merge(
  lookup(lookup(local.node_pools_labels, "default_values", {}), "cluster_name", true) ? { "cluster_name" = var.name } : {},
  lookup(lookup(local.node_pools_labels, "default_values", {}), "node_pool", true) ? { "node_pool" = each.value["name"] } : {},

modules/beta-private-cluster-update-variant/README.md

@@ -92,6 +92,7 @@ module "gke" {
  disk_type = "pd-standard"
  image_type = "COS_CONTAINERD"
  enable_gcfs = false
+ enable_gvnic = false
  auto_repair = true
  auto_upgrade = true
  service_account = "project-service-account@<PROJECT ID>.iam.gserviceaccount.com"
@@ -313,6 +314,7 @@ The node_pools variable takes the following parameters:
 | disk_type | Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd') | pd-standard | Optional |
 | effect | Effect for the taint | | Required |
 | enable_gcfs | Google Container File System (gcfs) has to be enabled for image streaming to be active. Needs image_type to be set to COS_CONTAINERD. | false | Optional |
+| enable_gvnic | gVNIC (GVE) is an alternative to the virtIO-based ethernet driver. Needs a Container-Optimized OS node image. | false | Optional |
 | enable_integrity_monitoring | Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. | true | Optional |
 | enable_secure_boot | Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. | false | Optional |
 | gpu_partition_size | Size of partitions to create on the GPU | null | Optional |

modules/beta-private-cluster-update-variant/cluster.tf

@@ -274,6 +274,13 @@ resource "google_container_cluster" "primary" {
  }
  }
 
+ dynamic "gvnic" {
+ for_each = lookup(var.node_pools[0], "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
+
  service_account = lookup(var.node_pools[0], "service_account", local.service_account)
 
  tags = concat(
@@ -394,6 +401,7 @@ locals {
  "spot",
  "service_account",
  "enable_gcfs",
+ "enable_gvnic",
  "enable_secure_boot",
  ]
 }
@@ -531,6 +539,12 @@ resource "google_container_node_pool" "pools" {
  enabled = gcfs_config.value
  }
  }
+ dynamic "gvnic" {
+ for_each = lookup(each.value, "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
  labels = merge(
  lookup(lookup(local.node_pools_labels, "default_values", {}), "cluster_name", true) ? { "cluster_name" = var.name } : {},
  lookup(lookup(local.node_pools_labels, "default_values", {}), "node_pool", true) ? { "node_pool" = each.value["name"] } : {},

modules/beta-private-cluster/README.md

@@ -70,6 +70,7 @@ module "gke" {
  disk_type = "pd-standard"
  image_type = "COS_CONTAINERD"
  enable_gcfs = false
+ enable_gvnic = false
  auto_repair = true
  auto_upgrade = true
  service_account = "project-service-account@<PROJECT ID>.iam.gserviceaccount.com"
@@ -291,6 +292,7 @@ The node_pools variable takes the following parameters:
 | disk_type | Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd') | pd-standard | Optional |
 | effect | Effect for the taint | | Required |
 | enable_gcfs | Google Container File System (gcfs) has to be enabled for image streaming to be active. Needs image_type to be set to COS_CONTAINERD. | false | Optional |
+| enable_gvnic | gVNIC (GVE) is an alternative to the virtIO-based ethernet driver. Needs a Container-Optimized OS node image. | false | Optional |
 | enable_integrity_monitoring | Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. | true | Optional |
 | enable_secure_boot | Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. | false | Optional |
 | gpu_partition_size | Size of partitions to create on the GPU | null | Optional |

modules/beta-private-cluster/cluster.tf

@@ -274,6 +274,13 @@ resource "google_container_cluster" "primary" {
  }
  }
 
+ dynamic "gvnic" {
+ for_each = lookup(var.node_pools[0], "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
+
  service_account = lookup(var.node_pools[0], "service_account", local.service_account)
 
  tags = concat(
@@ -443,6 +450,12 @@ resource "google_container_node_pool" "pools" {
  enabled = gcfs_config.value
  }
  }
+ dynamic "gvnic" {
+ for_each = lookup(each.value, "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
  labels = merge(
  lookup(lookup(local.node_pools_labels, "default_values", {}), "cluster_name", true) ? { "cluster_name" = var.name } : {},
  lookup(lookup(local.node_pools_labels, "default_values", {}), "node_pool", true) ? { "node_pool" = each.value["name"] } : {},

modules/beta-public-cluster-update-variant/README.md

@@ -86,6 +86,7 @@ module "gke" {
  disk_type = "pd-standard"
  image_type = "COS_CONTAINERD"
  enable_gcfs = false
+ enable_gvnic = false
  auto_repair = true
  auto_upgrade = true
  service_account = "project-service-account@<PROJECT ID>.iam.gserviceaccount.com"
@@ -300,6 +301,7 @@ The node_pools variable takes the following parameters:
 | disk_type | Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd') | pd-standard | Optional |
 | effect | Effect for the taint | | Required |
 | enable_gcfs | Google Container File System (gcfs) has to be enabled for image streaming to be active. Needs image_type to be set to COS_CONTAINERD. | false | Optional |
+| enable_gvnic | gVNIC (GVE) is an alternative to the virtIO-based ethernet driver. Needs a Container-Optimized OS node image. | false | Optional |
 | enable_integrity_monitoring | Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. | true | Optional |
 | enable_secure_boot | Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. | false | Optional |
 | gpu_partition_size | Size of partitions to create on the GPU | null | Optional |

modules/beta-public-cluster-update-variant/cluster.tf

@@ -274,6 +274,13 @@ resource "google_container_cluster" "primary" {
  }
  }
 
+ dynamic "gvnic" {
+ for_each = lookup(var.node_pools[0], "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
+
  service_account = lookup(var.node_pools[0], "service_account", local.service_account)
 
  tags = concat(
@@ -375,6 +382,7 @@ locals {
  "spot",
  "service_account",
  "enable_gcfs",
+ "enable_gvnic",
  "enable_secure_boot",
  ]
 }
@@ -512,6 +520,12 @@ resource "google_container_node_pool" "pools" {
  enabled = gcfs_config.value
  }
  }
+ dynamic "gvnic" {
+ for_each = lookup(each.value, "enable_gvnic", false) ? [true] : []
+ content {
+ enabled = gvnic.value
+ }
+ }
  labels = merge(
  lookup(lookup(local.node_pools_labels, "default_values", {}), "cluster_name", true) ? { "cluster_name" = var.name } : {},
  lookup(lookup(local.node_pools_labels, "default_values", {}), "node_pool", true) ? { "node_pool" = each.value["name"] } : {},