HOWTO: Configure BGP Peering Between VyOS Edge and GCP¶

Purpose: Establish eBGP peering between the VyOS edge and GCP Cloud Router and validate bidirectional prefix exchange.

Difficulty: Advanced

Track: Networking Foundations

Overview¶

BGP is the control-plane contract between the HybridOps edge and the GCP hub. Use this guide when the transport is already in place and the next step is to exchange routes cleanly, verify path selection, and confirm that the hybrid WAN behaves as designed.

1. Prerequisites¶

VyOS edge commissioned with public and tunnel interfaces active.
GCP Cloud Router provisioned in the target region.
VPN or Interconnect attachment between VyOS and GCP Cloud Router.

2. VyOS BGP Configuration¶

ASN assignment and neighbour declaration.
Prefix advertisement: on-prem summary routes.
Route policy for inbound GCP prefixes.

3. GCP Cloud Router BGP Configuration¶

Cloud Router BGP peer addition via gcloud or Terraform.
ASN and peer IP matching VyOS configuration.
Advertised route groups.

4. Session Establishment¶

Confirming Established state on VyOS: show ip bgp summary.
Confirming peer active on GCP Cloud Router.

5. Prefix Exchange Validation¶

On-prem prefixes visible in GCP VPC routing table.
GCP VPC ranges visible in VyOS show ip route bgp.
Traceroute end-to-end from on-prem to a GCP workload.

6. Run-record capture¶

BGP summary snapshots from both sides.
Route table excerpts for key prefixes.
Storing under <runtime-root>/logs/networking/bgp-gcp/.

References¶

License: MIT-0 for code, CC-BY-4.0 for documentation unless otherwise stated.