平台部署

Dify + openGauss集中部署

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

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

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

   docker-compose up -d

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

3. 上述命令运行完毕后，检查是否所有的容器已经部署启动。

   docker ps -a

   按照默认配置部署成功后，下列十个容器应处于正常运行状态。

   

4. （可选）检索加速包使用。
   1. 修改.env文件。

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

      

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

      docker-compose down
      docker-compose up -d

   3. 参考openGauss向量数据库部署步骤2， 下载并且解压检索加速包。
   4. 参考openGauss向量数据库部署步骤4，拷贝检索加速包至openGauss容器内安装，其中CONTAINER_ID为步骤4中显示的docker-opengauss-1的容器ID。
   5. 参考openGauss向量数据库部署步骤5、6 进行openGauss容器内配置，并重启openGauss容器。

      docker restart opengauss

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

Dify + openGauss分离部署

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

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

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

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

   OPENGAUSS_PORT=8888
   OPENGAUSS_USER=gaussdb
   OPENGAUSS_PASSWORD=Dify@123
   OPENGAUSS_DATABASE=postgres

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

   docker-compose up -d opengauss

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

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

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

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

   COMPOSE_PROFILE=none

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

   OPENGAUSS_HOST=${openGauss_host_ip}
   OPENGAUSS_PORT=8888
   OPENGAUSS_USER=gaussdb
   OPENGAUSS_PASSWORD=Dify@123
   OPENGAUSS_DATABASE=postgres

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

   docker-compose up -d

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

5. 上述命令运行完毕后，检查是否所有的容器已经部署启动。

   docker ps -a

   按照默认配置部署成功后，下列九个容器应处于正常运行状态。

   

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} 访问Dify服务。Dify服务启动成功后，访问URL可返回Dify可视化操作界面。