极狐 GitLab

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 chart7.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 查询 DSLGQL
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)
columnsRETURN n.<property>
order_by: "-n.<property>"ORDER BY n.<property> DESC
limitLIMIT <number>
aggregations 和 group_byRETURN 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 queryglab orbit query
glab orbit remote query --formatglab orbit query --response-format
glab orbit remote schemaglab orbit schema
glab orbit remote statusglab orbit status
glab orbit remote graph-statusglab 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_graphinvoke_command,并将 command_name 设置为 query_graph
get_graph_schemainvoke_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_statusGraphQL Group.orbit 或 Project.orbit
GET /api/v4/orbit/schemaGraphQL Query.orbit.schema
GET /api/v4/orbit/statusGraphQL Query.orbit.serviceStatus
GET /api/v4/orbit/query/templatesGraphQL 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.knowledgeGraphEnabledGroup.orbit.enabled
Group.knowledgeGraphAvailableGroup.userPermissions.updateKnowledgeGraphSetting
Group.orbitAccessGroup.orbit.access
Group.orbitTrialGroup.orbit.trial
Query.knowledgeGraphExcludedNamespacesQuery.orbit.excludedGroups
knowledgeGraphExcludedNamespaceCreateorbitExcludedGroupCreate
knowledgeGraphExcludedNamespaceDestroyorbitExcludedGroupDestroy

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 serveorbit grep 或 orbit context
orbit setup --install mcporbit setup
MCP 工具 run_sqlorbit grep 或 orbit context
MCP 工具 get_graph_schema无替代方案
MCP 工具 indexorbit 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.indexedindexing.projects.indexed
projects.total_knownindexing.projects.totalKnown
projects.gapsindexing.projects.gaps
sdlc_indexingindexing.areas
code_indexingindexing.areas
domainsitemCounts.domains
domains.itemsitemCounts.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.domainnodes.domain.name
nodes.primary_keynodes.primaryKey
nodes.label_fieldnodes.labelProperty
nodes.propertiesnodes.properties.nodes
nodes.properties.data_typenodes.properties.nodes.dataType
nodes.properties.enum_valuesnodes.properties.nodes.enumValues
edges.variantsedges.endpoints.nodes
edges.variants.source_typeedges.endpoints.nodes.source.name
edges.variants.target_typeedges.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 将无法启动。