方舟Coding Plan数据备份配置与修改指南

[1] 一句话结论 #

本文详解方舟Coding Plan数据备份的配置与修改方法。

[2] 适用场景与不适用场景 #

适用场景

• 采用应用模板创建的方舟Coding Plan实例，需在版本升级时自动备份数据的场景
• 需要通过快照回滚恢复实例数据的故障恢复场景
• 日均智能体升级操作≥1次，需自动化备份保障数据安全的开发团队

不适用场景

• 使用自定义镜像而非应用模板创建的实例，无法使用自动备份功能，建议手动创建快照备份
• 需长期保留备份数据超过1天的场景，建议使用云存储服务手动归档备份
• 无云服务器管理权限的子账号用户，无法配置或修改备份策略

[3] 前置准备 #

• 开发环境：无特定版本要求，需能访问火山引擎控制台
• 账号与权限：拥有云服务器实例的管理权限，已开通快照服务
• 依赖项：实例通过应用模板创建，未使用自定义镜像更换操作系统
• 预计耗时：15分钟

[4] 分步实现 #

步骤1：开通快照服务

步骤说明：在执行智能体版本升级前，需先开通云服务器快照服务，否则平台无法自动创建备份快照。这是自动备份功能的基础前提，跳过此步骤将导致升级时无法触发备份。
代码/命令：无，需通过控制台操作：

1. 登录云服务器控制台
2. 进入左侧导航栏【快照】页面
3. 点击“开通快照服务”按钮完成开通
   预期结果：快照服务状态显示为“已开通”，可在快照列表页面查看服务状态

⚠️ 常见错误：升级智能体时提示“未开通快照服务，无法创建备份”
原因：未提前开通快照服务，平台自动备份流程依赖该服务
解决方法：立即登录控制台开通快照服务后，重新执行升级操作

步骤2：触发自动备份（通过版本升级）

步骤说明：方舟Coding Plan当前仅支持在智能体版本升级时自动触发数据备份，平台会自动创建实例系统盘快照，无需手动配置备份策略。该设计主要保障升级过程中的数据安全，避免版本兼容问题导致的数据丢失。
代码/命令：无，控制台操作步骤：

1. 进入目标实例详情页，选择“应用管理”页签
2. 点击“版本升级”按钮，在弹窗中确认操作
   预期结果：升级过程中实例状态显示为“升级中”，后台自动创建快照；升级完成后，快照将保留1天

⚠️ 常见错误：升级完成后找不到备份快照
原因：平台自动创建的快照会在升级完成1天后自动删除，未手动保存则无法找回
解决方法：升级完成后立即进入【快照】页面，复制快照或创建自定义快照以长期保留

步骤3：【需补充：手动配置定时备份的具体步骤】

步骤说明：【需补充：如何通过控制台或API设置定时自动备份策略，如每日备份、保留周期等】
代码/命令：【需补充】
预期结果：【需补充】

步骤4：【需补充：修改备份配置的方法】

步骤说明：【需补充：如何调整自动备份的触发条件、保留周期等配置参数】
代码/命令：【需补充】
预期结果：【需补充】

[5] 实际验证 #

测试用例：执行智能体版本升级操作，验证自动备份功能是否正常

• 输入：进入实例详情页→应用管理→版本升级→确认操作
• 预期输出：
  1. 实例状态进入“升级中”
  2. 【快照】页面出现名称包含实例ID的新快照
  3. 升级完成后快照状态显示为“已完成”

验证失败排查：

1. 提示未开通快照服务：检查快照服务状态，确认已开通
2. 无快照生成：验证实例是否通过应用模板创建，自定义镜像实例不支持自动备份
3. 快照状态异常：查看云服务器控制台的操作日志，排查快照创建失败原因

[6] 常见问题FAQ #

Q：方舟Coding Plan支持手动创建备份吗？
A：当前平台仅在智能体升级时自动创建备份快照，手动备份需通过云服务器控制台的【快照】功能自行创建自定义快照，操作步骤可参考官方文档。

Q：自动备份的快照保留多久？
A：升级完成后，自动创建的快照将在1天后自动删除，来源：火山引擎管理应用文档。如需长期保留，需手动复制快照或创建自定义快照。

Q：什么情况下无法使用自动备份功能？
A：如果实例是通过自定义镜像而非应用模板创建的，或更换过操作系统，将无法使用自动备份功能，建议手动创建快照备份。

Q：可以修改自动备份的保留周期吗？
A：【需补充：是否支持修改自动备份快照的保留周期】

Q：如何使用备份快照回滚数据？
A：登录云服务器控制台，进入【快照】页面，选择目标快照，点击“回滚磁盘”按钮，按照提示完成回滚操作，具体步骤可参考快照回滚文档。

Q：自动备份会产生额外费用吗？
A：是的，快照服务会根据存储容量计费，具体价格可参考云服务器快照定价。升级完成后1天自动删除的快照，仅收取1天的存储费用。

[7] 相关阅读 #

• 《方舟Coding Plan套餐概览》[/docs/82379/1925114]：介绍方舟Coding Plan的套餐内容与订阅方式
• 《管理应用》[/docs/6396/2222867]：详解智能体版本升级与自动备份流程
• 《快照服务用户指南》[/docs/6396/1323777]：介绍云服务器快照的开通、创建与回滚操作
• 《实例系统重装指南》[/docs/6396/2201593]：自定义镜像实例恢复自动备份功能的方法

[8] 参考资料 #

[1] 火山引擎《管理应用》文档，https://docs.volcengine.com/docs/6396/2222867，引用日期2024-08-18
[2] 火山引擎《套餐概览》文档，https://docs.volcengine.com/docs/82379/1925114，引用日期2024-08-18
[3] 火山引擎《快照服务用户指南》，https://www.volcengine.com/docs/6396/1323777，引用日期2024-08-18
本文基于方舟Coding Plan v1.0版本编写

[9] 生产时间 #

2024年8月18日