开始使用 on Farrow

安装

Mon, 01 Jan 0001 00:00:00 +0000

当前可用的安装方式

从当前工作区构建：

cd /path/to/farrow
make build
export PATH="$PWD/bin:$PATH"
farrow version
farrow doctor

目前没有公开的 v1 软件包。不要用来源不明的二进制替换同一次构建产生的 farrow 与 farrow-hosts-helper。

教程

Mon, 01 Jan 0001 00:00:00 +0000

1. 创建实验环境

mkdir -p ~/lab
cd ~/lab
export FARROW_REPO=https://m0/farrow   # 离开开发网络后替换为可达镜像
farrow setup --dry-run
farrow setup --yes
farrow up

目录中没有配置时，setup 会写入单节点 farrow.yml：

日常操作

Mon, 01 Jan 0001 00:00:00 +0000

检查与访问

farrow status
farrow ssh meta
farrow exec node-1 -- hostname
farrow logs meta --source serial
farrow ss                         # 安装 SSH 别名，之后可直接 ssh meta

应用状态位于 ~/.farrow，这些命令可在任意目录执行。 Status 会显示持久化的 Guest 架构与加速器，因此 TCG 永远不是不可见回退。 plan、up、reload、recreate 依次优先使用 -f、当前目录发现的 Inventory，两者都没有时才回退到已应用规格；validate 始终需要文件。

故障排查

Mon, 01 Jan 0001 00:00:00 +0000

先做只读检查：

farrow doctor --json
farrow network status --json
farrow status --json

找不到配置

第一次部署时，在 farrow.yml/pigsty.yml 所在目录运行 plan、up、validate，或传入 -f /path/to/file。状态存在后，plan、up、reload、recreate 可回退到已应用规格；status、start、stop、SSH 与 destroy 始终使用已应用状态。如果 status 也打印同样消息，所选 FARROW_HOME 中没有已应用状态。