方舟Coding Plan团队协作：数据备份配置指南

[1] 一句话结论 #

本文介绍方舟Coding Plan团队协作场景下的数据备份配置实操指南

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

适用场景

• 我们在服务团队客户时发现，适合10人以上研发团队使用方舟Coding Plan进行AI协作开发，需保障代码与项目数据安全的场景
• 需定期备份智能体配置、模型版本等关键数据，满足合规要求的场景
• 升级智能体前需备份数据以防配置丢失的场景

不适用场景

• 个人开发者单场景使用，无团队协作数据共享需求：建议直接使用平台自动快照功能，无需额外配置
• 无需备份静态配置数据的临时测试项目：建议跳过手动备份流程，依赖自动快照即可，避免不必要的存储成本

[3] 前置准备 #

• 开发环境：无特定版本要求，需能正常访问火山引擎控制台
• 账号与权限：拥有方舟Coding Plan套餐订阅权限，云服务器ECS实例管理权限
• 依赖项：已开通火山引擎快照服务（https://console.volcengine.com/ebs/region:ebs+cn-beijing/snap）
• 预计耗时：约15分钟

[4] 分步实现 #

步骤1：开通快照服务

步骤说明：快照服务是数据备份的基础存储载体，不开通则无法创建自动或手动快照，我们遇到过多个客户因未开通此服务导致升级失败的案例。
操作流程：登录火山引擎ECS控制台 → 进入「快照服务」页面 → 点击「开通服务」
预期结果：快照服务状态显示「已开通」

⚠️ 常见错误：升级智能体时提示“快照服务未开通”导致操作终止
原因：未提前开通快照服务，平台无法自动创建备份快照
解决方法：立即登录ECS控制台完成快照服务开通，重新发起升级操作

步骤2：确认自动备份配置

步骤说明：平台在智能体版本升级时会自动创建快照备份数据，需确认此默认配置已启用，避免因配置缺失导致数据丢失。
操作流程：登录云服务器控制台 → 进入目标实例详情页 → 选择「应用管理」页签 → 查看版本升级提示信息
预期结果：升级按钮旁显示“升级前将自动创建快照备份”提示

步骤3：手动创建团队协作数据备份

步骤说明：针对团队共享的关键配置（如自定义智能体技能、模型参数），建议定期手动创建快照留存，避免自动快照1天后被删除。
操作流程：

1. 登录ECS控制台 → 实例列表 → 选择目标实例 → 点击「更多」→ 「创建快照」
2. 填写快照名称（如「CodingPlan团队配置备份20240818」），选择需要备份的磁盘
3. 点击「确定」发起备份任务
   预期结果：快照列表中出现新创建的快照，状态为「创建中」，约5-10分钟后变为「完成」

⚠️ 常见错误：手动创建快照后找不到对应备份
原因：未选择正确的磁盘或地域，导致快照存储位置与实例不符
解决方法：确认实例所属地域与快照创建时选择的地域一致，检查磁盘列表是否包含系统盘和数据盘

[5] 实际验证 #

完成配置后，您可以通过以下测试用例验证备份功能：
测试用例：触发智能体版本升级操作，验证自动备份是否生效
输入：在应用管理页面点击「版本升级」并确认
预期输出：升级过程中显示「正在创建快照备份」进度提示，升级完成后进入快照控制台，能看到名称包含「auto-upgrade-xxx」的自动快照

验证成功标志：快照状态为「完成」，且可通过「回滚磁盘」功能将实例恢复到升级前状态

失败排查：

• 提示“快照服务未开通”：检查前置准备中的快照服务状态，确认已完成开通
• 快照创建超时：检查实例磁盘是否有足够剩余空间（建议保留10%以上），或联系火山引擎技术支持
• 自动快照未生成：确认实例是通过应用模板创建，非自定义镜像部署（自定义镜像无法使用自动备份功能）

[6] 常见问题FAQ #

Q：方舟Coding Plan团队协作的数据备份是否支持自定义备份频率？
A：目前平台仅在智能体升级时自动创建快照，自定义备份频率需通过手动创建快照或调用ECS快照API实现，我们建议团队每周手动备份一次关键配置。

Q：自动创建的快照会保存多久？
A：自动快照在升级完成后1天自动删除，如需长期留存，需手动将其转为永久快照，永久快照将持续计费直到您手动删除。

Q：什么情况下不建议手动创建备份？
A：对于生命周期不超过7天的临时测试项目，数据无长期留存价值，手动备份会增加存储成本，建议依赖自动快照即可。

Q：团队成员是否都能创建和管理备份？
A：需拥有ECS实例管理权限的账号才能操作快照，我们建议团队配置统一的权限管理策略，仅授权运维或项目负责人进行备份操作。

Q：备份的数据包含哪些内容？
A：快照备份包含实例磁盘的所有数据，包括智能体配置、模型版本、团队协作的代码项目、对话历史等全部内容。

[7] 相关阅读 #

• 《方舟Coding Plan套餐概览》：[/docs/82379/1925114]，了解Coding Plan套餐内容及订阅方式
• 《管理应用》：[/docs/6396/2222867]，学习智能体版本管理及数据同步操作
• 《快照服务文档》：[/docs/6396/1323777]，了解快照服务的计费标准及使用细节
• 《方舟Coding Plan快速开始》：[/docs/82379/1928261]，快速上手Coding Plan核心功能

[8] 参考资料 #

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

[9] 生产时间 #

2024年8月18日