Gel CLI 服务器版本管理:`gel server list-versions` 命令完全指南
Gel CLI 服务器版本管理:gel server list-versions 命令完全指南
gel server list-versions 是 Gel CLI 中用于列出所有可用与已安装的 Gel 服务器版本的终端命令,它展示了版本清单的同时明确标记每个版本当前是否已安装以及以何种方式安装。本指南以官方文档 gel_server_list_versions.rst 为主体骨架,结合仓库内 gel server 命令族文档与 CLI 网络行为文档,逐项讲解命令语法、全部选项的实战用法、输出解析,以及它在"服务器版本安装—查询—卸载"完整生命周期中的定位。
命令概览
gel server list-versions 属于 gel server 命令族——该命令族专注于 Gel 服务器版本管理,同族还包括 gel server install(安装服务器版本)、gel server info(查看已安装服务器信息)和 gel server uninstall(卸载服务器版本),完整索引见 gel_server/index.rst。
命令语法
gel server list-versions [<options>]
该命令不接收位置参数,所有行为均由选项控制。
核心用途
server list-versions 将两类信息合并在一张表中呈现:
- available(可用版本):Gel 官方发布、可供本机下载安装的服务器版本;
- installed(已安装版本):本机已经通过
gel server install等方式安装好的服务器版本,并标明其安装方式。
对于同时管理多个环境(如稳定版、nightly 版并存,或一台机器上为不同项目维护不同版本)的开发者和运维人员,这是快速掌握本机 Gel 服务器版本资产的首选命令。
选项详解
该命令提供三个选项,分别用于改变输出格式、缩小查询范围和提取单一字段。
--json:以 JSON 格式输出
将默认的表格输出切换为机器可读的 JSON。适合与 jq 等工具链配合,在脚本中做版本判断、自动选择安装版本等场景。
$ gel server list-versions --json
JSON 输出通常包含每个版本的主版本号、可用性以及安装状态等字段,字段语义与下文 --column 的三个取值一一对应,因此 --json 也是各自动化脚本最常用的形态。
--installed-only:仅显示已安装版本
当本机安装了多个版本、而你只关心"现在装了什么"时使用,可过滤掉大量未安装的可用版本噪音:
$ gel server list-versions --installed-only
该用法在 CLI 总览文档 index.rst 中被明确推荐:配合卸载 CLI 工具前的清理流程,先用 gel instance status 列出实例、再用 gel server list-versions --installed-only 查看服务器版本资产,是彻底移除 Gel 环境前的标准检查步骤。
--column=<column>:单列输出
将输出压缩为单列、单方面信息,取值仅有三个,与命令核心字段一一对应:
| 取值 | 含义 |
|---|---|
major-version |
仅输出主版本号(如 6.0、5.0) |
installed |
仅输出安装状态 |
available |
仅输出可用状态 |
典型用法是在脚本中快速提取所有主版本号,例如:
$ gel server list-versions --column=major-version
三个取值与 --json 输出中的字段同名,便于在两种输出形态间对照理解。
输出与版本语义解读
默认表格输出
不带任何选项时,命令输出一个版本清单表格,每个版本对应**主版本号、是否可用、是否已安装(含安装方式)**三方面信息。表格中的"已安装"状态还可能细分安装方式(如本地二进制包),这与 gel server install 支持的多通道安装机制(详见下文)一致。
版本号形态
Gel 的版本体系包含两类:
- 稳定版主版本:如
6.x、5.x,以major.minor形式呈现; - nightly(每夜构建):追踪最新开发分支的每日构建版本,在
gel server install中以--nightly单独指定。
list-versions 将两者统一纳入清单,方便对比稳定版与开发版的可用与安装情况。若只关心开发版,可配合 --column 过滤关注字段。
实战场景与命令族配合
场景一:新机器初始化——先查后装
# 1. 查看当前有哪些版本可用、哪些已安装
$ gel server list-versions
# 2. 只关心已装了什么
$ gel server list-versions --installed-only
# 3. 在脚本中提取全部可用主版本号
$ gel server list-versions --column=available
场景二:脚本化版本管理
--json 与 --column 是脚本友好的两个选项。例如通过 JSON 输出判断指定版本是否已安装,未安装则触发安装:
$ gel server list-versions --json | jq '.[] | select(.major-version == "6.1")'
配合 gel server install 的 --version=<version>(安装指定版本)与 --nightly(安装每夜构建)选项,可以构建"查询—安装—确认"的完整闭环:
$ gel server install --version 6.1
$ gel server list-versions --installed-only # 确认 6.1 已出现在已安装列表中
场景三:环境清理前的资产盘点
CLI 总览文档 index.rst 给出卸载流程:先列出实例与服务器版本,再依次执行 gel instance destroy <instance_name> 与 gel server uninstall,最后删除 CLI 二进制本身。其中盘点步骤正是:
$ gel instance status
$ gel server list-versions --installed-only
list-versions 是确认"还有哪些服务器版本残留"的关键一步,避免卸载后遗留无用版本占用磁盘。
关联命令族与底层机制
与 gel server install / info / uninstall 的关系
server list-versions 处于版本管理的查询中枢位置,与同族命令构成完整生命周期:
| 命令 | 作用 | 与 list-versions 的关系 |
|---|---|---|
| gel server list-versions | 列出可用与已安装版本 | 版本清单总览 |
| gel server install | 安装指定版本(--version、--nightly、-i/--interactive) |
把可用版本变为已安装版本 |
| gel server info | 查看已安装版本详情(--json、--nightly、--latest、--bin-path、--version) |
针对单个已安装版本的深挖 |
| gel server uninstall | 卸载版本(--all、--nightly、--unused、--version、-v/--verbose) |
从已安装列表中移除版本 |
典型工作流:list-versions 查看全貌 → install 安装 → info 验证单版本细节 → uninstall 清理;而 list-versions --installed-only 则始终是各阶段的"确认仪表盘"。
底层机制:数据从哪里来
从 CLI 网络行为文档 network.rst 可以确认该命令的底层数据来源:
- 版本可用性数据来自
https://packages.geldata.com上的包索引(package indexes)与 Docker 镜像索引(https://registry.hub.docker.com); - 请求 URL 中编码了平台、架构与是否 nightly 的信息,例如
GET /archive/.jsonindexes/linux-x86_64.json; - 安装路径上还涉及包管理器(如
apt-get、yum)与 Docker 引擎等间接数据源。
因此 list-versions 展示的"available"状态是实时联网查询的结果,而"installed"状态则来自本机安装记录。对网络受限环境,文档明确说明可完全绕开 server 命令族——Gel 全部功能均不依赖这些便捷安装命令。
小结
gel server list-versions 用一条命令完成"可用版本 + 已安装版本"的双重盘点:
- 默认表格输出可读性最佳,适合日常人工检查;
--installed-only聚焦本机已装版本,是清理、卸载前的标准检查手段;--json与--column面向脚本与自动化,字段语义与 JSON 输出一一对应;- 与
server install、server info、server uninstall共同构成完整的服务器版本生命周期管理,其"available"数据实时来自 Gel 官方包索引,而"installed"数据反映本机真实状态。
参考文档:gel_server_list_versions.rst、gel_server/index.rst、network.rst、CLI 总览、实例管理指南。