Gel CLI `server uninstall` 完全指南:安全卸载与清理 Gel 服务器版本

原创2026-09-22 23:40:031,917 阅读
文章标签:数据库图数据库关系型数据库

Gel CLI server uninstall 完全指南:安全卸载与清理 Gel 服务器版本

gel server uninstall 是 Gel(原 EdgeDB)CLI 中 server 命令组的一员,用于从本机移除指定版本的 Gel 数据库服务器。本文将以该命令的官方参考文档为核心,结合仓库中 docs/reference/using/cli 目录下的完整 CLI 文档体系,系统讲解其语法、全部选项参数、实战卸载工作流,以及配合实例销毁、CLI 卸载完成整机清理的最佳实践,帮助你在多版本共存、nightly 试用、空间回收等场景下安全、精准地管理服务器版本。

命令定位:server 命令组中的"减法"

在 Gel CLI 中,服务器版本管理统一收敛在 gel server 命令组之下。根据 server 命令组索引,该组包含四个互相配合的子命令:

子命令 职责
gel server info 展示已安装服务器版本的信息
gel server install 安装指定版本的服务器
gel server list-versions 列出可用及已安装的服务器版本
gel server uninstall 从系统中移除指定版本的服务器

server uninstall 与 server install 是一对对称操作:前者负责"装入"某个服务器版本(默认安装最新 release,也可用 --nightly 安装每日构建版),后者负责"卸载"。理解这一点很重要——gel server uninstall 管理的对象是按版本划分的服务器软件包,而非某个具体的运行实例。一个已安装的版本可能被零个、一个或多个本地实例引用,这也直接决定了 --unused 选项的存在意义。

命令语法

根据参考文档,gel server uninstall 的命令语法为:

gel server uninstall [<options>]

该命令没有位置参数,全部能力通过选项(options)提供,命令本身也可在无任何选项时调用。CLI 的所有命令还共享一组通用的连接选项,可用于指定目标实例,不过对于本地服务器包管理这类操作,通常不需要额外指定连接目标。

选项详解

参考文档定义了五个选项,覆盖了"全量清理、按类型清理、按引用清理、精确指定版本、输出控制"五个维度:

--all

卸载所有已安装的服务器版本。

这是最彻底的清理方式,适合以下场景:

  • 你准备彻底放弃本地 Gel 环境,按 CLI 卸载流程 从机器上移除全部 Gel 组件;
  • 你的开发机积累了多个历史版本(例如 1.x、2.x、3.x 同时存在),需要一次性清空后从最新版本重新开始。

注意:--all 会移除机器上全部已安装的服务器版本,不会区分该版本是否仍被某个实例引用。在执行前应通过 gel instance status 确认没有仍需要的运行中实例,否则对应实例将因服务器版本缺失而无法启动。

--nightly

卸载 nightly(每日构建) 服务器版本。

Gel 的版本发布线分为正式 release 与 nightly 构建两类,server install --nightly 用于安装 nightly 版本,server uninstall --nightly 与之对应,用于在试用结束、验证完毕后退掉 nightly 构建。该选项与 --version 相比,更适合"我不知道当前 nightly 具体是哪个版本号,只想把它删掉"的场景——无需记忆版本号即可精准命中。

--unused

卸载未被任何实例使用的服务器版本。

这是最"安全"的清理选项。Gel 的本地实例由 gel instance 系列命令管理,每个实例在创建时(gel instance create)会绑定一个具体的服务器版本。当你升级了某个实例的服务器版本,或某个旧版本曾短暂安装后不再被引用,该版本就成为"未使用"状态。

--unused 的典型使用场景:

  • 长期迭代后,机器上积累了大量历史版本,绝大多数已无实例引用,执行一次 gel server uninstall --unused 即可安全回收磁盘空间;
  • 在执行 --all 之前,先用 --unused 做一次温和清理,保留仍在使用的版本。

由于该选项只处理"未被实例使用"的版本,它不会破坏任何现有实例,是日常维护中最值得优先使用的清理手段。

--version=<version>

指定要卸载的具体服务器版本号,实现精确卸载。

语法为 gel server uninstall --version=<version>,例如:

gel server uninstall --version=2.3

该选项适合多版本并存、需要精确定位某个版本时的操作,例如:

  • 某个版本存在已知问题,需要单独回退;
  • 升级验证完成后,仅移除被替换的旧版本,其余版本保持不动。

使用前可先通过 gel server list-versions 或 gel server info --version= 确认目标版本确实已安装,避免因版本号拼写错误导致命令找不到目标。

-v, --verbose

产生更详细的输出。

该选项在卸载过程中输出更丰富的过程信息,适合:

  • 在 CI/CD 或自动化脚本中需要完整日志留档时;
  • 卸载出现异常时排查问题,例如某个版本卸载不干净、文件被占用等情况。

它与 Gel CLI 其他命令的 -v/--verbose 语义保持一致,属于通用输出控制选项。

实战工作流:从查看、卸载到验证

参考文档本身只给出了命令语法与选项,将其放入完整的 CLI 体系中,一次规范的卸载操作应当包含以下四个阶段。

1. 盘点:查看已安装的服务器版本

卸载之前,先明确机器上"有什么"。使用 gel server list-versions 查看可用与已安装的版本:

# 只显示已安装的版本
gel server list-versions --installed-only

# 以 JSON 格式输出,便于脚本解析
gel server list-versions --json

# 只看某个维度,例如大版本号
gel server list-versions --column=major-version

该命令会明确指示每个版本是否已安装以及以何种方式安装,是卸载前最直接的"清单来源"。如需更详细的服务器信息,可配合 gel server info:

# 查看最新版本的信息
gel server info --latest

# 查看指定版本的信息(含二进制路径)
gel server info --version=2.3 --bin-path

2. 评估:确认版本与实例的引用关系

因为 --unused 的存在,了解"哪些实例在用哪些版本"能帮你决定用哪种方式卸载。使用 gel instance status 列出全部实例及其状态:

gel instance status

如果一个版本不再被任何实例引用,就可以放心地交给 --unused;如果某版本仍被实例使用而你想删除它,则需要先处理对应实例(见下一节)。

3. 执行:按需选择卸载方式

根据盘点与评估结果,从以下四种方式中选择:

# 方式一:卸载指定版本
gel server uninstall --version=2.3

# 方式二:卸载 nightly 版本
gel server uninstall --nightly

# 方式三:清理所有未被实例使用的版本(日常维护推荐)
gel server uninstall --unused

# 方式四:卸载全部版本(彻底清场)
gel server uninstall --all

在需要保留执行日志的环境中,可统一追加 -v/--verbose:

gel server uninstall --unused -v

4. 验证:确认卸载结果

执行完毕后,回到盘点命令确认结果:

gel server list-versions --installed-only

此时目标版本应已从"已安装"列表中消失;若执行的是 --all,则该命令的输出应为空。若使用 gel server info 查询已卸载的版本号,将无法再获取到对应信息。

组合场景速查

目标 推荐命令
单独移除某个具体版本 gel server uninstall --version=<version>
移除 nightly 构建 gel server uninstall --nightly
日常清理无用版本、回收磁盘 gel server uninstall --unused
清空所有服务器版本 gel server uninstall --all
需要详细日志的任何场景 上述命令追加 -v

完整清理:结合实例销毁与 CLI 卸载

gel server uninstall 只是服务器软件包层面的清理。如果你要做的是"从这台机器上彻底移除 Gel",参考 CLI 总览文档的 Uninstallation 章节,推荐顺序为:

  1. 销毁实例:对每个不再需要的本地实例执行

    gel instance destroy <instance_name>
    

    并可用 gel instance status 确认剩余实例清单。

  2. 卸载服务器版本:实例销毁完毕后,已安装的服务器版本即不再被引用,此时执行

    gel server uninstall --unused
    

    或彻底清理 gel server uninstall --all。

  3. 移除 CLI 本体:Linux/macOS 下直接删除单一二进制文件

    rm "$(which gel)"
    

    如需一并清除配置与数据目录,可用 gel info 查看 Gel 存储数据的目录位置后手动删除(仓库文档中给出的完整流程见 CLI 总览)。

这套顺序保证了"先停实例、再卸版本、最后删工具",避免出现实例仍在运行而服务器包已被移除的中间状态。

实现层面观察

从仓库源码看,Gel CLI 的主体由 Rust 实现:在 edb/cli/init.py 中,rustcli 函数通过 os.execvpe('gel', args, os.environ) 将进程切换到 gel 可执行文件,Python 侧仅作为启动垫片。因此 server uninstall 的选项解析与卸载逻辑位于 Rust 实现的 CLI 二进制中,本文所述语法与选项行为以 gel_server_uninstall.rst 官方参考文档为准。

需要说明的是,Gel 在近年由 EdgeDB 更名,本仓库中该文档的早期版本路径曾在 docs/redirects 中保留跳转记录(/cli/edgedb_server/edgedb_server_uninstall 重定向至当前路径),因此部分历史资料、博客中出现的 edgedb server uninstall 命令即为本命令的更名前的形式,二者语法与选项保持一致。

常见问题与注意事项

  • 卸载会删除数据吗? gel server uninstall 移除的是服务器软件包本身,不影响实例的独立数据目录;数据清理属于 gel instance destroy 的职责范畴。
  • 版本仍被实例使用能卸载吗? 参考文档并未声明强制约束,但 --unused 选项的存在说明"实例引用"是版本管理的核心维度。稳妥做法是先用 gel instance status 核实引用关系,避免删掉仍在使用的版本。
  • --all 与 --version 能混用吗? 二者语义上相互对立(一个表示全量、一个表示精确指定),实际使用时按单一目标选择其一即可。
  • nightly 与正式版是分开管理的吗? 是的,--nightly 作为独立选项存在,说明 nightly 构建与正式 release 被区别对待,卸载时可以精确命中构建类型而不必关心具体版本号。
  • 如何确认卸载成功? 执行后通过 gel server list-versions --installed-only 复查;在自动化流程中,可配合 --json 输出做程序化断言。
登录后查看全文
edgedb