Skip to content

Farrow 0.6.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Sep 10:09
v0.6.0
057774e

Farrow 0.6.0

Farrow 0.6.0 defaults to Ubuntu 24.04 and improves the everyday loop of
planning, starting, expanding, and rebuilding a local Pigsty lab.

中文说明见下文。

What changed

  • Ubuntu 24.04 by default. New inventories and the embedded catalog use
    u24:stable. Catalog revision 2026090501 also includes the Debian 12/13
    and Rocky Linux 8/9 updates already available in the official repositories.
  • Useful plans before setup. plan works without QEMU or host networking
    installed and shows exact image versions, resource totals, pending starts,
    changed fields, disk effects, and commands that retain custom -f paths.
  • Readable status and errors. Status shows images, CPU, and memory; one
    damaged node no longer hides healthy peers. Corrupt state names the actual
    file and cause. Image digest failures return exit 7; SSH exit 255 passes
    through unchanged. --no-wait clearly reports that readiness was skipped.
  • Checks before disruption. Selected recreate detects conflicting peer
    changes before deleting disks. reload checks startup dependencies before
    stopping guests. Stop, destroy, and runtime cleanup handle deployment state
    consistently under the existing lock.
  • Guest names stay current. Starting commands and node removal refresh
    Farrow-managed guest hosts entries and control-node SSH configuration.
    Recreated peers remain reachable without clearing guest known_hosts.
    User SSH text and global option scope are preserved.
  • Fewer CLI surprises. Custom init paths produce usable next commands;
    presentation flags respect option values; malformed integer sizes and extra
    YAML documents are rejected without truncation. ALL_PROXY/all_proxy
    provides a fallback while respecting scheme-specific proxies and NO_PROXY.

Upgrade notes

Upgrading Farrow does not replace existing disks or change an explicitly
selected image. If an old inventory relied on the implicit Debian 13 default,
add vm_image: d13 under all.vars before applying it with 0.6.0. Review
farrow plan before applying changes; farrow start uses the applied state.

CPU and memory changes still use recreate: root and non-persistent data disks
are replaced, while persistent data disks are retained. --no-wait skips both
readiness and guest metadata refresh; a later farrow up completes them.
Scripts should use --json or --yaml instead of parsing status columns;
partial status results include healthy nodes and a failures array, with exit 5.

Install or upgrade

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.6.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.6.0 ./install.sh
farrow version
farrow doctor

The release also includes four platform archives, amd64/arm64 DEB and RPM
packages, and a Homebrew formula. As a pre-1.0 release it keeps the GitHub
pre-release flag, so the installer needs the explicit version above.
See the Quick Start.

Validation

The lifecycle and UX changes passed two adversarial Claude Code Fable 5.1
reviews at xhigh effort, plus the complete local make check gate. An isolated
macOS arm64/HVF lab exercised Ubuntu 24.04 boot, scale-out, control-to-peer SSH,
stop/start, reload, recreate, partial status failures, and scale-in. The final
guest SSH scope correction also passed effective OpenSSH configuration tests.

The tag workflow repeats source checks and verifies archives, packages, SBOMs,
installer, formula, release metadata, and checksums. These checks do not imply
a new Linux-host VM replay, host-reboot test, or complete Pigsty installation.

Farrow 0.6.0（中文）

Farrow 0.6.0 默认使用 Ubuntu 24.04，完善本地 Pigsty 实验环境的计划、启动、扩容和重建体验。

主要变化

  • 默认 Ubuntu 24.04。 新配置与内置镜像目录使用 u24:stable。目录版本
    2026090501 同时纳入官方仓库已经发布的 Debian 12/13、Rocky Linux 8/9 镜像更新。
  • 准备宿主前就能查看计划。 plan 无需先安装 QEMU 或配置网络，展示准确镜像版本、
    资源总量、待启动节点、变化字段、磁盘影响，并保留自定义 -f 路径。
  • 状态和错误更清晰。 状态表直接显示镜像、CPU 与内存，异常节点不再遮住健康节点。
    状态损坏报告具体文件与原因；镜像摘要错误返回 7，SSH 的 255 原样透传；
    --no-wait 明确说明跳过就绪检查。
  • 先检查，再中断。 局部 recreate 在删除磁盘前发现同伴配置冲突；reload 在停机前
    检查启动依赖。停止、销毁和运行时清理沿用现有部署锁，一致地处理状态。
  • 节点名称随环境更新。 启动与删除节点后更新 Guest 内 Farrow 管理的 hosts 和控制节点
    SSH 配置；同名节点重建后可以直接连接，无需手动清理 Guest 的 known_hosts。
    用户 SSH 内容及全局选项的作用域得到保留。
  • 减少命令行意外。 init 自定义路径给出可用的下一步命令，展示参数不再误读选项值，
    整数容量与多文档 YAML 不再被静默截断。ALL_PROXY/all_proxy 提供代理回退，
    同时尊重专用代理和 NO_PROXY。

升级说明

升级程序不会自动替换已有磁盘，也不会修改显式选择的镜像。旧配置若依赖隐式 Debian 13
默认值，请先在 all.vars 中加入 vm_image: d13，再使用 0.6.0 应用配置。执行变更前先看
farrow plan；farrow start 继续使用已应用状态。

CPU、内存变化仍通过 recreate 应用：根盘与非持久数据盘会被替换，持久数据盘保留。
--no-wait 跳过就绪检查和 Guest 信息刷新，之后执行 farrow up 即可补齐。
脚本应读取 --json 或 --yaml，避免依赖表格列位置；部分状态失败时仍返回健康节点与
failures 数组，退出码为 5。

安装或升级

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.6.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.6.0 ./install.sh
farrow version
farrow doctor

同一 Release 提供四个平台归档、amd64/arm64 的 DEB/RPM 软件包和 Homebrew Formula。
0.6.0 沿用 pre-1.0 发布规则，在 GitHub 标记为 Pre-release，安装器需要显式指定版本。
完整步骤见快速上手。

验证范围

生命周期与 UX 修改通过了 Claude Code Fable 5.1 / xhigh 两轮对抗性审查和完整本地
make check。隔离的 macOS arm64/HVF 环境验证了 U24 启动、扩容、控制节点到同伴的
SSH、stop/start、reload、recreate、部分状态失败和缩容；最终的 Guest SSH 作用域修复
另经真实 OpenSSH 有效配置测试验证。

Tag 工作流重复源码检查，并验证归档、软件包、SBOM、安装器、Formula、发布元数据和
校验和。这些结果不代表新增 Linux 宿主 VM 重放、宿主重启测试或完整 Pigsty 安装。

Assets 22
Loading