GitLab Orbit

GitLab Orbitはお使いのGitLabインスタンスをインデックス作成し、SDLC全体をクエリ可能なプロパティグラフとして公開します。 グループで有効にすると、GitLab Orbitはプロジェクト、ユーザー、マージリクエスト、パイプライン、 作業アイテム、セキュリティの検出結果、ソースコード自体をすべてマップし、それらの関係性を示すプロパティグラフを構築します。

グラフをクエリすることで、インスタンスだけでは直接回答できない質問に答えられます。

• このサービスを変更すると何が壊れるか？
• 過去90日間でこのファイルに変更を加えたマージリクエストはどれか？
• このグループで最もコードレビューを行ったのは誰か？
• 未解決のクリティカルな脆弱性はどこにあり、どのパイプラインが原因か？
• このライブラリに依存しているプロジェクトはどれか？

GitLab Orbitはある時点でのSDLCインサイトを目的とした分析システムであり、リアルタイムやトランザクション処理のユースケースには対応していません。結果は最後のインデックスサイクル時点のデータの状態を反映しています。

クリックスルーデモについては、GitLab Orbitをご覧ください。

GitLab Orbit Remote

GitLab.comでは、GitLab Orbit RemoteはGitLabインフラストラクチャ上で独立したサービスとして動作します。トップレベルグループで有効にすると、グループ、プロジェクト、ユーザー、マージリクエスト、パイプライン、脆弱性、ソースコードなど、SDLC全体とコードを自動的にインデックス作成し、マネージドClickHouseグラフに格納します。

flowchart LR
    accTitle: GitLab Orbit Remote architecture
    accDescr: SDLC data streams from GitLab via CDC to the Data Insights Platform, then to ClickHouse. Code is served over the Rails internal API. GitLab Orbit reads both sources, builds the graph in ClickHouse, and exposes it via REST API, MCP tools, and GitLab Duo Agent Platform.

    subgraph GitLab["GitLab instance"]
        SDLC[SDLC data]
        Code[Source code]
    end

    SDLC -- CDC --> DIP[Data Insights Platform]
    DIP --> CH[(ClickHouse)]
    Code -- Rails API --> Orbit[GitLab Orbit service]
    CH <--> Orbit

    Orbit --> REST[REST API]
    Orbit --> MCP[MCP tools]
    Orbit --> DAP[GitLab Duo Agent Platform]

GitLab Orbit Remoteは独立したサービスとして動作し、GitLabインスタンスへの負荷を最小限に抑えます。

GitLab Orbit Remoteを使ってみる

GitLab Orbit Local

GitLab Orbit Localはお使いのマシン上で完全に動作します。GitLab Orbit CLI（orbit）はローカルリポジトリを解析し、定義とクロスファイル参照を抽出して、グラフをローカルのDuckDBファイルに書き込みます。GitLabインスタンスやネットワーク接続は不要です。

flowchart LR
    accTitle: GitLab Orbit Local architecture
    accDescr: The GitLab Orbit CLI parses a local repository, builds a code graph, and writes it to a local DuckDB file. You query the graph via the CLI.

    Repo[Local repository] --> CLI["orbit CLI"]
    CLI --> DB[("DuckDB\n~/.orbit/graph.duckdb")]
    DB --> Query[CLI query]

GitLab Orbit Localはコードのみをインデックス作成します。マージリクエスト、パイプライン、作業アイテムなどのSDLCデータにはGitLab Orbit Remoteが必要です。

GitLab Orbit Localを使ってみる

GitLab Self-ManagedでのGitLab Orbit

GitLab Self-Managedでは、インスタンスの隣にあるKubernetesクラスター上でGitLab Orbitを実行します。このデプロイには、グラフにデータを供給するデータパイプライン（PostgreSQLロジカルレプリケーション、Siphon、NATS、ClickHouse）も含まれます。グラフとクエリインターフェースはGitLab.comと同一です。

GitLab Self-ManagedでGitLab Orbitを使ってみる

GitLab Orbitがインデックス作成する対象

GitLab Orbitは2つのカテゴリのデータをインデックス作成します。

• GitLabインスタンスのSDLCオブジェクト: グループ、プロジェクト、ユーザー、マージリクエスト、パイプライン、ジョブ、作業アイテム、マイルストーン、ラベル、セキュリティの検出結果。

• リポジトリのソースコード: ファイル、ディレクトリ、関数とクラスの定義、クロスファイルのインポート参照。コードはデフォルトブランチのみからインデックス作成されます。

GitLab OrbitはRuby、Java、Kotlin、Python、TypeScript、JavaScript、Rust、Go、C#、C、C++、PHPのコードをインデックス作成します。

インデックス作成の対象範囲 | スキーマリファレンス

はじめに

• GitLab Orbit Remoteを有効にして最初のクエリを実行する
• GitLab Orbit Localでローカルコードグラフを構築する
• GitLab Self-ManagedにGitLab Orbitをインストールする
• GitLab OrbitスキルでAIコーディングエージェントをセットアップする