資料保留
Tuist 對上傳的構件檔案與用於儀表板和洞察的記錄套用不同的保留政策。刪除過期的構件檔案不會刪除其關聯的洞察記錄。
針對構件檔案,託管版 Tuist 伺服器採用以方案為基礎的保留區間,上限為 30 天。在自託管實例上,構件清理預設為停用;管理員可以選擇啟用,並為每種支援的構件類型設定獨立的保留區間。
構件檔案#
託管版 Tuist 伺服器#
這些區間定義了構件檔案在託管版 Tuist 伺服器上的可用期限。
| 構件 | Air 與開源版 | Pro | Enterprise |
|---|---|---|---|
| 快取構件,包括 Xcode 快取、模組快取、Gradle 快取、Bazel 遠端快取檔案,以及來自 Tuist Runners 的 GitLab CI 快取封存檔 | 14 天 | 30 天 | 30 天 |
| App 預覽建置與圖示 | 30 天 | 30 天 | 30 天 |
| 建置封存檔 | 7 天 | 30 天 | 30 天 |
| 執行構件,包括結果套件與工作階段封存檔 | 7 天 | 30 天 | 30 天 |
| 測試執行附件 | 30 天 | 30 天 | 30 天 |
| 分片套件 | 7 天 | 14 天 | 30 天 |
有效的帳戶方案決定託管版的保留區間。若帳戶沒有有效訂閱,Tuist 會使用 Air 的保留區間。部分構件類型採用較短的區間,因為預期它們會被重新產生。
在 Tuist 記錄測試執行識別碼之前建立的測試附件,不會被自動刪除。在保留清理期間,Tuist 會避免進行無邊界的歷史擁有權查詢,因此這些檔案仍保持可用。
自託管實例#
自託管的構件清理為選擇性啟用,可依每種構件類型分別設定,且不受 30 天上限限制。請參閱自託管構件保留設定,了解支援的構件類型與部署選項。
儀表板與活動資料#
儀表板與活動記錄的保留政策獨立於構件檔案清理。下方的區間不因託管方案而異,Enterprise 亦然。
Xcode 建置與測試洞察#
核心 Xcode 建置與測試記錄目前沒有固定的時間型刪除排程。其他報告資料(例如時間軸步驟與機器指標)則有獨立的到期規則:
| 資料 | 保留期限 |
|---|---|
| 建置摘要、每檔案與每目標的建置記錄,以及建置問題 | 無固定時間型刪除排程 |
| 測試執行、模組與套件結果,以及個別測試結果 | 無固定時間型刪除排程 |
| 建置時間軸步驟及其擷取的日誌 | 90 天 |
| 建置機器指標 | 90 天 |
| Xcode 專案圖記錄 | 30 天 |
這些記錄與構件檔案保留區間所涵蓋的可下載建置封存檔、結果套件與測試附件是分開的。在 Enterprise 方案中,這些檔案會保留 30 天;相關的建置與測試記錄在檔案過期後仍可存取。沒有固定時間型刪除排程的記錄並不代表保證永久可用。
其他儀表板與活動資料#
Bazel 索引的分析步驟包含可為空的每個動作遠端佇列、輸入抓取、執行與輸出上傳時間,前提是這些時間能安全地關聯到某個動作。這些資料與分析檔共用 90 天的保留期限,且獨立於快取構件與計費記錄。
| 資料 | 保留期限 |
|---|---|
| Gradle 建置記錄、工作記錄與失敗工作及設定步驟的失敗訊息、快取事件記錄、Mix 建置記錄、編譯檔案記錄、建置步驟記錄與診斷、Cargo 建置記錄(包含彙總編譯快取測量值)與編譯器觀察結果、Bazel 呼叫、Bazel 追蹤分析檔、索引分析步驟與動作診斷、待處理的 Bazel 分析與測試匯入記錄、Bazel 呼叫日誌,以及 Bazel 遠端動作快取觀察結果 | 90 天 |
| Bazel 呼叫的開始時間,會將其列為執行中直到完成 | 2 天 |
| 持久化模組詳細頁面上的 Xcode 模組編譯與快取歷史 | 30 天 |
| 持久化詳細頁面上的工作、宣告的 Once 動作、Bazel BEP 動作、編譯檔案與模組觀察結果 | 90 天,上述 Xcode 模組除外 |
| 持久化的工作/動作/模組/檔案身分識別中繼資料 | 365 天內無觀察結果 |
| Runner 工作日誌、歸檔的 Runner 日誌,以及 Runner 工作機器指標 | 90 天 |
| 程式碼涵蓋率行詳細資料(每次測試執行的每行與每函式涵蓋率,顯示於檔案的涵蓋率頁面) | 31 天 |
| 每次測試執行的程式碼涵蓋率總計 | 365 天 |
| 提交的程式碼涵蓋率(其總計、目標與每檔案數值) | 3 年;僅由拉取請求新增的提交為 90 天 |
| Webhook 遞送歷史 | 無固定刪除排程 |
持久化詳細網址不依賴特定建置仍然可用。其身分辨識中繼資料的保存時間可能長於個別觀察結果,因此詳細頁面在所選期間內可能沒有歷史記錄。新功能部署後收到的報告才會建立新的歷史索引;現有的執行層級歷史不會回溯複製。
ClickHouse 的內部 system.* 作業日誌資料表是在 ClickHouse 層級進行設定,而非由 Tuist 的產品資料保留政策管理。預設情況下這些資料表沒有上限;隨附的自我託管 Docker Compose 與內嵌 Helm ClickHouse 設定可以限制其大小,詳情請參閱限制作業日誌保留。