chore: Added VPC peering example (#283)

* Added basic firewall rule example

* Regenerated docs

* Fixes for output description and regenerated docs

* Added basic firewall rule example

* Regenerated docs

* Fixes for output description and regenerated docs

* Added comment about replacing project ID

* Added VPC peering example

* Moved files to correct directory and removed extraneous content from outputs

* Updated README

* Pinned basic VPC peering example to a version

Author: betsy-lichtenberg

examples/basic_vpc_peering/README.md

@@ -0,0 +1,19 @@
+# VPC network peering
+
+This example configures VPC network peering.
+
+<!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
+## Inputs
+
+| Name | Description | Type | Default | Required |
+|------|-------------|------|---------|:--------:|
+| local\_network | Self link to the local network. | `string` | n/a | yes |
+| peer\_network | Self link to the peer network. | `string` | n/a | yes |
+
+## Outputs
+
+| Name | Description |
+|------|-------------|
+| local\_network | The local network peering information |
+
+<!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->

examples/basic_vpc_peering/main.tf

@@ -0,0 +1,33 @@
+/**
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+
+provider "null" {
+  version = "~> 2.1"
+}
+
+provider "google" {
+  version = "~> 3.45.0"
+}
+
+# [START vpc_peering_create]
+module "peering1" {
+  source        = "terraform-google-modules/network/google//modules/network-peering"
+  version       = "~> 3.2.1"
+  local_network = var.local_network # Replace with self link to VPC network "foobar" in quotes
+  peer_network  = var.peer_network  # Replace with self link to VPC network "other" in quotes
+}
+# [END vpc_peering_create]

examples/basic_vpc_peering/outputs.tf

@@ -0,0 +1,23 @@
+/**
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+
+output "local_network" {
+  value       = module.peering1.local_network_peering
+  description = "The local network peering information"
+}
+
+

examples/basic_vpc_peering/variables.tf

@@ -0,0 +1,26 @@
+/**
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+variable "local_network" {
+  description = "Self link to the local network."
+  type        = string
+}
+
+variable "peer_network" {
+  description = "Self link to the peer network."
+  type        = string
+}
+

examples/basic_vpc_peering/versions.tf

@@ -0,0 +1,19 @@
+/**
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+terraform {
+  required_version = ">=0.12.6"
+}