平台部署

RAGFlow + openGauss集中部署

1. 拉取KunpengRAG仓库并进入到RAGFlow的docker-compose部署目录。

   git clone https://gitee.com/kunpeng_compute/KunpengRAG.git
   cd KunpengRAG/deployment/docker-compose/ragflow

2. 运行docker-compose命令一键安装并部署RAGFlow服务（包含openGauss服务）。

   docker-compose up -d

   该命令会在线从鲲鹏镜像仓库拉取服务对应的容器镜像文件，镜像文件较大，初次启动时间较长。

3. 检查服务启动状态：

   docker logs -f ragflow-server

   当输出下面的图示时，代表RAGFlow服务启动完成，可以正常访问。

   

   

   如果跳过RAGFlow服务状态检查，直接访问RAGFlow可能会显示“网络错误”的报错，这是由于RAGFlow还没有完全启动成功导致的。

4. 通过浏览器输入URL地址http://${host_ip} 访问RAGFlow服务。RAGFlow服务启动成功后，访问URL可返回RAGFlow可视化操作界面。

RAGFlow + openGauss分离部署

RAGFlow和openGauss分离部署的场景下，openGauss将单独部署在一个节点上，RAGFlow部署在另一台节点上并与openGauss连接。openGauss的部署过程如下。

1. 拉取KunpengRAG仓库并进入到RAGFlow的docker-compose部署目录。

   git clone https://gitee.com/kunpeng_compute/KunpengRAG.git
   cd KunpengRAG/deployment/docker-compose/ragflow

2. 修改.env文件配置openGauss环境变量，设置openGauss端口、用户名、密码以及数据库名称等信息（不配置则按如下默认值设置）。

   OPENGAUSS_PORT=5432
   OPENGAUSS_USER=opengauss_user
   OPENGAUSS_PASSWORD=Ragflow@123
   OPENGAUSS_DATABASE=ragflow

3. 通过docker-compose指定单独安装并部署openGauss服务。

   docker-compose up -d opengauss

openGauss部署成功后，需要到另外一台节点部署RAGFlow服务。

1. 拉取KunpengRAG仓库并进入到RAGFlow的docker-compose部署目录。

   git clone https://gitee.com/kunpeng_compute/KunpengRAG.git
   cd KunpengRAG/deployment/docker-compose/ragflow

2. 修改.env文件，设置环境变量COMPOSE_PROFILE如下，禁止docker-compose自动启动openGauss服务。

   COMPOSE_PROFILE=none

3. 修改.env中的openGauss环境变量，配置为单独部署的openGauss连接信息，默认值如下。

   OPENGAUSS_HOST=${openGauss_host_ip}
   OPENGAUSS_PORT=5432
   OPENGAUSS_USER=opengauss_user
   OPENGAUSS_PASSWORD=Ragflow@123
   OPENGAUSS_DATABASE=ragflow

4. 运行docker-compose命令一键安装并部署RAGFlow服务（不包含openGauss服务）。

   docker-compose up -d

   该命令会在线从鲲鹏镜像仓库拉取服务对应的容器镜像文件，镜像文件较大，初次启动时间较长。

5. 检查服务启动状态：

   docker logs -f ragflow-server

   当输出下面的图示时，代表ragflow服务启动完成，可以正常访问。

   

   

   如果跳过RAGFlow服务状态检查，直接访问RAGFlow可能会显示“网络错误”的报错，这是由于RAGFlow还没有完全启动成功导致的。

6. 通过浏览器输入URL地址http://${host_ip} 访问RAGFlow服务。RAGFlow服务启动成功后，访问URL可返回RAGFlow可视化操作界面。