Skip to content

Commit e0fcb33

Browse files
VonngVonng
committed
docs: publish Farrow 0.6.0
1 parent 60f99c4 commit e0fcb33

12 files changed

Lines changed: 248 additions & 32 deletions

File tree

‎content/blog/release/farrow-0.5.0.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@ title: "Farrow 0.5.0: explicit disposal, explicit repositories, reproducible ima
33
linkTitle: Farrow 0.5.0
44
description: A no-confirmation whole-lab purge, explicit global and China repository selection, no hidden artifact fallback, and an eight-target official-image candidate pipeline.
55
date: 2026-09-03
6-
weight: 1
6+
weight: 2
77
categories: [Release]
88
tags: [Farrow 0.5.0, QEMU, Images, Supply Chain, Release]
99
icon: fa-solid fa-rocket
1010
---
1111

12-
Farrow 0.5.0 is the current public pre-1.0 release. It adds an explicit command
12+
Farrow 0.5.0 was the public pre-1.0 release superseded by 0.6.0. It adds an explicit command
1313
for disposable labs, makes repository geography an operator choice, and adds a
1414
reproducible path for preparing the next official guest images. The Pigsty
1515
Inventory contract, deployment state format, and embedded Catalog revision

‎content/blog/release/farrow-0.5.0.zh.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@ title: "Farrow 0.5.0：显式处置、显式仓库、可复现镜像"
33
linkTitle: Farrow 0.5.0
44
description: 无需确认的整套实验室处置、全球与中国仓库显式选择、无隐藏工件回退，以及八目标官方镜像候选流水线。
55
date: 2026-09-03
6-
weight: 1
6+
weight: 2
77
categories: [发布]
88
tags: [Farrow 0.5.0, QEMU, 镜像, 供应链, 发布]
99
icon: fa-solid fa-rocket
1010
---
1111

12-
Farrow 0.5.0 是当前公开的 pre-1.0 发布。它为一次性实验室加入明确处置命令，让仓库地域
12+
Farrow 0.5.0 是被 0.6.0 取代的公开 pre-1.0 发布。它为一次性实验室加入明确处置命令，让仓库地域
1313
成为操作者的显式选择，并提供可复现的下一代官方 Guest 镜像准备路径。Pigsty Inventory
1414
契约、Deployment 状态格式与内嵌 Catalog revision `2026082903` 均未变化。
1515

‎content/blog/release/farrow-0.6.0.md‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
title: "Farrow 0.6.0: Ubuntu 24.04 and smoother local labs"
3+
linkTitle: Farrow 0.6.0
4+
description: Ubuntu 24.04 defaults, useful plans before setup, clearer status, and reliable expansion and recreation.
5+
date: 2026-09-05
6+
weight: 1
7+
categories: [Release]
8+
tags: [Farrow 0.6.0, QEMU, Ubuntu, Release]
9+
icon: fa-solid fa-rocket
10+
---
11+
12+
Farrow 0.6.0 defaults to Ubuntu 24.04 and improves the everyday loop of
13+
planning, starting, expanding, and rebuilding a local Pigsty lab.
14+
15+
## What changed
16+
17+
- **Ubuntu 24.04 by default.** New inventories and the embedded catalog use
18+
`u24:stable`. Catalog revision `2026090501` also includes the Debian 12/13
19+
and Rocky Linux 8/9 updates already available in the official repositories.
20+
- **Useful plans before setup.** `plan` works without QEMU or host networking
21+
installed and shows exact image versions, resource totals, pending starts,
22+
changed fields, disk effects, and commands that retain custom `-f` paths.
23+
- **Readable status and errors.** Status shows images, CPU, and memory; one
24+
damaged node no longer hides healthy peers. Corrupt state names the actual
25+
file and cause. Image digest failures return exit 7; SSH exit 255 passes
26+
through unchanged. `--no-wait` clearly reports that readiness was skipped.
27+
- **Checks before disruption.** Selected `recreate` detects conflicting peer
28+
changes before deleting disks. `reload` checks startup dependencies before
29+
stopping guests. Stop, destroy, and runtime cleanup handle deployment state
30+
consistently under the existing lock.
31+
- **Guest names stay current.** Starting commands and node removal refresh
32+
Farrow-managed guest hosts entries and control-node SSH configuration.
33+
Recreated peers remain reachable without clearing guest `known_hosts`.
34+
User SSH text and global option scope are preserved.
35+
- **Fewer CLI surprises.** Custom `init` paths produce usable next commands;
36+
presentation flags respect option values; malformed integer sizes and extra
37+
YAML documents are rejected without truncation. `ALL_PROXY`/`all_proxy`
38+
provides a fallback while respecting scheme-specific proxies and `NO_PROXY`.
39+
40+
## Upgrade notes
41+
42+
Upgrading Farrow does not replace existing disks or change an explicitly
43+
selected image. If an old inventory relied on the implicit Debian 13 default,
44+
add `vm_image: d13` under `all.vars` before applying it with 0.6.0. Review
45+
`farrow plan` before applying changes; `farrow start` uses the applied state.
46+
47+
CPU and memory changes still use `recreate`: root and non-persistent data disks
48+
are replaced, while persistent data disks are retained. `--no-wait` skips both
49+
readiness and guest metadata refresh; a later `farrow up` completes them.
50+
Scripts should use `--json` or `--yaml` instead of parsing status columns;
51+
partial status results include healthy nodes and a `failures` array, with exit 5.
52+
53+
## Install or upgrade
54+
55+
```bash
56+
curl -fLO https://github.com/pgsty/farrow/releases/download/v0.6.0/install.sh
57+
chmod +x install.sh
58+
FARROW_VERSION=0.6.0 ./install.sh
59+
farrow version
60+
farrow doctor
61+
```
62+
63+
The release also includes four platform archives, amd64/arm64 DEB and RPM
64+
packages, and a Homebrew formula. As a pre-1.0 release it keeps the GitHub
65+
pre-release flag, so the installer needs the explicit version above.
66+
See the [Quick Start](https://farrow.pgsty.com/docs/start/tutorial/).
67+
68+
## Validation
69+
70+
The lifecycle and UX changes passed two adversarial Claude Code Fable 5.1
71+
reviews at xhigh effort, plus the complete local `make check` gate. An isolated
72+
macOS arm64/HVF lab exercised Ubuntu 24.04 boot, scale-out, control-to-peer SSH,
73+
stop/start, reload, recreate, partial status failures, and scale-in. The final
74+
guest SSH scope correction also passed effective OpenSSH configuration tests.
75+
76+
The tag workflow repeats source checks and verifies archives, packages, SBOMs,
77+
installer, formula, release metadata, and checksums. These checks do not imply
78+
a new Linux-host VM replay, host-reboot test, or complete Pigsty installation.

‎content/blog/release/farrow-0.6.0.zh.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
title: "Farrow 0.6.0：默认 U24，更顺手的本地虚拟机体验"
3+
linkTitle: Farrow 0.6.0
4+
description: 默认 Ubuntu 24.04，准备宿主前即可查看计划，状态更清晰，扩容与重建更可靠。
5+
date: 2026-09-05
6+
weight: 1
7+
categories: [发布]
8+
tags: [Farrow 0.6.0, QEMU, Ubuntu, 发布]
9+
icon: fa-solid fa-rocket
10+
---
11+
12+
Farrow 0.6.0 默认使用 Ubuntu 24.04，完善本地 Pigsty 实验环境的计划、启动、扩容和重建体验。
13+
14+
## 主要变化
15+
16+
- **默认 Ubuntu 24.04。** 新配置与内置镜像目录使用 `u24:stable`。目录版本
17+
`2026090501` 同时纳入官方仓库已经发布的 Debian 12/13、Rocky Linux 8/9 镜像更新。
18+
- **准备宿主前就能查看计划。** `plan` 无需先安装 QEMU 或配置网络，展示准确镜像版本、
19+
资源总量、待启动节点、变化字段、磁盘影响，并保留自定义 `-f` 路径。
20+
- **状态和错误更清晰。** 状态表直接显示镜像、CPU 与内存，异常节点不再遮住健康节点。
21+
状态损坏报告具体文件与原因；镜像摘要错误返回 7，SSH 的 255 原样透传；
22+
`--no-wait` 明确说明跳过就绪检查。
23+
- **先检查，再中断。** 局部 `recreate` 在删除磁盘前发现同伴配置冲突；`reload` 在停机前
24+
检查启动依赖。停止、销毁和运行时清理沿用现有部署锁，一致地处理状态。
25+
- **节点名称随环境更新。** 启动与删除节点后更新 Guest 内 Farrow 管理的 hosts 和控制节点
26+
SSH 配置；同名节点重建后可以直接连接，无需手动清理 Guest 的 `known_hosts`。
27+
用户 SSH 内容及全局选项的作用域得到保留。
28+
- **减少命令行意外。** `init` 自定义路径给出可用的下一步命令，展示参数不再误读选项值，
29+
整数容量与多文档 YAML 不再被静默截断。`ALL_PROXY`/`all_proxy` 提供代理回退，
30+
同时尊重专用代理和 `NO_PROXY`。
31+
32+
## 升级说明
33+
34+
升级程序不会自动替换已有磁盘，也不会修改显式选择的镜像。旧配置若依赖隐式 Debian 13
35+
默认值，请先在 `all.vars` 中加入 `vm_image: d13`，再使用 0.6.0 应用配置。执行变更前先看
36+
`farrow plan`；`farrow start` 继续使用已应用状态。
37+
38+
CPU、内存变化仍通过 `recreate` 应用：根盘与非持久数据盘会被替换，持久数据盘保留。
39+
`--no-wait` 跳过就绪检查和 Guest 信息刷新，之后执行 `farrow up` 即可补齐。
40+
脚本应读取 `--json` 或 `--yaml`，避免依赖表格列位置；部分状态失败时仍返回健康节点与
41+
`failures` 数组，退出码为 5。
42+
43+
## 安装或升级
44+
45+
```bash
46+
curl -fLO https://github.com/pgsty/farrow/releases/download/v0.6.0/install.sh
47+
chmod +x install.sh
48+
FARROW_VERSION=0.6.0 ./install.sh
49+
farrow version
50+
farrow doctor
51+
```
52+
53+
同一 Release 提供四个平台归档、amd64/arm64 的 DEB/RPM 软件包和 Homebrew Formula。
54+
0.6.0 沿用 pre-1.0 发布规则，在 GitHub 标记为 Pre-release，安装器需要显式指定版本。
55+
完整步骤见[快速上手](https://farrow.pgsty.com/zh/docs/start/tutorial/)。
56+
57+
## 验证范围
58+
59+
生命周期与 UX 修改通过了 Claude Code Fable 5.1 / xhigh 两轮对抗性审查和完整本地
60+
`make check`。隔离的 macOS arm64/HVF 环境验证了 U24 启动、扩容、控制节点到同伴的
61+
SSH、stop/start、reload、recreate、部分状态失败和缩容；最终的 Guest SSH 作用域修复
62+
另经真实 OpenSSH 有效配置测试验证。
63+
64+
Tag 工作流重复源码检查，并验证归档、软件包、SBOM、安装器、Formula、发布元数据和
65+
校验和。这些结果不代表新增 Linux 宿主 VM 重放、宿主重启测试或完整 Pigsty 安装。

‎content/docs/about/status.md‎

Lines changed: 42 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,20 +11,23 @@ and the public site are separate gates. Install instructions are in the
1111
[Quick Start](../../start/tutorial/#install).
1212

1313
The current public release is
14-
[`v0.5.0`](https://github.com/pgsty/farrow/releases/tag/v0.5.0). Its source and
15-
package gates passed at commit `fc85b65ff6a24b0933b56ae1179be9ada2ba91b1`;
16-
the native-host rows below remain the latest dated VM evidence rather than
17-
being implicitly promoted to 0.5.0.
14+
[`v0.6.0`](https://github.com/pgsty/farrow/releases/tag/v0.6.0). It defaults to
15+
Ubuntu 24.04 and improves plans, status, and lab lifecycle operations. See the
16+
[release notes](../../../blog/release/farrow-0.6.0/) for upgrade instructions.
17+
The latest native replay below used an isolated macOS arm64/HVF U24 lab;
18+
Linux-host and other outstanding results retain their original dates.
1819

1920
## Summary
2021

2122
| Host | Path | Last verified | Result |
2223
|---|---|---|---|
24+
| macOS arm64 | HVF, Ubuntu 24.04.4 guests | 2026-09-05 (0.6.0 lifecycle changes) | create, scale-out, peer SSH, stop/start, reload, recreate, partial status, and scale-in passed |
2325
| macOS 26.6.2 arm64 | HVF, QEMU 11.1, socket_vmnet | 2026-09-01 (`v0.2.0`) | selected create/SSH/stop/start, incremental cached create, whole status, whole destroy passed |
2426
| macOS 26.6.2 arm64 | HVF, QEMU 11.1, socket_vmnet | 2026-08-27 | one node and additive four nodes passed |
2527
| Ubuntu 26.04 amd64 (`mx`) | KVM, QEMU 10.2.1, NetworkManager | 2026-09-01 (`v0.2.0`) | audited an existing four-node deployment as live and reached its control guest |
2628
| Ubuntu 26.04 amd64 (`mx`) | KVM, QEMU 10.2.1, NetworkManager | 2026-08-27 | setup, one node, additive four nodes, and uninstall passed |
2729
| macOS arm64 | HVF host, TCG compatibility rule, Rocky Linux 8.10 arm64 | 2026-08-28 | boot, stop/start, readiness in 44.2 s passed |
30+
| Published Catalog `2026090501` | 9 families, 27 qcow2 artifacts | 2026-09-05 | artifact verification, embedded/public byte equality, and signed update through both official endpoints passed |
2831
| Published Catalog `2026082903` | 9 families, 27 signed qcow2 artifacts | 2026-08-29 | full SHA-256 sweep and clean-client `d13:stable` pull passed |
2932

3033
## Still open
@@ -49,6 +52,39 @@ custody must be formalized before 1.0.
4952
Each entry belongs to the exact checkpoint exercised that day. Later source or
5053
documentation edits do not inherit native proof without another replay.
5154

55+
### Farrow 0.6.0 release — 2026-09-05
56+
57+
The lifecycle and UX changes passed two adversarial Claude Code Fable 5.1
58+
reviews at xhigh effort; release metadata and the CI test fixture received
59+
follow-up approvals. Release commit `057774e3a13477782a2ae07bd71127d03c0f1ae7`
60+
passed the complete Go 1.27.1 [source CI](https://github.com/pgsty/farrow/actions/runs/33959205857).
61+
The latest packaging changes passed the independent
62+
[snapshot and package checks](https://github.com/pgsty/farrow/actions/runs/33958857302)
63+
at `13d9d70`. The [tag workflow](https://github.com/pgsty/farrow/actions/runs/33959431603)
64+
repeated source checks and verified four platform archives, four Linux
65+
packages, eight SPDX documents, the installer, Homebrew formula, release
66+
metadata, and all 19 checksummed payloads before creating the 20-asset release.
67+
The release is public. All asset digests match the checksum manifest. An
68+
isolated macOS arm64 installation upgraded from public 0.5.0 to public 0.6.0;
69+
both installed executables match the verified release archive. The released
70+
binary also passed `init` and a fresh U24 `plan`.
71+
72+
An isolated macOS arm64/HVF U24 lab passed initial boot, expansion without
73+
restarting the control node, control-to-peer SSH, stop/start, normal reload,
74+
selected recreation, scale-in, and guest-name refresh. Invalid-image reload
75+
and conflicting selected recreation stopped before disrupting the existing
76+
VMs. Partial status kept the healthy peer visible, and SSH exit 255 passed
77+
through. Effective OpenSSH configuration tests covered the final guest SSH
78+
scope correction. The test lab was removed after validation.
79+
80+
Published Catalog `2026090501` defaults to `u24:stable` and incorporates the
81+
Debian/Rocky image updates already published in Catalog `2026090302`. All 27
82+
artifacts passed repository byte verification. Both official endpoints now
83+
serve the exact embedded catalog and its production signature; isolated
84+
clients completed `farrow update` against each endpoint.
85+
This application release builds no new guest images. Linux-host VM lifecycle,
86+
host reboot, and a complete Pigsty installation were not replayed for 0.6.0.
87+
5288
### Farrow 0.5.0 release — 2026-09-03
5389

5490
Exact commit `fc85b65ff6a24b0933b56ae1179be9ada2ba91b1` passed both main-branch
@@ -106,8 +142,8 @@ authoring metadata, checksums, and image bytes with a read-only Nginx worker.
106142

107143
### Schema-3 Catalog closure — 2026-08-29
108144

109-
Catalog revision `2026082903` is the current source and development-repository
110-
checkpoint: 9 families and 27 architecture-specific artifacts. The embedded
145+
Catalog revision `2026082903` was the source and development-repository
146+
checkpoint on that date: 9 families and 27 architecture-specific artifacts. The embedded
111147
Catalog and published `catalog.json` have the same SHA-256
112148
`571b1ff9c7d4d42355df3392ea62a339471c2d01d868669a7625fac8b93f245d`;
113149
the published `repo.yaml` also matches the source-controlled authoring file.

‎content/docs/about/status.zh.md‎

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,19 +9,22 @@ aliases: [/docs/project/, /docs/project/status/, /docs/project/roadmap/, /docs/p
99
Farrow 仍是 pre-1.0。源码测试、带日期的真机重放、软件包、发布、CI 与线上站点是不同门禁。
1010
安装方法见[快速上手](../../start/tutorial/#安装)。
1111

12-
当前公开版本为 [`v0.5.0`](https://github.com/pgsty/farrow/releases/tag/v0.5.0)。其源码与
13-
Package 门禁在 Commit `fc85b65ff6a24b0933b56ae1179be9ada2ba91b1` 通过；下表真机记录
14-
仍是最新的带日期 VM 证据，不会被自动提升为 0.5.0 证据。
12+
当前公开版本为 [`v0.6.0`](https://github.com/pgsty/farrow/releases/tag/v0.6.0)，
13+
默认使用 Ubuntu 24.04，改进计划、状态和日常生命周期操作。
14+
升级方法见[发布说明](../../../blog/release/farrow-0.6.0/)。最新真机重放使用隔离的
15+
macOS arm64/HVF U24 环境；Linux 宿主等其他验证仍保留各自的原始日期。
1516

1617
## 概览
1718

1819
| 宿主 | 路径 | 最后验证 | 结果 |
1920
|---|---|---|---|
21+
| macOS arm64 | HVF、Ubuntu 24.04.4 Guest | 2026-09-05（0.6.0 生命周期修改） | 创建、扩容、同伴 SSH、stop/start、reload、recreate、部分状态与缩容通过 |
2022
| macOS 26.6.2 arm64 | HVF、QEMU 11.1、socket_vmnet | 2026-09-01（`v0.2.0`） | 选点创建/SSH/stop/start、增量创建已缓存镜像、whole status、whole destroy 通过 |
2123
| macOS 26.6.2 arm64 | HVF、QEMU 11.1、socket_vmnet | 2026-08-27 | 单节点与增量四节点通过 |
2224
| Ubuntu 26.04 amd64（`mx`） | KVM、QEMU 10.2.1、NetworkManager | 2026-09-01（`v0.2.0`） | 审计现存四节点 deployment 为存活并进入控制 Guest |
2325
| Ubuntu 26.04 amd64（`mx`） | KVM、QEMU 10.2.1、NetworkManager | 2026-08-27 | setup、单节点、增量四节点与卸载通过 |
2426
| macOS arm64 | HVF 宿主、TCG 兼容规则、Rocky Linux 8.10 arm64 | 2026-08-28 | 启动、stop/start、44.2 秒达到 readiness 通过 |
27+
| 已发布 Catalog `2026090501` | 9 个 Family、27 个 qcow2 工件 | 2026-09-05 | 工件校验、内置/公开字节一致，以及两个官方入口的签名更新通过 |
2528
| 已发布 Catalog `2026082903` | 9 个 Family、27 个已签名 qcow2 工件 | 2026-08-29 | 全量 SHA-256 校验与干净客户端拉取 `d13:stable` 通过 |
2629

2730
## 仍未完成
@@ -43,6 +46,31 @@ Package 门禁在 Commit `fc85b65ff6a24b0933b56ae1179be9ada2ba91b1` 通过；下
4346

4447
每条记录只属于当天真正执行过的准确 Checkpoint；后续源码或文档修改不会自动继承真机证明。
4548

49+
### Farrow 0.6.0 发布：2026-09-05
50+
51+
生命周期与 UX 修改通过 Claude Code Fable 5.1 / xhigh 两轮对抗性审查；发布元数据与 CI
52+
测试夹具修复也分别获得了后续批准。发布提交 `057774e3a13477782a2ae07bd71127d03c0f1ae7`
53+
通过完整的 Go 1.27.1 [源码 CI](https://github.com/pgsty/farrow/actions/runs/33959205857)，
54+
最新打包改动在 `13d9d70` 通过独立的
55+
[Snapshot 与软件包检查](https://github.com/pgsty/farrow/actions/runs/33958857302)。
56+
[Tag 工作流](https://github.com/pgsty/farrow/actions/runs/33959431603) 重复源码检查，
57+
验证四平台归档、四份 Linux 软件包、八份 SPDX、安装器、Homebrew Formula、发布元数据
58+
及全部 19 项校验和，生成包含 20 个资产的 Release。
59+
Release 已公开，全部资产摘要与校验清单一致。隔离的 macOS arm64 安装目录通过公开下载
60+
路径从 0.5.0 升级到 0.6.0，两个已安装程序均与校验后的发布归档字节一致；发布二进制
61+
还通过了 `init` 和新建 U24 环境的 `plan` 验证。
62+
63+
隔离的 macOS arm64/HVF U24 环境通过了首次启动、不重启控制节点的扩容、控制节点到
64+
同伴的 SSH、stop/start、正常 reload、局部重建、缩容和 Guest 名称刷新。无效镜像 reload
65+
与存在配置冲突的局部重建均在影响现有 VM 前停止；部分状态损坏仍能展示健康节点，SSH 的
66+
255 退出码原样透传。最终的 Guest SSH 作用域修复经真实 OpenSSH 有效配置测试验证。
67+
验证结束后已移除测试环境。
68+
69+
已发布 Catalog `2026090501` 默认使用 `u24:stable`，并纳入 Catalog `2026090302` 中已经
70+
公开的 Debian/Rocky 镜像更新。27 个工件全部通过仓库字节校验，两个官方入口提供与内置
71+
目录完全一致的内容及生产签名，隔离客户端分别完成了 `farrow update`。本次应用发布没有构建新 Guest 镜像；没有重新执行 Linux
72+
宿主 VM 生命周期、宿主重启或完整 Pigsty 安装。
73+
4674
### Farrow 0.5.0 发布：2026-09-03
4775

4876
准确 Commit `fc85b65ff6a24b0933b56ae1179be9ada2ba91b1` 在打 Tag 前同时通过主干的完整
@@ -90,7 +118,7 @@ Checksum 与镜像，并已将 Nginx Worker 收敛为只读权限。
90118

91119
### Schema-3 Catalog 收口：2026-08-29
92120

93-
Catalog Revision `2026082903` 是当前源码与开发仓库检查点：9 个 Family、27 个分架构工件。
121+
Catalog Revision `2026082903` 是当天的源码与开发仓库检查点：9 个 Family、27 个分架构工件。
94122
内置 Catalog 与已发布 `catalog.json` 的 SHA-256 同为
95123
`571b1ff9c7d4d42355df3392ea62a339471c2d01d868669a7625fac8b93f245d`；
96124
已发布 `repo.yaml` 也与源码维护文件完全一致。全新 HTTP 与 HTTPS 客户端均接受了生产公钥

0 commit comments

Comments
 (0)