spinifex/docs/vpc-networking/README.md

title, description, category, tags, resources

title	description	category	tags	resources
VPC Networking	Create and manage Virtual Private Clouds with subnets, DHCP, and Geneve overlay networking.	Environments	vpc networking ovn	title url Hive Repository https://github.com/mulgadc/hive title url OVN Architecture https://www.ovn.org/en/

VPC Networking

Create and manage Virtual Private Clouds with subnets, DHCP, and Geneve overlay networking.

Table of Contents

• Overview
• Instructions
• Troubleshooting

---

Overview

Every EC2 instance runs inside a VPC with an isolated virtual network. Hive uses OVN (Open Virtual Network) to provide the networking layer.

How it works:

• VPC becomes an OVN logical router
• Subnet becomes an OVN logical switch with DHCP
• Each instance gets an OVN port with automatic IP assignment
• Cross-host traffic uses Geneve tunnels (UDP 6081)

Instructions

Create VPC

aws ec2 create-vpc --cidr-block 10.200.0.0/16
export HIVE_VPC="vpc-XXX"

Create Subnet

aws ec2 create-subnet --vpc-id $HIVE_VPC --cidr-block 10.200.1.0/24
export HIVE_SUBNET="subnet-XXX"

Verify

aws ec2 describe-vpcs
aws ec2 describe-subnets
sudo ovn-nbctl lr-list
sudo ovn-nbctl ls-list

Troubleshooting

VPC creation fails

Ensure OVN services are running and the vpcd daemon is active:

sudo systemctl is-active ovn-controller

Check the vpcd logs for errors:

cat ~/hive/logs/vpcd.log

Instances cannot reach each other

This typically means Geneve tunnels are not established between hosts. Verify tunnel configuration:

sudo ovs-vsctl show | grep -i geneve

Ensure UDP port 6081 is open between all hosts:

sudo ss -ulnp | grep 6081

From inside a VM, check that the private IP was assigned via DHCP:

ip addr show