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 不隱藏網路，而是將拓撲顯式化。它不引入執行時開銷，而是將拓撲決策前置到啟動時。專案的願景是讓分散式系統的拓撲成為像配置和基礎設施即程式碼一樣被管理的實體。