Skip to content

Commit 5dac71b

Browse files
VonngVonng
committed
docs: publish the Farrow 0.2.0 release
Document the selected-convergence fixes, native validation, checksum-only GitHub CI delivery, and the unchanged repo.pigsty.cc default image mirror in English and Chinese.
1 parent 1a64fb8 commit 5dac71b

6 files changed

Lines changed: 177 additions & 9 deletions

File tree

‎content/blog/release/_index.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Release Notes
33
linkTitle: Release
4-
description: Preserved pre-Farrow development records; Farrow has no public release yet.
4+
description: Current Farrow releases plus preserved pre-rename development records.
55
weight: 30
66
icon: fa-solid fa-clipboard-list
77
sidebar_root_menu: false
@@ -12,6 +12,6 @@ cascade:
1212
---
1313

1414
> [!IMPORTANT]
15-
> Farrow is pre-1.0. No public repository, Releases page, or downloadable
16-
> Farrow artifact is available. Entries below are historical Piglet records;
17-
> they do not establish post-rename Farrow validation or support.
15+
> Farrow is pre-1.0. Current signed release notes appear alongside preserved
16+
> Piglet development records; historical entries do not establish support for
17+
> current Farrow bytes.

‎content/blog/release/_index.zh.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: 发布注记
33
linkTitle: 发布
4-
description: 迁名前开发记录；Farrow 尚无公开版本。
4+
description: 当前 Farrow 发布与保留的迁名前开发记录。
55
weight: 30
66
icon: fa-solid fa-clipboard-list
77
sidebar_root_menu: false
@@ -12,5 +12,5 @@ cascade:
1212
---
1313

1414
> [!IMPORTANT]
15-
> Farrow 仍处于 pre-1.0，尚无公开仓库、Releases 页面或可下载构件。以下条目是
16-
> Piglet 时期的历史记录，不能作为 Farrow 迁名后的验证或支持承诺。
15+
> Farrow 仍处于 pre-1.0。当前签名发布说明与保留的 Piglet 开发记录并列展示；
16+
> 历史条目不能作为当前 Farrow 字节的支持承诺。

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

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: "Farrow 0.2.0: selected convergence and release integrity"
3+
linkTitle: Farrow 0.2.0
4+
description: VPN-aware network preflight, truly selected scale-out, committed-state integrations, signed multi-platform artifacts, and the 0.1.0 upgrade boundary.
5+
date: 2026-09-01
6+
weight: 1
7+
categories: [Release]
8+
tags: [Farrow 0.2.0, QEMU, macOS, Linux, Release, Supply Chain]
9+
icon: fa-solid fa-rocket
10+
---
11+
12+
Farrow 0.2.0 is the current public pre-1.0 release. It keeps the Pigsty
13+
inventory and on-disk deployment format introduced by 0.1.0 while fixing the
14+
network and selected-convergence boundaries found during the final native
15+
replay.
16+
17+
## What changed
18+
19+
- A less-specific VPN exclusion such as `10.0.0.0/8` no longer blocks
20+
Farrow's owned `10.10.10.0/24`; equal or more-specific foreign routes,
21+
overlapping interfaces, occupied addresses, and a missing owned route still
22+
fail closed.
23+
- `farrow up <node>` downloads and prepares only the selected node. Desired
24+
inventory peers without state appear as `absent`; SSH/hosts/provisioning,
25+
UUID and port allocation, lifecycle commands, and persistent-disk checks use
26+
the committed node set without losing future scale-out intent.
27+
- New guests write `# farrow-deployment-host` and remove both that marker and
28+
the released `# farrow-project-host` marker before adding current host rows.
29+
- Command cancellation, structured output, confirmation, `reload`, diagnostic
30+
redaction, installer retention, and the smaller dependency graph from the
31+
unpublished intermediate work are included directly in 0.2.0.
32+
33+
## Native and release evidence
34+
35+
The exact source commit completed a macOS arm64/HVF replay with MonoProxy
36+
active: selected `u24-1` create/SSH/stop/start, incremental cached `el9-1`
37+
create, two-node SSH, five explicit absent peers, and whole destroy all passed.
38+
On Ubuntu 26.04 amd64/KVM, the current Linux binary audited an existing
39+
four-node deployment and reached its control guest without mutation.
40+
41+
Local `make check`, source CI, and the complete packaging workflow passed. The
42+
tag workflow built four archives, amd64/arm64 DEB and RPM packages, SPDX SBOMs,
43+
Homebrew formula, installer, checksums, and release metadata. GitHub Actions
44+
publishes those verified CI outputs without a separate application signature
45+
or provenance bundle.
46+
47+
The signed image Catalog remains revision `2026082903` with 9 families and 27
48+
architecture artifacts. The default repository remains
49+
`https://repo.pigsty.cc/farrow`; `repo.pgsty.com/farrow` is an independently
50+
verified source/alternate endpoint, not the compiled default.
51+
52+
## Install or upgrade
53+
54+
Download `install.sh` and the assets from the
55+
[Farrow 0.2.0 GitHub Release](https://github.com/pgsty/farrow/releases/tag/v0.2.0):
56+
57+
```bash
58+
chmod +x install.sh
59+
FARROW_VERSION=0.2.0 ./install.sh
60+
farrow version
61+
farrow doctor
62+
```
63+
64+
0.1.0 deployment state remains readable. Run `farrow status` while retained
65+
VMs are live to converge any pre-release process-birth identity. Existing
66+
guests adopt the new `/etc/hosts` marker when recreated.
67+
68+
Because Farrow is still below 1.0, GitHub labels 0.2.0 as a pre-release even
69+
though it is the published current release.

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

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: "Farrow 0.2.0：选点收敛与发布完整性"
3+
linkTitle: Farrow 0.2.0
4+
description: VPN 感知网络预检、真正的选点扩容、基于 committed state 的集成、CI 多平台构件与 0.1.0 升级边界。
5+
date: 2026-09-01
6+
weight: 1
7+
categories: [发布]
8+
tags: [Farrow 0.2.0, QEMU, macOS, Linux, 发布, 供应链]
9+
icon: fa-solid fa-rocket
10+
---
11+
12+
Farrow 0.2.0 是当前公开的 pre-1.0 发布。它保留 0.1.0 引入的 Pigsty Inventory 与
13+
磁盘 Deployment 格式，同时修复最终真机重放中发现的网络与选点收敛边界。
14+
15+
## 主要变化
16+
17+
- `10.0.0.0/8` 等较宽 VPN 排除路由不再误拦 Farrow 自有的
18+
`10.10.10.0/24`；相同或更具体的外部路由、重叠接口、已占用地址与自有路由缺失
19+
仍然 Fail Closed。
20+
- `farrow up <node>` 只下载并准备选中的节点。Inventory 中没有 State 的 desired
21+
peer 显示为 `absent`；SSH/hosts/provision、UUID/端口分配、生命周期与持久盘校验
22+
使用 committed 节点集合，同时保留后续扩容意图。
23+
- 新 Guest 写入 `# farrow-deployment-host`；添加当前 hosts 行前，会同时清理该标记
24+
与 0.1.0 发布过的 `# farrow-project-host`。
25+
- 未发布中间版本中的命令取消、结构化输出、确认、`reload`、诊断脱敏、Installer
26+
保留策略与依赖图精简，全部直接进入 0.2.0。
27+
28+
## 真机与发布证据
29+
30+
准确源码 Commit 在 MonoProxy 在线时完成 macOS arm64/HVF 重放：选点创建 `u24-1`、
31+
SSH、stop/start、增量创建已缓存的 `el9-1`、两节点 SSH、五个显式 absent peer 与
32+
whole destroy 全部通过。在 Ubuntu 26.04 amd64/KVM 上，当前 Linux 二进制无变更地
33+
审计了一套现存四节点 Deployment，并进入控制 Guest。
34+
35+
本地 `make check`、源码 CI 与完整 Packaging Workflow 均通过。Tag Workflow 构建
36+
四平台 Archive、amd64/arm64 DEB 与 RPM、SPDX SBOM、Homebrew Formula、Installer、
37+
Checksum 与 Release Metadata。GitHub Actions 直接发布这些已验证 CI 产物，不附加应用
38+
签名或 Provenance Bundle。
39+
40+
签名镜像 Catalog 仍为 Revision `2026082903`，包含 9 个 Family 与 27 个分架构工件。
41+
默认仓库继续使用 `https://repo.pigsty.cc/farrow`；`repo.pgsty.com/farrow` 是独立验收
42+
通过的源站/备用入口，不是编译默认值。
43+
44+
## 安装或升级
45+
46+
从 [Farrow 0.2.0 GitHub Release](https://github.com/pgsty/farrow/releases/tag/v0.2.0)
47+
下载 `install.sh` 与对应构件：
48+
49+
```bash
50+
chmod +x install.sh
51+
FARROW_VERSION=0.2.0 ./install.sh
52+
farrow version
53+
farrow doctor
54+
```
55+
56+
0.1.0 Deployment State 可直接读取。保留 VM 在线时运行一次 `farrow status`，可收敛
57+
任何发布前进程出生身份；现有 Guest 在重建时采用新的 `/etc/hosts` 标记。
58+
59+
Farrow 尚未达到 1.0，因此 GitHub 会把 0.2.0 标为 Pre-release；它仍是已经公开发布的
60+
当前版本。

‎content/docs/about/status.md‎

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,27 @@ aliases: [/docs/project/, /docs/project/status/, /docs/project/roadmap/, /docs/p
99
Farrow is pre-1.0. Source tests, dated native replays, packages, release, CI,
1010
and the public site are separate gates.
1111

12+
## Farrow 0.2.0 release — 2026-09-01
13+
14+
Source commit `59d1b62aebb3d044a317e4006cc8a0bf56f4feaf` is tagged `v0.2.0`.
15+
Its source CI and independently dispatched packaging workflow passed the exact
16+
commit. The stable local release path also built and verified all four platform
17+
archives, amd64/arm64 DEB and RPM packages, eight SPDX documents, paired helper
18+
digests, archive/package parity, Homebrew formula, installer, release metadata,
19+
and 19 checksummed final assets.
20+
21+
The current macOS arm64/HVF replay ran with MonoProxy's covering
22+
`10.0.0.0/8` exclusion present. Selected `u24-1` create/SSH/stop/start,
23+
incremental cached `el9-1` create, whole status with five absent desired peers,
24+
both SSH connections, and whole destroy/SSH-fragment cleanup passed. On Ubuntu
25+
26.04 amd64/KVM, the current Linux binary audited an existing four-node Farrow
26+
deployment as live and reached its control guest without mutating that host.
27+
28+
The compiled default image repository remains the signed COS-backed
29+
`https://repo.pigsty.cc/farrow`. The independently checked
30+
`https://repo.pgsty.com/farrow` source endpoint serves identical Catalog,
31+
authoring metadata, checksums, and image bytes with a read-only Nginx worker.
32+
1233
## Last recorded native replay — 2026-08-27
1334

1435
This matrix belongs to the exact checkpoint exercised that day. Later source
@@ -131,7 +152,7 @@ open.
131152
- EL7 through the current native Linux/amd64 lifecycle;
132153
- current 9p share replay;
133154
- a complete current Pigsty `configure → farrow up → install.yml` run;
134-
- published Homebrew/DEB/RPM consumption and release CI.
155+
- clean-host published Homebrew/DEB/RPM consumption.
135156

136157
Current built-in versions are `supported`, except EOL EL7 and the retained
137158
compatibility versions EL9 9.3/9.6 and EL10 10.0, which are `deprecated`.

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

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,24 @@ aliases: [/docs/project/, /docs/project/status/, /docs/project/roadmap/, /docs/p
88

99
Farrow 仍是 pre-1.0。源码测试、带日期的真机重放、软件包、发布、CI 与线上站点是不同门禁。
1010

11+
## Farrow 0.2.0 发布：2026-09-01
12+
13+
源码 Commit `59d1b62aebb3d044a317e4006cc8a0bf56f4feaf` 已标记 `v0.2.0`。
14+
该准确 Commit 的源码 CI 与独立手动触发的 Packaging Workflow 均通过。稳定版 Local
15+
Release 路径还构建并验证了四平台 Archive、amd64/arm64 DEB 与 RPM、8 份 SPDX、
16+
配套 Helper 摘要、Archive/Package 一致性、Homebrew Formula、Installer、Release
17+
Metadata 与 19 项最终 Checksum。
18+
19+
当前 macOS arm64/HVF 重放在 MonoProxy 的 `10.0.0.0/8` 覆盖排除路由存在时执行：
20+
选点创建 `u24-1`、SSH、stop/start、增量创建已缓存的 `el9-1`、含五个 absent desired
21+
peer 的 whole status、两节点 SSH，以及 whole destroy/SSH fragment 清理全部通过。
22+
在 Ubuntu 26.04 amd64/KVM 上，当前 Linux 二进制无变更地审计了一套现存四节点
23+
Farrow Deployment，并进入控制 Guest。
24+
25+
编译默认镜像仓库仍是签名的 COS 入口 `https://repo.pigsty.cc/farrow`。独立检查的
26+
`https://repo.pgsty.com/farrow` 源站提供字节一致的 Catalog、Authoring Metadata、
27+
Checksum 与镜像，并已将 Nginx Worker 收敛为只读权限。
28+
1129
## 最近一次有记录的真机重放：2026-08-27
1230

1331
该矩阵只属于当天真正执行过的准确 Checkpoint；后续源码或文档修改不会自动继承真机证明。
@@ -104,7 +122,7 @@ Root 已验证；当前 Linux/amd64 原生 Farrow 生命周期仍待重放。
104122
- 当前 Linux/amd64 原生 EL7 生命周期；
105123
- 当前 9p share 重放；
106124
- 完整的 Pigsty `configure → farrow up → install.yml`；
107-
- 公开 Homebrew/DEB/RPM 安装与发布 CI。
125+
- 干净宿主上的公开 Homebrew/DEB/RPM 安装。
108126

109127
当前内置版本均为 `supported`，只有 EOL EL7 与保留兼容版本 EL9 9.3/9.6、EL10 10.0
110128
为 `deprecated`。active/standby Catalog 公钥已经内置，但镜像仓库仍需迁离开发宿主，

0 commit comments

Comments
 (0)