登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

程序园 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›ragflow k8s部署详细过程

ragflow k8s部署详细过程

能杜孱 2025-6-5 10:06:38
一、概述

ragflow官方提供的安装方式是docker-compose方式部署的，单机运行。
k8s部署方式，暂未提供。
不过我们可以通过工具，结合docker-compose.yaml，来推演出对应服务的yaml进行部署。
过程有点曲折，结果很美好。
 
接下来，本文将使用ragflow-0.18.0，来进行演示详细部署过程。
二、准备工作

前提条件

硬件

CPU ：至少 4 核。
内存 ：至少 16GB。
磁盘 ：至少 50GB。
操作系统：推荐 Ubuntu 22.04+ 
软件

k8s，自行搭建，或者使用云厂商提供的k8s，都可以。
Harbor，参考文章：https://www.cnblogs.com/xiao987334176/p/18809269如果有现成的私有仓库，可以忽略NFS，参考文章：https://www.cnblogs.com/xiao987334176/p/18809415如果有现成的NFS，可以忽略 
符合以上条件，就可以部署了
镜像推送

下载镜像
  1. docker pull elasticsearch:8.11.3
  2. docker pull quay.io/minio/minio:RELEASE.2023-12-20T01-00-02Z
  3. docker pull mysql:8.0.39
  4. docker pull valkey/valkey:8
  5. docker pull infiniflow/ragflow:v0.18.0-slim
复制代码
 
推送镜像
这里使用shell脚本完成
  1. #!/bin/bash
  3. images="elasticsearch:8.11.3
  4. quay.io/minio/minio:RELEASE.2023-12-20T01-00-02Z
  5. mysql:8.0.39
  6. valkey/valkey:8
  7. infiniflow/ragflow:v0.18.0-slim"
  9. # 遍历镜像列表，并推送到harbor
  10. for line in $images; do
  11.     #echo "$line"
  12.     docker tag $line harbor.qq.cn:8083/ragflow/$line
  13.     docker push harbor.qq.cn:8083/ragflow/$line
  14. done
复制代码
注意修改harbor的的地址为实际访问地址
 
登录到harbor，查看镜像
1.png

 
创建命名空间以及密钥

创建命名空间ragflow
  1. kubectl create namespace  ragflow
复制代码
 
创建拉取镜像需要的密钥
  1. kubectl create secret docker-registry harbor-key --docker-server=harbor.qq.com:8083 --docker-username=devops --docker-password=1sB5r9UShgK5 --namespace=ragflow
复制代码
注意：修改harbor地址，用户名，密码。
 
下载部署yaml

yaml已经写好了，推送到我个人的github，地址：https://github.com/987334176/ragflow-k8s
下载项目后，进入文件夹0.18.0
 
目录结构
  1. env --> 全局环境变量
  2. pvc --> 所有组件，统一使用一个pvc来进行持久化存储
  3. databases --> 数据库相关：mysql，redis
  4. middleware --> 中间件相关：elasticsearch，minio
  5. services --> 服务相关：ragflow
复制代码
 
三、创建全局环境变量

这里有30个多个变量，直接一键运行
  1. kubectl apply -f env/env.yaml
复制代码
 
四、创建pv和pvc

创建storageClass，因为pv和pvc必须是同一个storageClass才能绑定成功
  1. kubectl apply -f pvc/storageClass.yaml
复制代码
 
注意：修改NFS 服务端的共享路径，provisioner必须指定为nfs-client
nfs-client是一个外部的动态存储供给器（Provisioner），用于在 Kubernetes 集群中动态创建和管理基于 NFS（Network File System）的 PersistentVolumes（PV）。它是 Kubernetes 社区提供的一个解决方案，用于支持 NFS 存储的动态供给。
 
创建pv，pvc。注意：这里的pv是自建的NFS，请根据实际情况修改
  1. kubectl apply -f pvc/pv.yaml
  2. kubectl apply -f pvc/pvc.yaml
复制代码
 
查看pvc状态，注意：请确保pvc状态为Bound
  1. # kubectl -n ragflow get pvc
  2. NAME       STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
  3. ragflow-pvc   Bound    ragflow     10Gi       RWX            nfs-storage    <unset>                 12m
复制代码
 
服务器已经挂载好了NFS，进入到NFS根目录
  1. cd /mnt/nfs_share
复制代码
 
创建ragflow相关持久化文件，并设置权限
  1. mkdir -p ragflow/volumes/elasticsearch/data
  2. mkdir -p ragflow/volumes/minio/data
  3. mkdir -p ragflow/volumes/mysql/data
  4. mkdir -p ragflow/volumes/redis/data
  5. mkdir -p ragflow/volumes/ragflow/logs
  6. chmod 777 -R ragflow
复制代码
 
五、数据库相关

MySQL

MySQL 是一个广泛使用的开源关系型数据库管理系统（RDBMS），它使用 SQL（结构化查询语言）作为与数据库交互的标准语言。
 
修改文件mysql-StatefulSet.yaml
  1. vi databases/mysql/mysql-StatefulSet.yaml
复制代码
 
修改红色部分，增加了密钥，改了镜像地址
  1.     spec:
  2.       imagePullSecrets:
  3.         - name: harbor-key
  4. ...
  5.           image: harbor.qq.com:8083/ragflow/mysql:8.0.39
复制代码
 
发布应用，注意执行顺序，先执行configMap，再执行下面的。
  1. kubectl apply -f databases/mysql/mysql-cm1-configmap.yaml
  2. kubectl apply -f databases/mysql/mysql-StatefulSet.yaml
  3. kubectl apply -f databases/mysql/mysql-Service.yaml
复制代码
 
等待1分钟，查看pod，确保是Running状态
  1. # kubectl -n ragflow get pods|grep mysql
  2. mysql-0   1/1     Running   1 (13m ago)   14m
复制代码
 
查看mysql日志
  1. # kubectl -n ragflow logs -f mysql-0
  3. ...
  4. 2025-04-28T02:32:18.925930Z 0 [System] [MY-010931] [Server] /usr/sbin/mysqld: ready for connections. Version: '8.0.39'  socket: '/var/run/mysqld/mysqld.sock'  port: 3306  MySQL Community Server - GPL.
  5. ...
复制代码
出现3306表示mysql启动正常。
 
测试mysql登录
  1. # kubectl -n ragflow exec -it mysql-0 -- /bin/bash
  2. bash-5.1# mysql -h localhost -u root -pinfini1#raGflow
  3. mysql: [Warning] Using a password on the command line interface can be insecure.
  4. Welcome to the MySQL monitor.  Commands end with ; or \g.
  5. Your MySQL connection id is 8
  6. Server version: 8.0.39 MySQL Community Server - GPL
  8. Copyright (c) 2000, 2024, Oracle and/or its affiliates.
  10. Oracle is a registered trademark of Oracle Corporation and/or its
  11. affiliates. Other names may be trademarks of their respective
  12. owners.
  14. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
  16. mysql> show databases;
  17. +--------------------+
  18. | Database           |
  19. +--------------------+
  20. | information_schema |
  21. | mysql              |
  22. | performance_schema |
  23. | rag_flow           |
  24. | sys                |
  25. +--------------------+
  26. 5 rows in set (0.00 sec)
  28. mysql>
复制代码
能正常显示数据库列表，就说明用户登录正常。
注意：mysql8默认是启动了密码复杂性校验的，因为官方给的密码，太简单了。所以在全局变量中修改了root密码，否则mysql启动会失败。
因为这个问题，搞了半天，一直启动失败，要崩溃了。所以后来没办法，直接改了root密码，就正常了。
 
如果mysql密码，没有修改成功，导致密码为空，需要手动修改密码。
  1. bash-5.1# mysql -h localhost -u root
  2. 直接回车，不需要输入密码
  4. mysql> SELECT user, host FROM mysql.user;
  5. +------------------+-----------+
  6. | user             | host      |
  7. +------------------+-----------+
  8. | mysql.infoschema | localhost |
  9. | mysql.session    | localhost |
  10. | mysql.sys        | localhost |
  11. | root             | localhost |
  12. +------------------+-----------+
  13. 4 rows in set (0.00 sec)
  15. mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'infini1#raGflow';
  16. Query OK, 0 rows affected (0.02 sec)
  18. mysql> flush privileges;
  20. mysql> use mysql;
  21. Reading table information for completion of table and column names
  22. You can turn off this feature to get a quicker startup with -A
  24. Database changed
  25. mysql> update user set host='%' where user='root';
  26. Query OK, 1 row affected (0.01 sec)
  27. Rows matched: 1  Changed: 1  Warnings: 0
  29. mysql> GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;
  30. Query OK, 0 rows affected (0.01 sec)
  32. mysql> FLUSH PRIVILEGES;
  33. Query OK, 0 rows affected (0.01 sec)
  35. mysql> exit
  36. Bye
复制代码
 
Valkey

Valkey 是 Redis 的开源替代方案，由 Linux 基金会推出，得到了 AWS、Google Cloud 等公司的支持。
Valkey 是根据 BSD 许可发布的，是一款高性能键 / 值数据存储，支持各种负载，包括缓存、消息队列，也可用作主数据库。Valkey 可以作为独立守护进程或在集群内运行，有复制和高可用性选项。
 
修改文件redis-StatefulSet.yaml
  1. vi databases/redis/redis-StatefulSet.yaml
复制代码
修改红色部分，增加了密钥，改了镜像地址
  1.     spec:
  2.       imagePullSecrets:
  3.         - name: harbor-key
  4. ...
  5.           image: harbor.qq.com:8083/ragflow/valkey/valkey:8
复制代码
 
发布应用
  1. kubectl apply -f databases/redis/redis-StatefulSet.yaml
  2. kubectl apply -f databases/redis/redis-Service.yaml
复制代码
 
等待1分钟，查看pod，确保是Running状态
  1. # kubectl -n ragflow get pods|grep redis
  2. redis-0   1/1     Running   0             2m53s
复制代码
 
查看redis日志
  1. # kubectl -n ragflow logs -f redis-0
  2. 1:C 28 Apr 2025 10:43:41.677 * oO0OoO0OoO0Oo Valkey is starting oO0OoO0OoO0Oo
  3. 1:C 28 Apr 2025 10:43:41.677 * Valkey version=8.0.2, bits=64, commit=00000000, modified=0, pid=1, just started
  4. 1:C 28 Apr 2025 10:43:41.677 * Configuration loaded
  5. 1:M 28 Apr 2025 10:43:41.678 * monotonic clock: POSIX clock_gettime
  6. 1:M 28 Apr 2025 10:43:41.678 * Running mode=standalone, port=6379.
  7. 1:M 28 Apr 2025 10:43:41.765 * Server initialized
  8. 1:M 28 Apr 2025 10:43:41.767 * Ready to accept connections tcp
复制代码
出现6379表示redis启动正常。
 
六、中间件相关 

Elasticsearch

Elasticsearch 是一个开源的、基于 Lucene 的分布式全文搜索引擎，提供了强大的搜索和数据分析能力。它采用倒排索引技术，能够快速高效地处理大规模数据的搜索和分析，广泛应用于日志分析、推荐系统、企业级搜索等场景。
 
修改文件elasticsearch-StatefulSet.yaml
  1. vi middleware/elasticsearch/elasticsearch-StatefulSet.yaml
复制代码
 
修改红色部分，增加了密钥，改了镜像地址
  1.     spec:
  2.       imagePullSecrets:
  3.         - name: harbor-key
  4. ...
  5.           image: harbor.qq.com:8083/ragflow/elasticsearch:8.11.3
复制代码
 
发布应用
  1. kubectl apply -f middleware/elasticsearch/elasticsearch-StatefulSet.yaml
  2. kubectl apply -f middleware/elasticsearch/elasticsearch-Service.yaml
复制代码
 
等待2分钟，查看pod，确保是Running状态
  1. # kubectl -n ragflow get pods|grep es
  2. es01-0    1/1     Running   0             112s
复制代码
 
查看es日志
  1. # kubectl -n ragflow logs -f es01-0
  2. ...
  3. {"@timestamp":"2025-04-28T02:49:28.858Z", "log.level": "INFO", "message":"publish_address {172.16.0.220:9200}, bound_addresses {[::]:9200}", "ecs.version": "1.2.0","service.name":"ES_ECS","event.dataset":"elasticsearch.server","process.thread.name":"main","log.logger":"org.elasticsearch.http.AbstractHttpServerTransport","elasticsearch.cluster.uuid":"xBJZ-YKRSTSyRMdPZiwltg","elasticsearch.node.id":"mLrauOXtQdWBGROGXIfd2Q","elasticsearch.node.name":"es01","elasticsearch.cluster.name":"docker-cluster"}
  4. ...
复制代码
出现9200表示Elasticsearch启动正常。
只要没有明显的错误就行
 
MinIO

MinIO 是一个高性能、开源的对象存储服务，兼容亚马逊 S3 云存储服务接口，常用于存储非结构化数据，如图片、视频、日志文件、备份数据等。
 
修改文件minio-StatefulSet.yaml
  1. vi middleware/minio/minio-StatefulSet.yaml
复制代码
 
修改红色部分，增加了密钥，改了镜像地址
  1.     spec:
  2.       imagePullSecrets:
  3.         - name: harbor-key
  4. ...
  5.           image: harbor.bzmaster.cn:8083/ragflow/quay.io/minio/minio:RELEASE.2023-12-20T01-00-02Z
复制代码
 
发布应用
  1. kubectl apply -f middleware/minio/minio-StatefulSet.yaml
  2. kubectl apply -f middleware/minio/minio-Service.yaml
复制代码
 
等待1分钟，查看pod，确保是Running状态
  1. # kubectl -n ragflow get pods|grep minio
  2. minio-0   1/1     Running   0             106s
复制代码
 
查看minio日志
  1. # kubectl -n ragflow logs -f minio-0
  2. Formatting 1st pool, 1 set(s), 1 drives per set.
  3. WARNING: Host local has more than 0 drives of set. A host failure will result in data becoming unavailable.
  5. You are running an older version of MinIO released 1 year before the latest release
  6. Update: Run `mc admin update`
  9. MinIO Object Storage Server
  10. Copyright: 2015-2023 MinIO, Inc.
  11. License: GNU AGPLv3 <https://www.gnu.org/licenses/agpl-3.0.html>
  12. Version: RELEASE.2023-12-20T01-00-02Z (go1.21.5 linux/amd64)
  14. Status:         1 Online, 0 Offline.
  15. S3-API: http://172.16.0.221:9000  http://127.0.0.1:9000     
  16. Console: http://172.16.0.221:9001 http://127.0.0.1:9001   
  18. Documentation: https://min.io/docs/minio/linux/index.html
  19. Warning: The standard parity is set to 0. This can lead to data loss.
复制代码
 
七、服务相关

Ragflow

Ragflow 是一款基于深度文档理解构建的开源 RAG（Retrieval-Augmented Generation）引擎。它旨在为各种规模的企业及个人提供一套精简的 RAG 工作流程，结合大语言模型（LLM）针对用户各类不同的复杂格式数据提供可靠的问答以及有理有据的引用。
 
修改文件ragflow-Deployment.yaml
  1. vi services/ragflow/ragflow-Deployment.yaml
复制代码
 
修改红色部分，增加了密钥，改了镜像地址
  1.     spec:
  2.       imagePullSecrets:
  3.         - name: harbor-key
  4. ...
  5.           image: harbor.bzmaster.cn:8083/ragflow/infiniflow/ragflow:v0.18.0-slim
复制代码
 
发布应用，注意执行顺序，先执行configMap，再执行下面的。
  1. kubectl apply -f services/ragflow/ragflow-cm1-configmap.yaml
  2. kubectl apply -f services/ragflow/ragflow-cm2-configmap.yaml
  3. kubectl apply -f services/ragflow/ragflow-cm3-configmap.yaml
  4. kubectl apply -f services/ragflow/ragflow-cm5-configmap.yaml
  5. kubectl apply -f services/ragflow/ragflow-Deployment.yaml
  6. kubectl apply -f services/ragflow/ragflow-Service.yaml
复制代码
 
等待6分钟，这个镜像特别大，请耐心等待！
查看pod，确保是Running状态
  1. # kubectl -n ragflow get pods|grep ragflow
  2. ragflow-6bddc85f97-6xpkd   1/1     Running   0             6m48s
复制代码
 
查看ragflow日志
  1. # kubectl -n ragflow logs -f ragflow-6bddc85f97-6xpkd<br>...
  2. 2025-04-28 15:06:23,972 INFO     15
  3.         ____   ___    ______ ______ __               
  4.        / __ \ /   |  / ____// ____// /____  _      __
  5.       / /_/ // /| | / / __ / /_   / // __ \| | /| / /
  6.      / _, _// ___ |/ /_/ // __/  / // /_/ /| |/ |/ /
  7.     /_/ |_|/_/  |_|\____//_/    /_/ \____/ |__/|__/                             
  9.    
  10. 2025-04-28 15:06:24,063 INFO     15 RAGFlow version: v0.18.0 slim
  11. 2025-04-28 15:06:24,068 INFO     15 project base: /ragflow
  12. 2025-04-28 15:06:24,085 INFO     15 Current configs, from /ragflow/conf/service_conf.yaml:
  13.     ragflow: {'host': '0.0.0.0', 'http_port': 9380}
  14.     mysql: {'name': 'rag_flow', 'user': 'root', 'password': '********', 'host': 'mysql', 'port': 3306, 'max_connections': 100, 'stale_timeout': 30}
  15.     minio: {'user': 'rag_flow', 'password': '********', 'host': 'minio:9000'}
  16.     es: {'hosts': 'http://es01:9200', 'username': 'elastic', 'password': '********'}
  17.     infinity: {'uri': 'infinity:23817', 'db_name': 'default_db'}
  18.     redis: {'db': 1, 'password': '********', 'host': 'redis:6379'}
  19. 2025-04-28 15:06:24,164 INFO     15 Use Elasticsearch http://es01:9200 as the doc engine.
  20. 2025-04-28 15:06:24,364 INFO     15 GET http://es01:9200/ [status:200 duration:0.195s]
  21. 2025-04-28 15:06:24,453 INFO     15 HEAD http://es01:9200/ [status:200 duration:0.076s]
  22. 2025-04-28 15:06:24,478 INFO     15 Elasticsearch http://es01:9200 is healthy.
  23. 2025-04-28 15:06:24,557 WARNING  15 Load term.freq FAIL!
  24. 2025-04-28 15:06:24,656 WARNING  15 Realtime synonym is disabled, since no redis connection.
  25. 2025-04-28 15:06:24,678 WARNING  15 Load term.freq FAIL!
  26. 2025-04-28 15:06:24,757 WARNING  15 Realtime synonym is disabled, since no redis connection.
  27. 2025-04-28 15:06:24,769 INFO     15 MAX_CONTENT_LENGTH: 134217728
  28. 2025-04-28 15:06:24,853 INFO     15 MAX_FILE_COUNT_PER_USER: 0
  29. 2025-04-28 15:07:23,080 INFO     15 init web data success:33.099204301834106
  30. 2025-04-28 15:07:23,163 INFO     15 update_progress lock_value: 054d89b4-835e-415a-b2e3-aa6bd0d64e95
  31. 2025-04-28 15:07:23,163 INFO     15 RAGFlow HTTP server start...
  32. 2025-04-28 15:07:23,265 INFO     15 WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
  33. * Running on all addresses (0.0.0.0)
  34. * Running on http://127.0.0.1:9380
  35. * Running on http://172.16.0.227:9380
  36. ...
复制代码
没有明显报错就可以了
之后日志会一直出现RedisDB.queue_info相关信息，日志会刷屏，这个不用管，应该是定时任务。
 
八、访问ragflow

如果是生产环境，最好是域名访问，则需要添加一条ingress规则，指向到ragflow的svc，端口是80，并做DNS解析，指向到ingress的公网ip。
这里直接使用ragflow的nodeport端口访问
  1. # kubectl -n ragflow get svc|grep ragflow
  2. ragflow   NodePort    192.168.34.159   <none>        9380:31078/TCP,80:31930/TCP,443:31213/TCP,5678:31082/TCP,5679:32741/TCP,9382:30421/TCP   23m
复制代码
可以看到nodeport对应的端口是31930
 
查看node节点
  1. # kubectl get node -o wide
  2. NAME       STATUS   ROLES                  AGE   VERSION        INTERNAL-IP   EXTERNAL-IP   OS-IMAGE           KERNEL-VERSION       CONTAINER-RUNTIME
  3. ubuntu-1   Ready    control-plane,master   17h   v1.32.3+k3s1   10.0.2.15     <none>        Ubuntu 22.04 LTS   5.15.0-136-generic   docker://28.0.4
复制代码
可以看到node节点ip是，10.0.2.15
 
访问页面：
http://10.0.2.15:31930
点击注册
2.png

输入邮箱地址，名称，密码
3.png

创建账号成功之后，重新登录
 
登录成功之后，切换到中文，效果如下：
4.png

 
九、测试ragflow

点击右上角头像-->模型提供商，设置通义千问
5.png

 添加成功后，设置系统默认模型
6.png

创建知识库
7.png

 上传excel文件，设置切片方法
8.png

 勾选表格转HTML
9.png

 点击解析
10.png

解析成功后，点击文件
11.png

 就可以看到数据了
12.png

 
 文件上传是保存在minio里面的，登录minio后台就可以看到了。
 
查看nodeport端口
  1. # kubectl -n ragflow get svc|grep minio
  2. minio     NodePort    192.168.90.129   <none>        9000:31911/TCP,9001:30355/TCP                                                            4h23m
复制代码
可以看到端口是31911
 
访问页面：
http://10.0.2.15:31911
 
输入登录信息
用户名：rag_flow
密码：infini_rag_flow
13.png

 
登录之后，点击最大的
14.png

这里就可以看到上传的文件了
15.png

 
ragflow k8s搭建过程，到此结束！
 
 

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

使用道具 举报
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
能杜孱
2025-6-5 10:06:38

0

粉丝关注

17

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫