etcd vfox-etcdetcd 版本管理
EN GitHub
开源 · 轻量 · 跨平台

每个 etcd 版本，
准备好下一次测试。

用 vfox 或 mise 管理 etcd、etcdctl 和 etcdutl。安装发布包，或为故障测试构建 failpoint 版本。

开始使用 查看发行记录

插件最低支持 vfox 0.3.0；本指南建议使用最新版 vfox。

ETCD / 开发环境v0.2.0
01 / etcd3.5.5
为下一次运行，准备好环境。
~/my-projectbash
$ vfox install etcd@3.5.5
$ vfox exec etcd@3.5.5 -- etcd --version
LinuxmacOSWindowsvfoxmise
[ 01 ]

服务与工具，一起就绪

安装 etcd 发布包，同时提供 etcdctl 和 etcdutl。

[ 02 ]

为故障测试而构建

Unix 系统可通过 BUILD_WITH_FAILPOINT=yes 从源码构建。

[ 03 ]

vfox 与 mise，任选其一

mise 可直接使用 vfox: 插件后端，无需维护第二套插件。

01 / 开始使用

几条命令，即刻开工。

先确认平台依赖，再选择版本管理器。发布包示例固定版本；failpoint 模式编译上游默认分支。

01 添加插件与依赖
vfox add --source https://github.com/version-fox/vfox-etcd/archive/refs/heads/main.zip etcd
02 安装指定版本
vfox install etcd@3.5.5
03 运行并验证
vfox exec etcd@3.5.5 -- etcd --version
01 准备运行环境
mise ls-remote vfox:version-fox/vfox-etcd
02 安装并选择版本
mise use -g vfox:version-fox/vfox-etcd@3.5.5
03 在指定环境中运行
mise exec -- etcd --version

02 / 日常开发

从第一次安装，到每天运行。

把版本留在项目里

在 Bash 中初始化 vfox，再固定项目版本。mise 用户可用 mise use 在当前项目选择版本。

Bash
eval "$(vfox activate bash)"
vfox use -p etcd@3.5.5
vfox exec etcd -- etcd --version

验证客户端工具

使用 exec 在选定版本的环境中运行工具，避免依赖全局 PATH。

Bash
vfox exec etcd@3.5.5 -- etcdctl version
vfox exec etcd@3.5.5 -- etcdutl version
FAILPOINT / UNIX

为故障注入准备 etcd

设置构建选项后安装，再通过 GOFAIL_HTTP 暴露本地 failpoint 控制端点。

failpoint 模式克隆上游默认分支；命令中的版本号只作为安装标识，不会选取对应版本的源码。请准备 Git、GNU Make 和该分支 go.mod 要求的 Go 版本。

Bash
BUILD_WITH_FAILPOINT=yes vfox install etcd@3.5.5
GOFAIL_HTTP="127.0.0.1:22381" vfox exec etcd@3.5.5 -- etcd

请使用全新安装：如果该版本已安装，切换构建模式前需先卸载。示例会在测试环境启动 etcd，按 Ctrl+C 停止。

03 / 你可能想知道

少一点疑问，多一点专注。

如何查找其他版本？

使用 vfox search etcd 或 mise ls-remote vfox:version-fox/vfox-etcd 查看可用版本。

failpoint 支持哪些平台？

仅支持 Unix 系统。普通 Windows 安装使用上游发布包。

安装后有哪些命令？

发布包提供 etcd、etcdctl 和 etcdutl；可通过 vfox exec 或 mise exec 运行。

如何更新插件？

运行 vfox update etcd。插件通过本仓库发布的 manifest 查询更新。

下一次运行，从这里开始。

源码、问题反馈和发行记录都在 GitHub。

查看 GitHub 仓库