GitLab Orbit 的弃用与移除
Tier: 基础版,专业版,旗舰版
Offering: JihuLab.com,私有化部署
为正式发布,部分 GitLab Orbit 命令、端点和设置已发生变化。在升级之前,请将您的脚本、Agent 和集成迁移到正式发布版本。
最低版本
GitLab Orbit 需要以下版本或更高版本:
| 组件 | 最低版本 |
|---|---|
| GitLab CLI (glab) | 1.126.0 |
| GitLab Orbit CLI (orbit) | 0.163.0 |
| GitLab Orbit Helm chart | 7.0.0 |
| 极狐GitLab 私有化部署 | TBD |
如果 glab 安装的 GitLab Orbit CLI 早于 0.163.0,则 glab 1.126.0 及更高版本会安装最新版本。 要更新 GitLab Orbit CLI,请运行 glab orbit --update。
在 GitLab.com 和极狐GitLab 19.6 上,orbit schema 和 orbit status 在 GitLab Orbit CLI 0.160.0 及更早版本中会失败。
GitLab Orbit Helm chart
Offering: 私有化部署
在升级 chart 之前,请阅读 chart README 中的版本兼容性。
Chart 4.0.0 将 chart 从 gkg 重命名为 orbit。 gkg chart 不再发布新版本。请将您的 chart 引用更改为 oci://registry.gitlab.com/gitlab-org/orbit/orbit-helm-charts/orbit。
Chart 5.0.0 需要 GitLab Orbit 0.150.0 或更高版本。 Chart 5.0.0 默认从日志行中移除展开数据。要保留展开数据,请设置 metrics.expandedLogs.globalOverride: true。
Chart 6.0.0 默认关闭 Snowplow 分析。 要保留分析功能,请设置 analytics.enabled: true。
GitLab Orbit 0.143.0 移除了 /live 和 /ready 探针端点。 早于 3.0.0 的 chart 无法与 GitLab Orbit 0.143.0 或更高版本配合使用。
查询语言
极狐GitLab 19.6 移除了 JSON 查询 DSL。 GitLab.com 已先行移除。 极狐GitLab 19.4 和 19.5 仍接受 JSON 查询。 请使用 GQL 编写查询。
要转换 JSON 查询,请让您的 Agent 使用 glab orbit skills get orbit-gql-migration 加载 orbit-gql-migration skill。
| JSON 查询 DSL | GQL |
|---|---|
| query_type: "traversal" 或 "aggregation" | 省略 query_type。 |
| query_type: "neighbors" | (n:Label {id: 123})-[:TYPE]->(m) |
| query_type: "path_finding" | MATCH path = ANY SHORTEST (a)-[:TYPE*1..3]->(b) RETURN path |
| node_ids: [123] | (n:Label {id: 123}) |
| node_ids: [123, 456] | WHERE n.id IN [123, 456] |
| filters.<property>: <value> | WHERE n.<property> = <value> |
| relationships 与 from 和 to | (a)-[:TYPE]->(b) |
| hops: [1, 3] | (a)-[:TYPE*1..3]->(b) |
| columns | RETURN n.<property> |
| order_by: "-n.<property>" | ORDER BY n.<property> DESC |
| limit | LIMIT <number> |
| aggregations 和 group_by | RETURN n.<property>, count(m) AS <alias> |
| aggregation_sort: "-<alias>" | ORDER BY <alias> DESC |
GitLab CLI 命令
GitLab Orbit CLI 0.120.0 移除了 glab orbit remote 和 glab orbit local 命令。 glab 会将每个 glab orbit 命令传递给 GitLab Orbit CLI。 glab 1.105.0 将 glab orbit remote query的 --format 选项重命名为 --response-format。
| 已移除的命令 | 改用 |
|---|---|
| glab orbit remote query | glab orbit query |
| glab orbit remote query --format | glab orbit query --response-format |
| glab orbit remote schema | glab orbit schema |
| glab orbit remote status | glab orbit status |
| glab orbit remote graph-status | glab orbit status --full-path <path> |
| glab orbit remote tools | 无替代方案 |
| glab orbit remote dsl | 无替代方案 |
| glab orbit local <command> | glab orbit workspace <command> |
Agent skill
GitLab Orbit CLI 0.144.0 将 orbit-cli skill 重命名为 orbit。 测试版中的 skill 使用已移除的 glab orbit remote 命令。
要替换 Agent 中的 skill,请运行 glab orbit setup。 Setup 会移除旧的 orbit-cli skill。 如果 orbit-cli skill 中的文件与当前版本不同,Setup 会保留该 skill。请手动删除该 skill。
MCP 端点工具
极狐GitLab 19.3 从 /api/v4/orbit/mcp的 MCP 端点中移除了三个工具。调用已移除的工具会返回 Unknown tool 错误。
| 已移除的工具 | 改用 |
|---|---|
| query_graph | invoke_command,并将 command_name 设置为 query_graph |
| get_graph_schema | invoke_command,并将 command_name 设置为 get_graph_schema |
| get_graph_status | 无替代方案 |
例如,用于查询的 invoke_command 参数为:
json{"command_name": "query_graph", "parameters": {"query": "MATCH (p:Project {full_path: 'gitlab-org/gitlab'}) RETURN p.name"}}
REST API 端点
极狐GitLab 19.6 移除了以下 REST API 端点。 GitLab.com 已先行移除。
| 已移除的端点 | 改用 |
|---|---|
| GET /api/v4/orbit/graph_status | GraphQL Group.orbit 或 Project.orbit |
| GET /api/v4/orbit/schema | GraphQL Query.orbit.schema |
| GET /api/v4/orbit/status | GraphQL Query.orbit.serviceStatus |
| GET /api/v4/orbit/query/templates | GraphQL Query.orbit.queryTemplates |
| GET /api/v4/orbit/tools | /api/v4/orbit/mcp 上的 MCP tools/list |
| GET /api/v4/orbit/schema/format | 无替代方案 |
| GET /api/v4/orbit/schema/dsl | 无替代方案 |
GraphQL API 字段
极狐GitLab 19.6 移除了以下 GraphQL 字段和变更。 GitLab.com 已先行移除。
| 已移除的字段或变更 | 改用 |
|---|---|
| Group.knowledgeGraphEnabled | Group.orbit.enabled |
| Group.knowledgeGraphAvailable | Group.userPermissions.updateKnowledgeGraphSetting |
| Group.orbitAccess | Group.orbit.access |
| Group.orbitTrial | Group.orbit.trial |
| Query.knowledgeGraphExcludedNamespaces | Query.orbit.excludedGroups |
| knowledgeGraphExcludedNamespaceCreate | orbitExcludedGroupCreate |
| knowledgeGraphExcludedNamespaceDestroy | orbitExcludedGroupDestroy |
GitLab Orbit CLI 命令
GitLab Orbit CLI 0.160.0 将本地图谱命令归入 orbit workspace 下。 GitLab Orbit 不支持在本地图谱上使用 SQL。
| 命令 | 状态 | 改用 |
|---|---|---|
| orbit index | 已弃用 | orbit workspace index |
| orbit sql | 已弃用 | orbit grep 或 orbit context |
| orbit list | 已弃用 | orbit workspace list |
| orbit schema <table> | 已弃用 | 无替代方案 |
| orbit mcp serve | 在 0.165.0 中移除 | orbit grep 或 orbit context |
| orbit graph-status | 已弃用 | orbit status --full-path <path> |
| orbit ontology | 已弃用 | orbit schema |
| orbit skill | 已弃用 | orbit skills |
| orbit dsl | 在 0.160.0 中移除 | 无替代方案 |
| orbit tools | 在 0.160.0 中移除 | 无替代方案 |
| orbit repo-map | 在 0.160.0 中移除 | 无替代方案 |
orbit index、orbit sql、orbit list 和 orbit schema <table> 会输出一条警告,指明新命令。其他已弃用的命令可正常使用,不会输出警告。
在 GitLab Orbit CLI 0.160.0 及更高版本中,不带参数的 orbit schema 会显示极狐GitLab 实例的图谱 schema。
本地 MCP 服务器
GitLab Orbit CLI 0.165.0 移除了本地 MCP 服务器。 您的 Agent 改用 orbit grep 和 orbit context 读取本地图谱。 要将 MCP 客户端连接到 GitLab Orbit,请使用 GitLab Orbit MCP 端点。
| 已移除 | 改用 |
|---|---|
| orbit workspace mcp serve | orbit grep 或 orbit context |
| orbit setup --install mcp | orbit setup |
| MCP 工具 run_sql | orbit grep 或 orbit context |
| MCP 工具 get_graph_schema | 无替代方案 |
| MCP 工具 index | orbit workspace index |
早期版本的 orbit setup 可能会向您的 Agent 配置中添加 orbit MCP 服务器。在 GitLab Orbit CLI 0.165.0 及更高版本中,orbit setup 和 orbit uninstall 会移除该条目。
orbit status的输出
GitLab Orbit CLI 0.161.0 从极狐GitLab GraphQL API 读取索引进度。 当您传入 --full-path、--namespace-id 或 --project-id 时,此变更生效。 JSON 输出使用 GraphQL 字段名。
| 旧字段 | 新字段 |
|---|---|
| projects.indexed | indexing.projects.indexed |
| projects.total_known | indexing.projects.totalKnown |
| projects.gaps | indexing.projects.gaps |
| sdlc_indexing | indexing.areas |
| code_indexing | indexing.areas |
| domains | itemCounts.domains |
| domains.items | itemCounts.domains.entities |
| domains.items.state | 已移除 |
| indexing.last_completed_at | 已移除 |
| indexing.last_error | 已移除 |
indexing.state的值为大写,例如 READY。
indexing.areas 列表为每个域提供一个条目。
count的值为字符串。
如果您的极狐GitLab 实例没有 GraphQL orbit 字段,CLI 会读取 REST API。 此时输出会保留旧字段名。
如果不传入 --full-path、--namespace-id 或 --project-id,orbit status 会显示 GraphQL serviceStatus 字段。
orbit schema的输出
GitLab Orbit CLI 0.161.0 从极狐GitLab GraphQL API 读取 schema。 JSON 输出使用 GraphQL 字段名。 orbit status的 REST 回退同样适用于 orbit schema。
| 旧字段 | 新字段 |
|---|---|
| nodes.domain | nodes.domain.name |
| nodes.primary_key | nodes.primaryKey |
| nodes.label_field | nodes.labelProperty |
| nodes.properties | nodes.properties.nodes |
| nodes.properties.data_type | nodes.properties.nodes.dataType |
| nodes.properties.enum_values | nodes.properties.nodes.enumValues |
| edges.variants | edges.endpoints.nodes |
| edges.variants.source_type | edges.endpoints.nodes.source.name |
| edges.variants.target_type | edges.endpoints.nodes.target.name |
| schema_version | 已移除 |
| domains | 已移除 |
| nodes.style | 已移除 |
| nodes.outgoing_edges | 已移除 |
| nodes.incoming_edges | 已移除 |
GitLab Orbit 服务器配置
Offering: 私有化部署
GitLab Orbit 0.128.0 弃用了 metrics.prometheus.port 设置。 请改用 probe_server.bind_address。
当这两个设置指向不同端口时,GitLab Orbit 将无法启动。