快速部署

操作场景

本章节帮助用户高效地部署“利用RAGFlow搭建企业级知识库”解决方案。一键部署该解决方案时，参照本章节中的步骤和说明进行操作，即可完成快速部署。

操作步骤

1. 登录华为云解决方案实践，在“利用RAGFlow搭建企业级知识库”解决方案页面，单击“开始部署”，进入解决方案部署页。勾选“我已阅读”，单击“开始部署”。
   图1 资源栈创建页面
   
   图2 进入到创建资源栈页面，保持默认配置即可。
   

2. 在配置参数页面，根据表1 参数填写说明配置参数，然后单击“下一步”。
   图3 配置参数
   

   表1 参数填写说明

   参数名称	类型	是否可选	参数描述	默认值
   solution_name	String	必填	解决方案名称，取值范围：4~24个字符，支持小写字母、数字和中划线（-）。必须以一个小写字母开头。不能以中划线（-）开头。	ragflow
   ragflow_tag	String	必填	RAGFlow 版本标签，对应 GitHub Release Tag。合法的 GitHub Release 标签，格式为 v 主版本。必须以小写字母 v 开头。不允许填写分支名称，不能省略前缀 v。示例：v0.26.4。标签来源于 infiniflow/ragflow 仓库 Release 标签。不使用默认值的情况下，用户访问 GitHub Releases 页面查看发布标签，或使用 git ls‑remote 获取远程标签列表，也可参考 Docker Hub 镜像标签复制对应版本填入。	v0.26.4
   ecs_flavor	String	必填	云服务器实例规格，支持弹性云服务器（ECS）和华为云 Flexus X 实例。Flexus X 实例规格 ID 遵循命名模式 x1.?u.?g，例如 2vCPUs4GiB 对应 x1.2u.4g。有关具体的华为云 Flexus X 实例规格，请参阅控制台。有关 ECS 规格，请参阅部署指南配置，参见弹性云服务器规格清单。	x1e.8u.32g
   ecs_password	String	必填	云服务器密码，长度为8-26位，密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。管理员账户默认root。	Empty
   system_disk_size	Number	必填	云服务器系统盘大小，磁盘类型默认为通用型SSD，单位：GB，取值范围为40-1,024，不支持缩盘。	100
   bandwidth_size	Number	必填	弹性公网带宽大小，该模板计费方式为按流量计费。单位：Mbit/s，取值范围：1-300Mbit/s。	300
   charging_mode	String	必填	云服务器计费模式，默认自动扣费，可选值为：postPaid（按需计费）、prePaid（包年包月）。	postPaid
   charging_unit	String	必填	云服务器订购周期类型，仅当charging_mode为prePaid（包年/包月）生效，此时该参数为必填参数。取值范围：month（月），year（年）。	month
   charging_period	Number	必填	云服务器订购周期，仅当charging_mode为prePaid（包年/包月）生效，此时该参数为必填参数。取值范围：charging_unit=month（周期类型为月）时，取值为1-9；charging_unit=year（周期类型为年）时，取值为1-3。	1

3. 根据个人需求选择是否开启加密，密钥类型及获取方式详见说明。
   图4 加密密钥类型选择
   
   

   1. 默认密钥

   定义：当前账号、当前区域下，由OBS等其它云服务首次调用密钥管理服务时自动创建，密钥别名后缀固定为“/default”，由平台统一托管。

   获取方式：无需手动创建，OBS等其它云服务首次调用DEW加密功能自动生成，可在密钥管理界面查询，刷新下拉框即可使用。

   核心特点：可在密钥管理界面查询；不支持禁用、计划删除、共享，用户无自主管控权限。基础托管免费，仅超额API请求计费。每个密钥每月享有 20000 次 API 调用免费额度。单击价格计算页通过价格详情栏查看超额API请求计费详情。

   适用场景：小型正式环境、轻度合规需求，快速加密场景。

   2. 自定义密钥

   定义：用户在当前账号、对应区域自行通过KMS创建或导入的密钥，用户全权管控。

   获取方式：DEW控制台→同区域→创建密钥→刷新密钥列表选用。

   核心特点：支持密钥轮换、审计、禁用删除、跨账号共享；按需计费，单击价格计算页查看计费详情；权限自主可控。

   适用场景：企业生产环境、等保合规、需密钥管控与共享的场景。

   3. 共享密钥

   定义：其他华为云账号创建的自定义密钥，通过RAM资源共享授权给当前账号使用（默认密钥不支持共享）。

   获取方式：1. 归属账号创建自定义密钥，通过RAM共享至当前账号；2. 当前账号接受共享邀请，保证密钥与区域一致，刷新即可使用。

   核心特点：仅可使用、无权修改管控；对方取消共享/删除密钥即失效；由密钥归属方付费。

   适用场景：大型企业多账号架构，密钥统一由安全账号托管的合规场景。

   4.最简选型总结

   • 个人/测试：关闭加密，无需密钥（建议）
   • 普通正式环境：默认密钥（免费免配置）
   • 企业合规生产：自定义密钥（自主可控）
   • 企业多账号架构：共享密钥（统一托管）

4. （可选，如果使用华为主账号或admin用户组下的IAM子账户可不选委托）在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托，单击“下一步”。
   图5 资源栈设置
   

5. 确认配置，然后单击“创建执行计划”。
   图6 配置确认
   

6. 在显示的对话框中，输入执行计划名称，然后单击OK。
   图7 创建执行计划
   

7. 等待执行计划状态变为可用，然后在操作列中单击部署。在显示的对话框中，单击执行。
   图8 执行计划
   
   图9 确认执行计划
   

8. （可选）如果计费模式选择“包年包月”，在余额不充足的情况下（所需总费用请参考表2 资源和成本规划（包年包月）)请及时登录费用中心，手动完成待支付订单的费用支付。
9. 待“事件”中出现“Apply required resource success”，堆栈部署成功，表示顺利完成资源的下发和部署。堆栈部署成功后，平台部署脚本开始执行，耐心等待10分钟左右（受网络波动影响）。
   图10 部署完成
   
   图11 查看访问链接
   

10. 通过3030端口查看RAGFlow部署进程。
    图12 RAGFlow实时部署日志查看页
    
    图13 部署成功后，单击进入服务开始使用RAGFlow。