Skip to content

Latest commit

 

History

History
375 lines (271 loc) · 13.3 KB

README.md

File metadata and controls

375 lines (271 loc) · 13.3 KB

LAB A: Hub and Spoke with HA VPN to On-premises

Contents

Overview

In this lab:

  • A hub and spoke architecure with two spokes.
  • All north-south and east-west traffic are allowed via VPC firewall rules.
  • Hybrid connectivity to simulated on-premises sites is achieved using HA VPN.
  • Network Connectivity Center (NCC) is used to connect the on-premises sites together via the external Hub VPC.
  • Other networking features such as Cloud DNS, PSC for Google APIs and load balancers are also deployed in this lab.

Hub and Spoke

Prerequisites

Ensure you meet all requirements in the prerequisites before proceeding.

Deploy the Lab

  1. Clone the Git Repository for the Labs

    git clone https://github.com/kaysalawu/gcp-network-terraform.git

  2. Navigate to the lab directory

    cd gcp-network-terraform/1-blueprints-a-standard

  3. (Optional) If you want to enable additional features such as IPv6, VPC flow logs and logging set the following variables to true in the 01-main.tf file.

    Variable Description Default Link
    enable_ipv6 Enable IPv6 on all supported resources false main.tf

  4. Run the following terraform commands and type yes at the prompt:

    terraform init
terraform plan
terraform apply -parallelism=50

Troubleshooting

See the troubleshooting section for tips on how to resolve common issues that may occur during the deployment of the lab.

Outputs

The table below shows the auto-generated output files from the lab. They are located in the _output directory.

Item Description Location
Hub Unbound DNS Unbound DNS configuration _output/hub-unbound.sh
Site1 Unbound DNS Unbound DNS configuration _output/site1-unbound.sh
Site2 Unbound DNS Unbound DNS configuration _output/site2-unbound.sh
Web server Python Flask web server, test scripts _output/vm-startup.sh

Testing

Each virtual machine (VM) is pre-configured with a shell script to run various types of network reachability tests. Serial console access has been configured for all virtual machines. In each VM instance, The pre-configured test script /usr/local/bin/playz can be run from the SSH terminal to test network reachability.

The full list of the scripts in each VM instance is shown below:

$ ls -l /usr/local/bin/
-rwxr-xr-x 1 root root   98 Aug 17 14:58 aiz
-rwxr-xr-x 1 root root  203 Aug 17 14:58 bucketz
-rw-r--r-- 1 root root 1383 Aug 17 14:58 discoverz.py
-rwxr-xr-x 1 root root 1692 Aug 17 14:58 pingz
-rwxr-xr-x 1 root root 5986 Aug 17 14:58 playz
-rwxr-xr-x 1 root root 1957 Aug 17 14:58 probez

1. Test Site1 (On-premises)

1.1 Login to the instance a-site1-vm using the SSH-in-Browser from the Google Cloud console.

1.2 Run the playz script to test network reachability to all VM instances.

playz
Sample output 
admin_cloudtuple_com@a-site1-vm:~$ playz

 apps ...

200 (0.008010s) - 10.10.1.9 - app1.site1.onprem:8080/
200 (0.290780s) - 10.20.1.9 - app1.site2.onprem:8080/
200 (0.012014s) - 10.1.11.70 - ilb4.eu.hub.gcp:8080/
200 (0.294077s) - 10.1.21.70 - ilb4.us.hub.gcp:8080/
200 (0.038151s) - 10.1.11.80 - ilb7.eu.hub.gcp/
000 (2.002273s) -  - ilb7.us.hub.gcp/
200 (0.011709s) - 10.11.11.30 - ilb4.eu.spoke1.gcp:8080/
200 (0.297402s) - 10.22.21.30 - ilb4.us.spoke2.gcp:8080/
200 (0.033373s) - 10.11.11.40 - ilb7.eu.spoke1.gcp/
200 (0.713397s) - 10.22.21.40 - ilb7.us.spoke2.gcp/

 psc4 ...

000 (0.128157s) -  - psc4.consumer.spoke2-us-svc.psc.hub.gcp:8080
000 (0.128184s) -  - psc4.consumer.spoke2-us-svc.psc.spoke1.gcp:8080

 apis ...

204 (0.003779s) - 142.250.178.10 - www.googleapis.com/generate_204
204 (0.007107s) - 10.1.0.1 - storage.googleapis.com/generate_204
204 (0.042343s) - 10.11.11.40 - europe-west2-run.googleapis.com/generate_204
204 (1.585208s) - 10.22.21.40 - us-west2-run.googleapis.com/generate_204
204 (0.052156s) - 10.11.11.40 - europe-west2-run.googleapis.com/generate_204
308 (2.065038s) - 10.22.21.40 - us-west2-run.googleapis.com/generate_204
200 (0.038167s) - 10.1.0.1 - https://a-hub-us-run-httpbin-i6ankopyoa-nw.a.run.app/
200 (0.038301s) - 10.1.0.1 - https://a-spoke1-eu-run-httpbin-2zcsnlaqcq-nw.a.run.app/
200 (0.869730s) - 10.1.0.1 - https://a-spoke2-us-run-httpbin-bttbo6m6za-wl.a.run.app/
204 (0.013358s) - 10.1.0.1 - ahuball.p.googleapis.com/generate_204
204 (0.024048s) - 142.250.180.10 - aspoke1sec.p.googleapis.com/generate_204
204 (0.018890s) - 172.217.16.234 - aspoke2sec.p.googleapis.com/generate_204

1.3 Run the pingz script to test ICMP reachability to all VM instances.

pingz
Sample output 
admin_cloudtuple_com@a-site1-vm:~$ pingz

 ping ...

app1.site1.onprem - OK 0.033 ms
app1.site2.onprem - OK 138.270 ms
ilb4.eu.hub.gcp - NA
ilb4.us.hub.gcp - NA
ilb7.eu.hub.gcp - NA
ilb7.us.hub.gcp - NA
ilb4.eu.spoke1.gcp - NA
ilb4.us.spoke2.gcp - NA
ilb7.eu.spoke1.gcp - NA
ilb7.us.spoke2.gcp - NA

1.4 Run the bucketz script to test access to selected Google Cloud Storage buckets.

bucketz
Sample output 
admin_cloudtuple_com@a-site1-vm:~$ bucketz

hub : <--- HUB EU --->

spoke1 : <--- SPOKE 1 --->

spoke2 : <--- SPOKE 2 --->

1.5 On your local terminal or Cloud Shell, run the discoverz.py script to test access to all Google API endpoints.

gcloud compute ssh a-site1-vm \
--project $TF_VAR_project_id_onprem \
--zone europe-west2-b \
-- 'python3 /usr/local/bin/discoverz.py' | tee  _output/site1-api-discovery.txt

The script save the output to the file _output/site1-vm-api-discoverz.sh`.

2. test from Spoke1 (Cloud)

Login to the instance a-spoke1-eu-ilb4-vm using the SSH-in-Browser from the Google Cloud console.

playz
Sample output 
admin_cloudtuple_com@a-spoke1-eu-ilb4-vm:~$ playz

 apps ...

200 (0.013141s) - 10.10.1.9 - app1.site1.onprem:8080/
200 (0.292885s) - 10.20.1.9 - app1.site2.onprem:8080/
200 (0.007194s) - 10.1.11.70 - ilb4.eu.hub.gcp:8080/
200 (0.287913s) - 10.1.21.70 - ilb4.us.hub.gcp:8080/
200 (0.033333s) - 10.1.11.80 - ilb7.eu.hub.gcp/
000 (2.003002s) -  - ilb7.us.hub.gcp/
200 (0.007855s) - 10.11.11.30 - ilb4.eu.spoke1.gcp:8080/
200 (0.288928s) - 10.22.21.30 - ilb4.us.spoke2.gcp:8080/
200 (0.029343s) - 10.11.11.40 - ilb7.eu.spoke1.gcp/
200 (0.725261s) - 10.22.21.40 - ilb7.us.spoke2.gcp/

 psc4 ...

000 (0.007494s) -  - psc4.consumer.spoke2-us-svc.psc.hub.gcp:8080
000 (0.007554s) -  - psc4.consumer.spoke2-us-svc.psc.spoke1.gcp:8080

 apis ...

204 (0.002634s) - 216.58.213.10 - www.googleapis.com/generate_204
204 (0.002643s) - 10.11.0.2 - storage.googleapis.com/generate_204
204 (0.063054s) - 10.11.11.40 - europe-west2-run.googleapis.com/generate_204
000 (2.002620s) -  - us-west2-run.googleapis.com/generate_204
204 (0.016000s) - 10.11.11.40 - europe-west2-run.googleapis.com/generate_204
000 (2.002068s) -  - us-west2-run.googleapis.com/generate_204
200 (0.031179s) - 10.11.0.2 - https://a-hub-us-run-httpbin-i6ankopyoa-nw.a.run.app/
200 (0.036812s) - 10.11.0.2 - https://a-spoke1-eu-run-httpbin-2zcsnlaqcq-nw.a.run.app/
200 (0.183558s) - 10.11.0.2 - https://a-spoke2-us-run-httpbin-bttbo6m6za-wl.a.run.app/
000 (0.015688s) -  - ahuball.p.googleapis.com/generate_204
204 (0.005784s) - 10.11.0.2 - aspoke1sec.p.googleapis.com/generate_204
204 (0.277124s) - 10.22.0.2 - aspoke2sec.p.googleapis.com/generate_204

1.3 Run the pingz script to test ICMP reachability to all VM instances.

pingz
Sample output 
admin_cloudtuple_com@a-spoke1-eu-ilb4-vm:~$ pingz

 ping ...

app1.site1.onprem - OK 2.527 ms
app1.site2.onprem - OK 136.822 ms
ilb4.eu.hub.gcp - NA
ilb4.us.hub.gcp - NA
ilb7.eu.hub.gcp - NA
ilb7.us.hub.gcp - NA
ilb4.eu.spoke1.gcp - OK 0.029 ms
ilb4.us.spoke2.gcp - NA
ilb7.eu.spoke1.gcp - NA
ilb7.us.spoke2.gcp - NA

1.4 Run the bucketz script to test access to selected Google Cloud Storage buckets.

bucketz
Sample output 
admin_cloudtuple_com@a-spoke1-eu-ilb4-vm:~$ bucketz

hub : <--- HUB EU --->

spoke1 : <--- SPOKE 1 --->

spoke2 : <--- SPOKE 2 --->

1.5 On your local terminal or Cloud Shell, run the discoverz.py script to test access to all Google API endpoints.

gcloud compute ssh a-spoke1-eu-ilb4-vm \
--project $TF_VAR_project_id_spoke1 \
--zone europe-west2-b \
-- 'python3 /usr/local/bin/discoverz.py' | tee  _output/spoke1-api-discovery.txt

The script save the output to the file _output/spoke1-api-discovery.txt`.

Cleanup

1. (Optional) Navigate back to the lab directory (if you are not already there).

cd gcp-network-terraform/1-blueprints-a-standard

2. Run terraform destroy twice.

The second run is required to delete the the null_resource resource that could not be deleted on teh first run due to race conditions.

terraform destroy -auto-approve
terraform destroy -auto-approve

Requirements

No requirements.

Inputs

Name Description Type Default Required
bgp_range bgp interface ip cidr ranges. map(string) 
{
  "cidr1": "169.254.101.0/30",
  "cidr10": "169.254.110.0/30",
  "cidr2": "169.254.102.0/30",
  "cidr3": "169.254.103.0/30",
  "cidr4": "169.254.104.0/30",
  "cidr5": "169.254.105.0/30",
  "cidr6": "169.254.106.0/30",
  "cidr7": "169.254.107.0/30",
  "cidr8": "169.254.108.0/30",
  "cidr9": "169.254.109.0/30"
}
 no
disk_size disk size string "20" no
disk_type disk type string "pd-ssd" no
gre_range gre interface ip cidr ranges. map(string) 
{
  "cidr1": "172.16.1.0/24",
  "cidr2": "172.16.2.0/24",
  "cidr3": "172.16.3.0/24",
  "cidr4": "172.16.4.0/24",
  "cidr5": "172.16.5.0/24",
  "cidr6": "172.16.6.0/24",
  "cidr7": "172.16.7.0/24",
  "cidr8": "172.16.8.0/24"
}
 no
image_cos container optimized image string "cos-cloud/cos-stable" no
image_debian vm instance image string "debian-cloud/debian-12" no
image_panos palo alto image from gcp marketplace string "https://www.googleapis.com/compute/v1/projects/paloaltonetworksgcp-public/global/images/vmseries-bundle1-810" no
image_ubuntu vm instance image string "ubuntu-os-cloud/ubuntu-2404-lts-amd64" no
image_vyos vyos image from gcp marketplace string "https://www.googleapis.com/compute/v1/projects/sentrium-public/global/images/vyos-1-3-0" no
machine_type vm instance size string "e2-micro" no
organization_id organization id any null no
project_id_host host project id any n/a yes
project_id_hub hub project id any n/a yes
project_id_onprem onprem project id (for onprem site1 and site2) any n/a yes
project_id_spoke1 spoke1 project id (service project id attached to the host project any n/a yes
project_id_spoke2 spoke2 project id (standalone project) any n/a yes
shielded_config Shielded VM configuration of the instances. map 
{
  "enable_integrity_monitoring": true,
  "enable_secure_boot": true,
  "enable_vtpm": true
}
 no

Outputs

No outputs.