feat(examples/vpc_peering_common_dual_stack): IPv4/IPv6 dual stack architecture example

examples/vpc_peering_common_dual_stack/main.tf

@@ -0,0 +1,273 @@
+module "iam_service_account" {
+  source = "../../modules/iam_service_account"
+
+  for_each = var.service_accounts
+
+  service_account_id = "${var.name_prefix}${each.value.service_account_id}"
+  display_name       = "${var.name_prefix}${each.value.display_name}"
+  roles              = each.value.roles
+  project_id         = var.project
+}
+
+resource "local_file" "bootstrap_xml" {
+
+  for_each = { for k, v in var.vmseries : k => v
+    if can(v.bootstrap_template_map)
+  }
+
+  filename = "files/${each.key}/config/bootstrap.xml"
+  content = templatefile("templates/bootstrap_common.tmpl",
+    {
+      trust_gcp_router_ip   = each.value.bootstrap_template_map.trust_gcp_router_ip
+      private_network_cidr  = each.value.bootstrap_template_map.private_network_cidr
+      untrust_gcp_router_ip = each.value.bootstrap_template_map.untrust_gcp_router_ip
+      trust_loopback_ip     = each.value.bootstrap_template_map.trust_loopback_ip
+      untrust_loopback_ip   = each.value.bootstrap_template_map.untrust_loopback_ip
+      trust_loopback_ipv6   = each.value.bootstrap_template_map.trust_loopback_ipv6
+      untrust_loopback_ipv6 = each.value.bootstrap_template_map.untrust_loopback_ipv6
+    }
+  )
+}
+
+resource "local_sensitive_file" "init_cfg" {
+
+  for_each = { for k, v in var.vmseries : k => v
+    if can(v.bootstrap_template_map)
+  }
+
+  filename = "files/${each.key}/config/init-cfg.txt"
+  content = templatefile(
+    "templates/init-cfg.tmpl",
+    { bootstrap_options = merge(var.vmseries_common.bootstrap_options, each.value.bootstrap_options) }
+  )
+}
+
+module "bootstrap" {
+  source = "../../modules/bootstrap"
+
+  for_each = var.bootstrap_buckets
+
+  folders = keys(var.vmseries)
+
+  name_prefix     = "${var.name_prefix}${each.value.bucket_name_prefix}"
+  service_account = module.iam_service_account[each.value.service_account_key].email
+  location        = each.value.location
+  files = merge(
+    { for k, v in var.vmseries : "files/${k}/config/bootstrap.xml" => "${k}/config/bootstrap.xml" if can(v.bootstrap_template_map) },
+    { for k, v in var.vmseries : "files/${k}/config/init-cfg.txt" => "${k}/config/init-cfg.txt" if can(v.bootstrap_template_map) },
+  )
+}
+
+module "vpc" {
+  source = "../../modules/vpc"
+
+  for_each = var.networks
+
+  project_id                      = var.project
+  name                            = "${var.name_prefix}${each.value.vpc_name}"
+  create_network                  = each.value.create_network
+  delete_default_routes_on_create = each.value.delete_default_routes_on_create
+  mtu                             = each.value.mtu
+  routing_mode                    = each.value.routing_mode
+  enable_ula_internal_ipv6        = try(each.value.enable_ula_internal_ipv6, false)
+  internal_ipv6_range             = try(each.value.internal_ipv6_range, null)
+  subnetworks = { for k, v in each.value.subnetworks : k => merge(v, {
+    name = "${var.name_prefix}${v.name}"
+    })
+  }
+  firewall_rules = try({ for k, v in each.value.firewall_rules : k => merge(v, {
+    name = "${var.name_prefix}${v.name}"
+    })
+  }, {})
+}
+
+resource "google_compute_route" "this" {
+
+  for_each = var.routes
+
+  name         = "${var.name_prefix}${each.value.name}"
+  dest_range   = each.value.destination_range
+  network      = module.vpc[each.value.vpc_network_key].network.self_link
+  next_hop_ilb = module.lb_internal[each.value.lb_internal_key].forwarding_rule
+  priority     = 100
+}
+
+resource "null_resource" "policy_routes" {
+  for_each = var.policy_routes
+
+  triggers = {
+    project = var.project
+    name    = "${var.name_prefix}${each.key}-pbr"
+  }
+  provisioner "local-exec" {
+    command = join(" ", [
+      "gcloud beta network-connectivity policy-based-routes create ${self.triggers.name}",
+      "--priority=90",
+      "--source-range=::/0",
+      "--destination-range=::/0",
+      "--ip-protocol=ALL",
+      "--protocol-version=IPv6",
+      "--network=${module.vpc[each.value.vpc_network_key].network.id}",
+      "--next-hop-ilb-ip=${split("/", module.lb_internal[each.value.lb_internal_key].address)[0]}",
+      "--description=Policy-based-route-for-IPv6-outbound-connectivity",
+      "--project ${var.project}"
+    ])
+    interpreter = ["bash", "-c"]
+  }
+  provisioner "local-exec" {
+    when        = destroy
+    command     = "gcloud beta network-connectivity policy-based-routes delete ${self.triggers.name} --project ${self.triggers.project} --quiet || true"
+    interpreter = ["bash", "-c"]
+  }
+}
+
+resource "null_resource" "pbr_override_vmseries" {
+  triggers = {
+    project = var.project
+    name    = "${var.name_prefix}pbr-override-vmseries"
+  }
+  provisioner "local-exec" {
+    command = join(" ", [
+      "gcloud beta network-connectivity policy-based-routes create ${self.triggers.name}",
+      "--priority=10",
+      "--tags=vmseries",
+      "--ip-protocol=ALL",
+      "--protocol-version=IPv6",
+      "--network=${module.vpc[var.policy_routes_trust_vpc_network_key].network.id}",
+      "--next-hop-other-routes=DEFAULT_ROUTING",
+      "--description=Use-DEFAULT_ROUTING-for-packets-coming-from-VM-Series",
+      "--project ${var.project}"
+    ])
+  }
+  provisioner "local-exec" {
+    when    = destroy
+    command = "gcloud beta network-connectivity policy-based-routes delete ${self.triggers.name} --project ${self.triggers.project} --quiet || true"
+  }
+}
+
+module "vpc_peering" {
+  source = "../../modules/vpc-peering"
+
+  for_each = var.vpc_peerings
+
+  local_network = module.vpc[each.value.local_network_key].network.id
+  peer_network  = module.vpc[each.value.peer_network_key].network.id
+
+  local_export_custom_routes                = each.value.local_export_custom_routes
+  local_import_custom_routes                = each.value.local_import_custom_routes
+  local_export_subnet_routes_with_public_ip = each.value.local_export_subnet_routes_with_public_ip
+  local_import_subnet_routes_with_public_ip = each.value.local_import_subnet_routes_with_public_ip
+
+  peer_export_custom_routes                = each.value.peer_export_custom_routes
+  peer_import_custom_routes                = each.value.peer_import_custom_routes
+  peer_export_subnet_routes_with_public_ip = each.value.peer_export_subnet_routes_with_public_ip
+  peer_import_subnet_routes_with_public_ip = each.value.peer_import_subnet_routes_with_public_ip
+  stack_type                               = each.value.stack_type
+}
+
+module "vmseries" {
+  source = "../../modules/vmseries"
+
+  for_each = var.vmseries
+
+  name                  = "${var.name_prefix}${each.value.name}"
+  zone                  = each.value.zone
+  ssh_keys              = try(each.value.ssh_keys, var.vmseries_common.ssh_keys)
+  vmseries_image        = try(each.value.vmseries_image, var.vmseries_common.vmseries_image)
+  machine_type          = try(each.value.machine_type, var.vmseries_common.machine_type)
+  min_cpu_platform      = try(each.value.min_cpu_platform, var.vmseries_common.min_cpu_platform, "Intel Cascade Lake")
+  tags                  = try(each.value.tags, var.vmseries_common.tags, [])
+  service_account       = try(module.iam_service_account[each.value.service_account_key].email, module.iam_service_account[var.vmseries_common.service_account_key].email)
+  scopes                = try(each.value.scopes, var.vmseries_common.scopes, [])
+  create_instance_group = true
+
+  bootstrap_options = try(
+    merge(
+      { vmseries-bootstrap-gce-storagebucket = "${module.bootstrap[each.value.bootstrap_bucket_key].bucket_name}/${each.key}/" },
+    var.vmseries_common.bootstrap_options),
+    merge(
+      try(each.value.bootstrap_options, {}),
+      try(var.vmseries_common.bootstrap_options, {})
+  ))
+
+  named_ports = try(each.value.named_ports, [])
+
+  network_interfaces = [for v in each.value.network_interfaces :
+    {
+      subnetwork         = module.vpc[v.vpc_network_key].subnetworks[v.subnetwork_key].self_link
+      stack_type         = try(v.stack_type, null)
+      private_ip         = v.private_ip
+      create_public_ip   = try(v.create_public_ip, false)
+      public_ip          = try(v.public_ip, null)
+      create_public_ipv6 = try(v.create_public_ipv6, false)
+      public_ipv6        = try(v.public_ipv6, null)
+  }]
+}
+
+data "google_compute_image" "my_image" {
+  family  = "ubuntu-pro-2204-lts"
+  project = "ubuntu-os-pro-cloud"
+}
+
+resource "google_compute_instance" "linux_vm" {
+  for_each = var.linux_vms
+
+  name         = "${var.name_prefix}${each.key}"
+  machine_type = each.value.linux_machine_type
+  zone         = each.value.zone
+
+  boot_disk {
+    initialize_params {
+      image = data.google_compute_image.my_image.id
+      size  = each.value.linux_disk_size
+    }
+  }
+
+  network_interface {
+    subnetwork = module.vpc[each.value.vpc_network_key].subnetworks[each.value.subnetwork_key].self_link
+    stack_type = each.value.stack_type
+    network_ip = each.value.private_ip
+  }
+
+  metadata = {
+    enable-oslogin = true
+  }
+
+
+  service_account {
+    email  = module.iam_service_account[each.value.service_account_key].email
+    scopes = each.value.scopes
+  }
+}
+
+module "lb_internal" {
+  source = "../../modules/lb_internal"
+
+  for_each = var.lbs_internal
+
+  name              = "${var.name_prefix}${each.value.name}"
+  region            = var.region
+  health_check_port = try(each.value.health_check_port, "80")
+  backends          = { for v in each.value.backends : v => module.vmseries[v].instance_group_self_link }
+  ip_version        = lookup(each.value, "ip_version", null)
+  ip_address        = each.value.ip_address
+  subnetwork        = module.vpc[each.value.vpc_network_key].subnetworks[each.value.subnetwork_key].self_link
+  network           = module.vpc[each.value.vpc_network_key].network.self_link
+  all_ports         = true
+}
+
+module "lb_external" {
+  source = "../../modules/lb_external"
+
+  for_each = var.lbs_external
+
+  project = var.project
+
+  name                    = "${var.name_prefix}${each.value.name}"
+  backend_instance_groups = { for v in each.value.backends : v => module.vmseries[v].instance_group_self_link }
+  rules                   = { for k, v in each.value.rules : "${var.name_prefix}${k}" => v }
+  subnetwork              = try(module.vpc[each.value.vpc_network_key].subnetworks[each.value.subnetwork_key].self_link, null)
+
+  health_check_http_port         = each.value.http_health_check_port
+  health_check_http_request_path = try(each.value.http_health_check_request_path, "/php/login.php")
+}

examples/vpc_peering_common_dual_stack/main_test.go

@@ -0,0 +1,65 @@
+package vpc_peering_common_dual_stack
+
+import (
+	"log"
+	"testing"
+
+	"github.com/PaloAltoNetworks/terraform-modules-swfw-tests-skeleton/pkg/testskeleton"
+	"github.com/gruntwork-io/terratest/modules/logger"
+	"github.com/gruntwork-io/terratest/modules/terraform"
+)
+
+func CreateTerraformOptions(t *testing.T) *terraform.Options {
+	varsInfo, err := testskeleton.GenerateTerraformVarsInfo("gcp")
+	if err != nil {
+		// Handle the error
+		log.Fatalf("Error generating terraform vars info: %v", err)
+	}
+
+	// define options for Terraform
+	terraformOptions := terraform.WithDefaultRetryableErrors(t, &terraform.Options{
+		TerraformDir: ".",
+		VarFiles:     []string{"example.tfvars"},
+		Vars: map[string]interface{}{
+			"name_prefix": varsInfo.NamePrefix,
+			"project":     varsInfo.GoogleProjectId,
+		},
+		Logger:               logger.Default,
+		Lock:                 true,
+		Upgrade:              true,
+		SetVarsAfterVarFiles: true,
+	})
+
+	return terraformOptions
+}
+
+func TestValidate(t *testing.T) {
+	testskeleton.ValidateCode(t, nil)
+}
+
+func TestPlan(t *testing.T) {
+	// define options for Terraform
+	terraformOptions := CreateTerraformOptions(t)
+	// prepare list of items to check
+	assertList := []testskeleton.AssertExpression{}
+	// plan test infrastructure and verify outputs
+	testskeleton.PlanInfraCheckErrors(t, terraformOptions, assertList, "No errors are expected")
+}
+
+func TestApply(t *testing.T) {
+	// define options for Terraform
+	terraformOptions := CreateTerraformOptions(t)
+	// prepare list of items to check
+	assertList := []testskeleton.AssertExpression{}
+	// deploy test infrastructure and verify outputs and check if there are no planned changes after deployment
+	testskeleton.DeployInfraCheckOutputs(t, terraformOptions, assertList)
+}
+
+func TestIdempotence(t *testing.T) {
+	// define options for Terraform
+	terraformOptions := CreateTerraformOptions(t)
+	// prepare list of items to check
+	assertList := []testskeleton.AssertExpression{}
+	// deploy test infrastructure and verify outputs and check if there are no planned changes after deployment
+	testskeleton.DeployInfraCheckOutputsVerifyChanges(t, terraformOptions, assertList)
+}

examples/vpc_peering_common_dual_stack/outputs.tf

@@ -0,0 +1,38 @@
+output "vmseries_private_ips" {
+  description = "Private IPv4 addresses of the VM-Series instances."
+  value       = { for k, v in module.vmseries : k => v.private_ips }
+}
+
+output "vmseries_ipv6_private_ips" {
+  description = "Private IPv6 addresses of the VM-Series instances."
+  value       = { for k, v in module.vmseries : k => v.ipv6_private_ips }
+}
+
+output "vmseries_public_ips" {
+  description = "Public IPv4 addresses of the VM-Series instances."
+  value       = { for k, v in module.vmseries : k => v.public_ips }
+}
+
+output "vmseries_ipv6_public_ips" {
+  description = "Public IPv6 addresses of the VM-Series instances."
+  value       = { for k, v in module.vmseries : k => v.ipv6_public_ips }
+}
+
+output "lbs_internal_ips" {
+  description = "Private IP addresses of internal network loadbalancers."
+  value       = { for k, v in module.lb_internal : k => try(split("/", v.address)[0], v.address, null) }
+}
+
+output "lbs_external_ips" {
+  description = "Public IP addresses of external network loadbalancers."
+  value = flatten([for k1, v1 in module.lb_external : [
+    for k2, v2 in v1.ip_addresses : {
+      (k2) = try(split("/", v2)[0], v2, null)
+    }]
+  ])
+}
+
+output "linux_vm_ips" {
+  description = "Private IP addresses of Linux VMs."
+  value       = { for k, v in resource.google_compute_instance.linux_vm : k => v.network_interface[0].network_ip }
+}