Itara：將分佈式系統拓撲作為顯式的可執行層

Itara 是一個旨在將分佈式系統拓撲結構提升為顯式、可聲明、可驗證且可執行層的開源項目。在傳統的分佈式系統中，拓撲——即哪些組件存在、它們如何連接、使用什麼傳輸方式、如何處理故障——被分散在代碼庫中，作為實現決策的副產品。Itara 通過引入一個專門的配置層解決了這一問題。

系統的核心是一個名為“接線代理”（wiring agent）的組件，它在應用啓動前讀取一個 YAML 配置文件，解析所有連接，並將組件連接起來。一旦準備就緒，接線代理便退出，應用以全速運行，沒有任何中間代理或運行時決策。這個配置文件是系統拓撲的權威表示，描述了節點、組件和連接。例如，一個簡單的配置文件可以定義兩個節點“gatewayNode”和“calculatorNode”，並指定它們之間的傳輸方式為“direct”或“http”。

Itara 的工具生態系統使拓撲層安全且易於管理。CLI 工具包含“itara inspect”用於可視化拓撲圖，“itara verify”用於在部署前捕獲配置錯誤。此外，每個組件通過一個 .itara 元數據文件聲明其標識、版本、API 契約和能力，工具鏈在編寫時即可驗證兼容性，防止不正確的拓撲被靜默部署。

項目的核心設計原則是“拓撲是一等公民”。組件只聲明其接口，不聲明如何被調用——這由配置文件決定。接線代理在啓動時讀取配置，準備好所有連接，然後退出。這樣，代碼保持不變，而通信方式可以通過更改配置文件來切換，無需修改代碼、重新部署或編寫遷移腳本。

Itara 設計為可增量採用。一個組件只需三個要素即可參與：一個 API 工件（接口）、一個激活器（工廠方法）和一個配置文件條目。唯一引入的依賴是核心庫（如 itara-common）。業務邏輯本身不需要任何 Itara 導入。即使只在一個服務邊界上採用 Itara，也能獲得該連接的結構可觀測性和顯式的拓撲聲明。

項目提供了 Java 和 Rust 的參考實現，並計劃支持 Go、Python 和 C++。不同語言實現的組件可以參與同一個拓撲圖，並生成相同的分佈式跟蹤。在可觀測性方面，Itara 將可觀測性視為一等公民。每次組件調用都會產生四個事件：CALL_SENT（調用方側）、CALL_RECEIVED（被調用方側）、RETURN_SENT（被調用方側）和 RETURN_RECEIVED（調用方側）。這些事件的位置允許直接測量傳輸開銷（序列化、網絡延遲等），而無需編寫監控代碼。插件可以發出自定義跨度，OpenTelemetry 參考實現提供了跨 JVM 和跨語言的分佈式跟蹤。

Itara 還支持事件驅動拓撲，通過虛擬節點和事件契約實現。例如，Kafka 主題可以聲明為一個虛擬節點，事件驅動的通信也遵循四個事件模型。

目前，Itara 是一個概念驗證項目，包含一個演示：一個 Java 的“gateway”組件調用一個 Rust 的“calculator”組件，可以通過更改配置從直接調用切換到 HTTP 調用，而組件代碼不變。項目計劃進一步開發可視化編輯器和控制器等工具。

與傳統的服務網格或側車模式不同，Itara 不隱藏網絡，而是將拓撲顯式化。它不引入運行時開銷，而是將拓撲決策前置到啓動時。項目的願景是讓分佈式系統的拓撲成為像配置和基礎設施即代碼一樣被管理的實體。