Skip to content

v0.1.0

Choose a tag to compare

View all tags
@wayneeseguin wayneeseguin released this 05 Aug 14:55
· 155 commits to main since this release
v0.1.0
022d414

bosh-pve-cpi v0.1.0

First public release of the BOSH CPI for Proxmox VE. This is a Go implementation of the BOSH Cloud Provider Interface (v2) that lets a BOSH Director provision and manage VMs, disks, networks, snapshots, and stemcells on a Proxmox VE 9.x cluster. The CPI ships as a single static binary packaged into a BOSH release, and it has been exercised end to end on live PVE clusters, from bosh create-env through a full Cloud Foundry deployment.

Highlights

  • The CPI covers the full VM lifecycle: creation, deletion, reboot, metadata updates, and resource calibration. Placement understands availability zones, co-locates VMs with the fault domain of their persistent disks, can pin HA-managed VMs to nodes, and can hand scheduling to PVE 9.2's Dynamic Load Balancing if you opt in.

  • Managed networks default to PVE SDN with VXLAN isolation. EVPN and VLAN modes are available, and clusters without SDN fall back to plain Linux bridges. VIP networks seed the PVE firewall's ipfilter set, so a VM can only use the addresses BOSH assigned it.

  • Persistent disks support attach, detach, resize, and snapshot, with per-disk performance tuning (iothread, cache, discard, plus IOPS and bandwidth caps). An optional parked strategy keeps detached disks on protected parker VMs so nothing garbage-collects them by accident.

  • Light stemcells reference qcow2 images the CPI fetches or you pre-upload, so the Director never re-uploads gigabytes on redeploy. Stemcell templates carry provenance tags, and deleting a stemcell sweeps orphaned copies across nodes.

  • Agent settings travel on a ConfigDrive ISO with three bootstrap modes (cloudinit, noagent, and auto). There is no external registry service to run or secure.

  • Cloud properties resolve in predictable layers: per-call settings first, then disk type, VM type, and global. Defaults cover CPU type, cores, and ballooning, and strict validation catches typos before they become failed deploys.

  • Authentication uses API tokens or passwords, with TLS verification on by default and credentials scrubbed from logs. Create and delete paths are idempotent and survive retries, resource pools are managed with cross-process locking, and OpenTelemetry traces, metrics, and logs can be switched on when you need them.

Getting started

The README quickstart walks you from a fresh checkout to a running Director. The docs directory covers configuration, networking, persistent disks, and operations in depth.

Status

This is an early release. The CPI passes its end-to-end suite against live Proxmox VE clusters and has deployed BOSH Directors and Cloud Foundry foundations in lab environments, but interfaces and defaults may still change before 1.0.

Assets 3
Loading