开始使用 on Barn

快速上手

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

安装

本教程以 Barn 0.9.0 发布候选为准。当前请先从源码构建；以下发行包和 Homebrew 命令在 0.9.0 发布、Formula 更新之后使用，不能把文档中的链接当作已经发布的证明。进度见当前状态。

日常管理

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

本教程描述 Barn 0.9.0 发布候选。发布与验收边界见当前状态。

检查与访问

barn status
barn ssh meta
barn exec node-1 -- hostname
barn logs meta --source serial

应用状态默认位于 ~/.barn（可由 BARN_HOME 覆盖），这些命令可在任意目录执行。切换工作目录不会创建另一套 deployment。 Status 默认显示镜像和资源；--verbose 显示架构、加速器、SSH 端口和 PID， TCG 在普通输出中也明确标记。异常节点不会隐藏其他节点的状态。 barn up 会在选中 VM 启动后，根据完整 applied deployment 重建默认 SSH 别名；因此局部 up 不会删除未选中节点，可直接运行 ssh meta；如需手工重写，使用 barn ssh-config --install。 plan、up、reload、recreate 依次优先使用 -f、当前目录发现的 Inventory，两者都没有时才回退到已应用规格；validate 始终需要文件。

故障排查

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

本页描述 Barn 0.9.0 发布候选。使用版本相关说明前，请先检查 barn version。

先收集诊断信息（status 可能收敛中断的运行时状态）：

barn doctor --json
barn network status --json
barn status --json

下载与 PATH 问题

安装器从 GitHub Release 下载程序；--mirror 选择的是 Barn 镜像仓库，不会重定向安装器下载。如果访问 GitHub 需要代理，在终端将 HTTPS_PROXY 或 ALL_PROXY 设置为已有代理的地址。macOS 系统代理设置本身不会替命令行工具配置这些环境变量。

自动化与客机脚本

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

本文示例以 Barn 0.9.0 发布候选为准。宿主命令应由拥有部署的普通 Unix 用户运行。每次调用使用同一份 Inventory 和 BARN_HOME；切换工作目录不会创建独立实验环境。

存储、文件与服务访问

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

本教程使用 Barn 0.9.0 发布候选的接口。执行客机内检查之前，先完成快速上手。示例使用 meta 节点与默认子网；调整已有配置时，请沿用实际节点名称与地址。

创建 VM 前选择磁盘

每个节点默认有 64 GiB 根盘，以及挂载到 /data 的 128 GiB 非持久数据盘。 vm_disk 以 GiB 设置根盘大小，vm_disks 替换整个数据盘列表； vm_disks: [] 表示不配置额外数据盘。

macOS 虚拟机

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

重要

Barn 0.9.0 发布候选，尚未发布。 本页描述改名后的 barn mac，使用全新 Barn 状态，不提供旧开发环境迁移。改名前的实机记录保留在当前状态，不代表改名后已经完成同等验收。请以实际运行的 barn mac --help 为准。

镜像仓库

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

正常使用不需要先执行镜像命令：barn up 默认按本机架构解析 u24:stable，并拉取最终对应的不可变版本。 Barn 一直使用已安装构建内置的 Catalog，直到你运行 barn update：它会获取、校验并激活仓库当前的 Catalog；没有任何自动刷新。恢复时可用 image sync 显式激活精确 URL 或文件。

从源码构建

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

Barn 0.9.0 目前是尚未发布的候选版本。本页用于从包含改名变更的源码构建与检查；正式发布后的安装方式见快速上手。

选择源码

使用已经包含 Barn 改名变更的工作区。在源码推送到公开仓库后，也可以克隆：

卸载与清理环境

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

本页会删除虚拟机与本地数据。先确认当前状态，不要在仍需保留 Barn VM 时继续：

barn st

1. 删除 deployment

彻底删除节点、持久盘、密钥与 deployment 状态：