目錄

Developers

registry 生命週期

registry 中的每個整合都遵循相同的生命週期:被提案、合併、維護,並最終被棄用或移除。該生命週期讓 registry 如實反映 Bricoop 實際支援的內容,所以使用者從不會連線到一個已無法運作的整合。每個階段都有明確的歸屬人和明確的動作;沒有任何東西會靜默漂移。

所有權

每個整合都有一位負責其 manifest 的維護者。維護者保持 manifest 的 metadata.yaml 聯絡欄位最新、回應針對該整合回報的問題,並在上游 Application 或 Provider 發生變更時發布版本升級。所有權在 manifest 中宣告,而不是隱含;沒有宣告維護者的整合不能發布。

維護

維護涵蓋版本升級、新的 models 和 capabilities 以及相容性更新。當上游 Application 或 Provider 發布破壞性變更時,維護者更新 manifest 的 version、minimal_client_version 或 minimal_application_version 並提交拉取請求。校驗器會在合併前對更新後的 manifest 執行,所以維護 PR 與新整合的處理方式完全相同。

棄用

被棄用的整合仍然可用,但在 catalog 中被標記並不再被推廣。棄用在 manifest 中宣告,而不是追溯套用;維護者設定棄用標誌並寫明原因。已經連線該整合的使用者可以繼續使用,但新使用者在連線前會看到棄用提示。

移除

移除是最後一個階段,只發生在整合損壞、被棄置或被替換時。移除標準要求該整合對大多數使用者已無法運作,或維護者已停止回應且找不到接替的歸屬人。移除隨一個刪除 manifest 子目錄的 release 發布;Bricoop Desktop 在下一次更新檢查時停止提供該整合。

緊急安全處理

整合中的安全問題會繞過正常的發布節奏。維護者(若整合歸屬人聯絡不上,則由 Bricoop 維護者)立即發布一個停用或移除該整合的緊急 manifest,然後再補上正常審查。緊急路徑的存在是為了讓一個有漏洞的整合不會在標準 PR 走審查時繼續執行。

版本: sha256:0c9b632d3173808bf3cd1594a727bf3c2226492f119fc8fc85402d27c41d3ce8 編輯此頁