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¶

In the shipped GCP reference path, BGP carries the routing contract between the VyOS edge and Cloud Router. Use this guide after transport is in place to exchange routes, verify path selection, and confirm the resulting hybrid-WAN state.

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.