Barn blog on Barn

Why Barn Has No Projects

Thu, 27 Aug 2026 19:00:00 +0800

Note

This article describes the unreleased Barn 0.9.0 candidate. See Status for current validation and remaining release checks.

Barn began with a familiar VM-manager abstraction: a working directory was a project, a hidden marker gave it identity, a registry found projects again, and a host-global lease kept their private networks from colliding. That model can support many independent VM sets. It was also the wrong model for the product Barn was actually becoming.

Why Every Barn Node Has Two NICs

Thu, 27 Aug 2026 20:00:00 +0800

Note

This article describes the unreleased Barn 0.9.0 candidate. See Status for current validation and remaining release checks.

A Pigsty Inventory names machines by stable addresses. PostgreSQL replication, etcd membership, HAProxy backends, VIPs, monitoring targets, and Ansible all assume that 10.10.10.11 continues to mean the same node. A loopback port forward can expose SSH or PostgreSQL to the host, but it cannot provide that network identity to peers.

Declarative Does Not Mean Destructive

Thu, 27 Aug 2026 21:00:00 +0800

Note

This article describes the unreleased Barn 0.9.0 candidate. See Status for current validation and remaining release checks.

“Declarative” is often shortened to “make reality equal the file.” That is a useful slogan until the file is incomplete, the wrong branch is checked out, or one YAML group is temporarily removed. If absence is treated as deletion, an ordinary editing mistake becomes a destructive operation.

Barn uses a narrower rule:

A PID Is Not a Virtual Machine

Fri, 28 Aug 2026 10:00:00 +0800

Note

This article describes the unreleased Barn 0.9.0 candidate. See Status for current validation and remaining release checks.

A pidfile answers one question: which integer did a process have when the file was written? It does not prove that the process is still alive, that the PID was not reused, that the executable is QEMU, or that this particular QEMU owns the node an operator wants to stop.

repo.yaml Is Intent; catalog.json Is Evidence

Sat, 29 Aug 2026 19:00:00 +0800

Note

This article describes the unreleased Barn 0.9.0 candidate. See Status for current validation and remaining release checks.

A static image repository sounds like a directory of qcow2 files plus a JSON index. The difficult part is deciding which facts a maintainer may write by hand and which facts must be derived from the bytes being published.

If checksums and sizes live in the hand-authored source, they are easy to copy incorrectly. If policy exists only in generated JSON, reviewing a channel change or deprecation requires reading machine output. Barn keeps the two jobs separate.