Docker Compose单节点部署

RAGFlow + openGauss集中部署

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

   git clone --branch v1.0.0 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. （可选）检索加速包使用。
   1. 修改.env文件。

      修改.env第566行为：OPENGAUSS_ENABLE_PQ=true

      

   2. 以后台模式重新运行服务。

      docker-compose down
      docker-compose up

   3. 参考openGauss向量数据库部署步骤2， 下载并且解压检索加速包。
   4. 参考openGauss向量数据库部署步骤4，拷贝检索加速包至openGauss容器内安装。
   5. 参考openGauss向量数据库部署步骤5、6 进行openGauss容器内配置，重启openGauss容器。
   6. 重启ragflow-server服务

      docker restart ragflow-server

      

      步骤3~步骤5若部署openGauss时已经加载过检索加速包，可跳过执行。

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

RAGFlow + openGauss分离部署

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

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

   git clone --branch v1.0.0 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 --branch v1.0.0 https://gitee.com/kunpeng_compute/KunpengRAG.git
   cd KunpengRAG/deployment/docker-compose/ragflow

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

   COMPOSE_PROFILES=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. （可选）检索加速包使用。
   1. 修改.env文件。

      修改.env第566行为：OPENGAUSS_ENABLE_PQ=true

      

   2. 以后台模式重新运行服务。

      docker-compose down
      docker-compose up -d

   3. 参考openGauss向量数据库部署步骤2， 下载并且解压检索加速包。
   4. 参考openGauss向量数据库部署步骤4，拷贝检索加速包至openGauss容器内安装。
   5. 参考openGauss向量数据库部署步骤5、6 进行openGauss容器内配置，重启openGauss容器。
      

      步骤3~步骤5若部署openGauss时已经加载过检索加速包，可跳过执行。

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