VPC-native networking for Cocoon VM nodes. Provisions cloud networking resources and runs an embedded DHCP server so VMs obtain VPC-routable IPs directly -- no overlay network, no iptables DNAT, no external DHCP server dependency.

Documentation: cocoonstack.github.io/cocoon-net (source in docs/).

cocoon-net init          cocoon-net daemon
      |                        |
      v                        v
Cloud provisioning       Node setup (NICs up, bridge, sysctl, iptables, CNI conflist)
(alias IPs / ENIs)             |
      |                        v
      v                  DHCP server on cni0
pool.json  <----------        |
                               v
                         On lease: add /32 route
                         On release: del /32 route

Two-phase operation: cocoon-net init (or adopt) does one-time cloud provisioning and state persistence; cocoon-net daemon is the long-running service that sets up node networking, serves DHCP, and manages routes. Full details in Architecture.

sudo install -m 0755 cocoon-net /usr/local/bin/
sudo cocoon-net init --platform gke --node-name cocoon-pool --subnet 172.20.100.0/24 --pool-size 140
sudo cocoon-net daemon

Full steps in Installation.

• Architecture -- the two-phase model, package layout, CNI integration, credentials
• Embedded DHCP server -- lease lifecycle, the lease file, dynamic host routes, VM traffic isolation
• Configuration -- every flag and environment variable, plus the pool.json state schema
• Installation -- prebuilt binary, building from source, the systemd unit, command usage
• GKE VPC-native networking
• Volcengine VPC-native networking

make build      # build binary
make test       # run tests with coverage
make lint       # golangci-lint (linux + darwin)
make fmt        # gofumpt + goimports
make help       # show all targets

MIT