MXC 將工作負載意圖與執行工作負載的平台機制分離。 你的主應用程式使用 .NET、TypeScript 或 Rust SDK 來描述資源權限和請求執行。 MXC 將請求轉換為目前主機上容器後端的操作。
這種設計為應用程式提供一致的整合面,卻不聲稱每個後端都具備相同的功能或隔離特性。
架構層
MXC 整合包含四個主要層次:
| 階層 | 責任 |
|---|---|
| 主機應用程式或代理程式執行階段 | 分類任務、選擇受信任的政策預設值、提供輸入,並處理輸出與核准 |
| MXC SDK 與原則合約 | 偵測支援情況、將工作負載意圖轉換為版本化配置、啟動沙盒,並公開生命週期與診斷功能 |
| MXC 執行層 | 驗證設定、解析後端,並將支援的合約轉換為平台操作 |
| 容器後端 | 建立執行環境並強制執行平台與後端所支援的原則功能 |
主機應用程式仍負責政策決策。 編碼代理可以建議模型或資源授權,但不得在未經可信邏輯或人類批准的情況下自行選擇或擴展權限。 主機在 MXC 外執行的程式碼會被排除在工作負載的隔離範圍之外。
原則、設定與執行階段設定
政策描述了工作負載可能存取的內容。 執行請求會新增要執行什麼、在哪裡執行,以及使用哪個容器。 執行階段設定提供執行所需的值,例如已在執行中的代理伺服器端點。
V1 SDK 將這些設定包含在一個 ContainerRequest. 其檔案系統、網路與使用者介面屬性描述存取權限,指令、工作目錄、環境、逾時及包含屬性則描述執行。 SDK 會將請求轉換成穩定的 1.0.0 結構描述合約,所以你不需要指定結構描述版本。
JSON 執行設定無法與序列化的 SDK 物件互換。 例如,請求的 ui.allowInputInjection 和 timeoutMs 屬性分別對應於組態中的 ui.injection 和 process.timeout 設定。 使用 SDK 類型,或是你所撰寫之設定的版本的結構描述。
單次與狀態感知生命週期
MXC 支援兩種生命週期模式。
一次性執行 會建立沙盒,執行一個工作負載,然後拆除沙盒。 它可用於獨立的程式設計代理工具、產生的指令、建置、測試和腳本。 每個行動新增一個狹窄的沙盒,限制了保留狀態的範圍,並減輕制定單一廣泛政策的壓力。
狀態感知執行包含五個階段:配置、啟動、執行、停止與取消配置。 配置會回傳一個不透明的 ContainerId,呼叫者將其原封不動地傳遞到後續階段,且可在拆除前執行多個指令。 只有當工作負載依賴於持久狀態時,例如代理設定檔、已安裝的工具、設定或作業系統環境,才可使用此模式。 在 MXC 1.0 中,V1 SDK 生命週期 API 支援 IsolationSession 與 WSLc。
狀態感知執行並不代表 MXC 是狀態擁有者。 後端擁有沙箱資源,呼叫者則儲存其識別碼並管理其生命週期。 停止執行與取消資源配置是不同的操作;究竟哪些狀態會在停止後保留,取決於後端。
執行、產生程序和 PTY 執行 描述的是你的主機如何與正在執行的程序互動,而不是環境存在的時間長短。 run 呼叫在執行結束時回傳擷取的輸出。 spawn 呼叫會在工作負載運行時,給你的主機即時提供標準輸入、輸出和錯誤串流。 PTY 呼叫會將工作負載連接到由你的主機控制的偽終端機,包括其尺寸。 請檢查所選的 SDK 和後端是否支援這些組合。
主持人職責
設定執行逾時,分別處理工作負載失敗、啟動失敗和取消。 取消 SDK 等待不一定等於終止工作負載。 遵循 SDK 的終止與資源釋放規約,完成必要的等待時間,以便執行及可選的拒付結果擷取得以完成。
對於狀態感知執行,即使後期階段失敗,也要安排清理。 停止失敗不應該阻止你嘗試解除佈建應用程式擁有的資源。
沙盒拆除通常不會撤銷對已授權主機目錄的寫入或透過允許的網路服務執行的操作。 有意識地選擇輸出位置,並決定在後續任務使用前要保留哪些結果。
選擇一種包含類型
從您的工作負載的目標和限制開始,例如:
| 工作負載需求 | 起始類型 | 原因為何 |
|---|---|---|
| 需要已選定的主機工具和路徑且啟動成本低的指令 | 程序隔離 | 它會在主機環境中執行,權限範圍是針對該任務 |
| 需要獨立 Windows 設定檔或互動式工作階段的工作負載 | 會話隔離 | 將工作負載的使用者與工作階段狀態與互動式使用者環境分離,不使用 MXC 檔案、網路或使用者介面過濾 |
| 需要獨立核心或客體作業系統的工作負載 | 虛擬化環境 | 使用虛擬機或微型虛擬機邊界,並受所選後端的能力限制 |
在 Windows 上,程序隔離是一種常見類型,因為它能以低啟動成本適用於許多需要特定主機資源的工作負載。
工作階段隔離會將使用者和工作階段彼此隔離,但不限制工作負載能存取的內容。 在 Windows 上,IsolationSession 會拒絕檔案系統和使用者介面政策。 其請求還必須將出口、入口及主機迴路設定為 allow,且沒有任何網路規則或代理。 如果工作負載需要這些限制,選擇能強制執行這些限制的後端。 詳情請參見 後端選擇與設定。
抽象意圖,例如 process,讓 MXC 能夠解析為特定平台的後端。 當你需要特定的作業環境或生命週期時,選擇具體的後端程式。 請注意,無論是抽象意圖還是更強的隔離機制,都無法保證每個檔案、網路或使用者介面控制項都能得到支援。
請參閱 MXC 的容器選項與平台支援,以獲得選擇指引及詳細後端文件連結。
架構中的學習模式
學習模式有助於 Windows ProcessContainer 工作負載的政策撰寫與診斷。 請參閱 「使用學習模式建立及微調 MXC 原則」。
程式設計代理設計指引
使用程式碼代理來協助選擇容器類型時,請它評估:
- 應用程式必須支援哪些作業系統和處理器架構?
- 工作負載需要哪些檔案、網路路徑、使用者介面功能、裝置和主機工具?
- 每個指令是獨立的,還是必須在指令間保持身份和狀態?
- 有哪些啟動時間、資源使用、部署及互動限制?
- 工作負載需要 Windows、Linux、完整桌面或其他作業環境嗎?
- 哪種隔離邊界適合工作負載的信任假設與資料?
- 各可用的後端系統可強制執行哪些所要求的原則功能?
代理程式應比較可行的隔離類型,陳述其假設與權衡,並識別未被支持的需求。 接著你可以選擇合適的包含類型並建立原則。