chore: Added example for creating internal IP address in shared subnet (#279)

Author: betsy-lichtenberg

examples/basic_shared_vpc/README.md

@@ -1,10 +1,15 @@
-# Simple Project
+# Simple shared VPC Project
 
-This example enables shared VPC on a host project and attaches a service project.
+This example:
 
-#  Custom mode network
+* Enables shared VPC on a host project
+* Attaches a service project
+* Reserves an internal IP address in a subnet of a Shared VPC network
+
+Note that the IP address configuration object is created in the service
+project, while its value comes from the range of available addresses in
+the chosen shared subnet.
 
-This example configures a single simple custom mode VPC network inside of a project.
 
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
@@ -18,7 +23,10 @@ This example configures a single simple custom mode VPC network inside of a proj
 
 | Name | Description |
 |------|-------------|
+| ip\_address | The internal IP address |
+| ip\_address\_name | The name of the internal IP |
 | project | Host project ID |
 | service\_project | Service project ID |
+| subnet | Name of the host subnet |
 
 <!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->

examples/basic_shared_vpc/main.tf

@@ -36,3 +36,20 @@ resource "google_compute_shared_vpc_service_project" "service1" {
 }
 # [END vpc_shared_vpc_service_project_attach]
 
+# [START compute_shared_internal_ip_create]
+data "google_compute_subnetwork" "subnet" {
+  name    = "my-subnet-123"
+  project = var.project
+  region  = "us-central1"
+}
+
+resource "google_compute_address" "internal" {
+  project      = var.service_project
+  region       = "us-central1"
+  name         = "int-ip"
+  address_type = "INTERNAL"
+  address      = "10.0.0.1"
+  subnetwork   = data.google_compute_subnetwork.subnet.self_link
+}
+# [END compute_shared_internal_ip_create]
+

examples/basic_shared_vpc/outputs.tf

@@ -23,3 +23,18 @@ output "service_project" {
   value       = google_compute_shared_vpc_service_project.service1.service_project
   description = "Service project ID"
 }
+
+output "ip_address_name" {
+  value       = google_compute_address.internal.name
+  description = "The name of the internal IP"
+}
+
+output "subnet" {
+  value       = google_compute_address.internal.subnetwork
+  description = "Name of the host subnet"
+}
+
+output "ip_address" {
+  value       = google_compute_address.internal.address
+  description = "The internal IP address"
+}

examples/basic_shared_vpc/variables.tf

@@ -21,3 +21,4 @@ variable "project" {
 variable "service_project" {
   description = "The service project ID"
 }
+