#如何设置项目的冷数据保留时间

本指南介绍在通过 冷热分离 开关启用 ClickHouse 冷存储时，如何配置项目级别的冷数据保留策略。

#操作前准备

请确保满足以下条件：

1. 集群使用的是 Alauda Container Platform Log Storage for ClickHouse。
2. ClickHouse 存储插件已启用 冷热分离。
3. ClickHouse 存储插件已配置冷数据 S3 Secret。
4. 您拥有编辑 global 集群中目标项目的权限。

#关于项目级别的保留设置

项目级别的设置会覆盖指定项目所属日志的默认保留行为。

在 Project 资源上使用以下标签：

部分环境中仍存在旧标签，但新的配置应使用上述标签。

#编辑项目资源

1. 登录 global 集群。

2. 打开目标项目资源：

   kubectl edit project <project-name>

3. 添加或更新以下标签：

   apiVersion: auth.alauda.io/v1
   kind: Project
   metadata:
     name: bookinfo
     labels:
       cpaas.io/project.hotDataRetentionDays: '7'
       cpaas.io/project.coldDataRetentionDays: '30'
       cpaas.io/project.logPolicyEnabled: 'true'

#标签行为说明

• cpaas.io/project.hotDataRetentionDays
  控制项目的热数据在活跃 ClickHouse 存储中保留的时长，之后根据存储策略进行迁移或删除。
• cpaas.io/project.coldDataRetentionDays
  控制项目的冷数据转存至 S3 后的保留时长。
• cpaas.io/project.logPolicyEnabled
  必须设置为 true，项目级保留策略才会生效。

#版本说明

• 在 ACP 4.2 环境中，部分旧标签和新标签可能共存以兼容历史配置。
• 在 ACP 4.3 及以后环境中，应以新标签为准。
• 如果环境中仍包含如 cpaas.io/project.esIndicesKeepDays 或 cpaas.io/project.esPolicyEnabled 等旧标签，新配置建议优先使用新标签。

#相关主题

• 插件侧冷存储配置，请参见 如何使用 S3 存储与 ClickHouse。
• ClickHouse 安装参数，请参见 安装。