# 資料保留政策 {#data-retention}

Tuist 對上傳的構件檔案，以及用於儀表板和分析見解的記錄，分別應用不同的保留政策。刪除已過期的構件檔案不會刪除其關聯的分析見解記錄。

就構件檔案而言，託管式 Tuist 伺服器採用以方案為基礎的保留期，上限為 30 日。在自託管實例上，構件清理功能預設為停用；營運人員可以選擇啟用，並為每種支援的構件類型設定獨立的保留期。

## 構件檔案 {#artifact-files}

### 託管式 Tuist 伺服器 {#hosted-artifact-files}

這些保留期定義了構件檔案在託管式 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 會避免進行無邊界的歷史擁有權查詢，因此這些檔案仍會保持可用。

### 自託管實例 {#self-hosted-artifact-files}

自行託管嘅構件清理係選擇性啟用，可以為每種構件類型分別設定，而且唔受 30 日上限限制。請參閱<.localized_link href="/guides/server/self-host/server#artifact-retention">自行託管構件保留設定</.localized_link>以了解支援嘅構件類型同部署選項。

## 儀表板與活動資料 {#dashboard-and-activity-data}

儀表板與活動記錄的保留政策獨立於構件檔案清理。以下保留期不因託管方案而異，包括 Enterprise 方案。

### Xcode 建構與測試分析見解 {#xcode-build-and-test-insights}

核心 Xcode 建構與測試記錄目前沒有固定的時間刪除計劃。其他報告數據，例如時間線步驟和機器指標，會獨立過期：

| 數據 | 保留期 |
| --- | --- |
| 建構摘要、每個檔案和每個目標的建構記錄，以及建構問題 | 沒有固定的時間刪除計劃 |
| 測試執行、模組和套件結果，以及個別測試結果 | 沒有固定的時間刪除計劃 |
| 建構時間線步驟及其捕獲的日誌 | 90 日 |
| 建構機器指標 | 90 日 |
| Xcode 項目圖記錄 | 30 日 |

這些記錄與[構件檔案保留期](#hosted-artifact-files)所涵蓋的可下載建構歸檔、結果套件和測試附件是分開的。在 Enterprise 方案中，這些檔案會保留 30 日；相關的建構和測試記錄在檔案過期後仍然可用。沒有固定時間刪除計劃的記錄並不保證永久可用。

### 其他儀表板和活動數據 {#other-dashboard-and-activity-data}

| 數據 | 保留期 |
| --- | --- |
| Gradle 建構記錄、任務記錄、快取事件記錄、Mix 建構記錄、編譯檔案記錄、建構步驟記錄和診斷、Cargo 建構記錄（包括聚合編譯快取測量）和編譯器觀察、Bazel 調用、Bazel 追蹤配置文件、索引配置文件步驟和操作診斷、待處理的 Bazel 配置文件和測試攝取記錄、Bazel 調用日誌，以及 Bazel 遠端操作快取觀察 | 90 日 |
| 持久模組詳情頁面上的 Xcode 模組編譯和快取歷史 | 30 日 |
| 持久詳情頁面上的任務、聲明的 Once 操作、Bazel BEP 操作、編譯檔案和模組觀察 | 90 日，上述 Xcode 模組除外 |
| 持久任務/操作/模組/檔案身份元數據 | 365 日無觀察 |
| Runner 作業日誌、存檔的 Runner 日誌和 Runner 作業機器指標 | 90 日 |
| Webhook 交付歷史 | 沒有固定的刪除計劃 |

持久詳情 URL 不依賴於特定建構的可用性。它們的身份元數據可能比單個觀察更長久，因此詳情頁面在所選期間內可能沒有歷史記錄。新歷史是從功能部署後收到的報告中索引的；現有的運行級別歷史不會向後複製。

ClickHouse 的內部 `system.*` 操作日誌表是在 ClickHouse 層配置的，而不是由 Tuist 的產品數據保留政策配置。它們預設是無邊界的；捆綁的自託管 Docker Compose 和嵌入式 Helm ClickHouse 配置可以限制它們，如 <.localized_link href="/guides/server/self-host/server#capping-operational-log-retention">限制操作日誌保留</.localized_link> 中所述。