⁹

聚合搜索后端运行&部署文档

leikooo

2025-03-03 08:34

阅读405

leikooo

2025-03-03 08:34

阅读 405

环境准备

聚合搜索平台源码
IDEA 你懂的教程
Redis 网盘安装包提取码: vmty
MySQL5.7 网盘安装包提取码:bbr5
MySQL8.0 网盘安装包提取码:g17s
MySQL 安装指南
MySQL 官方下载链接
ES 链接: 百度网盘提取码: f32k
Kibana 百度网盘提取码: i1ku

本地启动

设置 Maven 完成 https://www.codefather.cn/post/1836689783992958977

使用 IDEA 打开项目

初始化数据

连接本地 MySQL

点击 Download 下载 driver files

输入，账号密码之后点击Test Connection 成功之后直接点击 OK

找到根目录 sql 目录下面的 create_table.sql

Ctrl + A 全选代码右键选择 Execute

安装依赖

首先需要配置好本地 Mavne，和阿里云镜像，要是没有配置的话可以看一下这篇文章

然后可以在 Build 看到正在下载依赖

选择 Java 版本

没有的话可以使用下面的 Download JDK

本地没有 JDK 可以直接 Download JDK
本地有 JDK 但是没识别到 Add JDK from disk 选着对应目录即可
选择 Java >= 8 建议 8

安装 Elasticsearch

在 环境准备里面有下载链接，下载之后解压到常用软件的路径

1、进入 elasticsearch/bin 在对应的目录输入 cmd

2、直接输入命令就可以执行成功，但是要注意在使用的时候一定不要把这个窗口给关闭

▼
text
复制代码
elasticsearch.bat

3、如何简化启动步骤呢？

elasticsearch 也给了我们更简单的启动方式，在 Windows 的 Services 启动

把 elasticsearch 安装到 Services 也给了对应的 bat 一键执行成功

1）在根目录的 bin 文件夹输入 cmd

▼
text
复制代码
elasticsearch-service.bat

2）找到 Windows 的 Service

Win + R 输入 Services.msc

找到 elasticsearch 直接点击左侧的 启动

关闭就找到左侧的 关闭即可，一键操作

安装 analysis-ik

1）在 elasticsearch/bin 目录下面输入 cmd

这个 {version} 版本看你下载的版本

▼
text
复制代码
elasticsearch-plugin install https://get.infini.cloud/elasticsearch/analysis-ik/{version}

比如：

▼
text
复制代码
elasticsearch-plugin install https://get.infini.cloud/elasticsearch/analysis-ik/7.17.9

2）查看是否安装成：

▼
text
复制代码
elasticsearch-plugin list

3）需要重启 elasticsearch

win + R 输入 services.msc 找到 elasticsearch 直接找到左侧的 Restart （重启）

4、验证是否启动成功

访问：http://localhost:9200

安装 kibana

这个是 elasticsearch 的可视化工具所以要确保 elasticsearch 是运行状态

1）进入到 kibana-7.17.9/bin 目录在上方地址栏输入cmd

2）输入

▼
text
复制代码
kibana.bat

可能稍微有点慢

4）启动地址 http://localhost:5601

5）dev Tools

使用 ES

1、需要本地启动 Elasticsearch 、Kibana

2、初始化所需文件 sql/post_es_mapping.json

3、启动 kibana 在 http://localhost:5601 的 DevTools

▼
json
复制代码
PUT post_v1

{
  "aliases": {
    "post": {}
  },
  "mappings": {
    "properties": {
      "title": {
        "type": "text",
        "analyzer": "ik_max_word",
        "search_analyzer": "ik_smart",
        "fields": {
          "keyword": {
            "type": "keyword",
            "ignore_above": 256
          }
        }
      },
      "content": {
        "type": "text",
        "analyzer": "ik_max_word",
        "search_analyzer": "ik_smart",
        "fields": {
          "keyword": {
            "type": "keyword",
            "ignore_above": 256
          }
        }
      },
      "tags": {
        "type": "keyword"
      },
      "userId": {
        "type": "keyword"
      },
      "createTime": {
        "type": "date"
      },
      "updateTime": {
        "type": "date"
      },
      "isDelete": {
        "type": "keyword"
      }
    }
  }
}

4、注释相关代码注释

开启同步任务，将数据库的帖子同步到 Elasticsearch

找到 com.yupi.yuso.job.once.FullSyncPostToEs 注释掉

▼
java
复制代码
// todo 取消注释开启任务
@Component
@Slf4j
public class FullSyncPostToEs implements CommandLineRunner

找到 com.yupi.yuso.job.once.FetchInitPostList

▼
java
复制代码
//@Component
@Slf4j
public class FetchInitPostList implements CommandLineRunner

找到 com.yupi.yuso.job.cycle.IncSyncPostToEs

▼
java
复制代码
// todo 取消注释开启任务
@Component
@Slf4j
public class IncSyncPostToEs

5、修改配置

等部署到服务器上，urls 修改成 http://IP:9200

如果设置账号名和密码，就把对应的信息写到 username 和 password 即可

▼
yml
复制代码
spring:
  # Elasticsearch 配置
  # todo 需替换配置，然后取消注释
  elasticsearch:
    uris: http://localhost:9200
#    username: root
#    password: 123456

BUG

Failed to parse mapping [_doc]: analyzer [ik_smart] has not been configured in mappings

解决：通过安装 analysis-ik 即可

修改配置文件

配置文件在下面项目的 resources 目录

application.yml 默认是本地运行时生效的配置
application-prod.yml 当在服务器指定 --spring.profiles.active=prod 才会生效，一般写线上配置，比如：线上 MySQL、Redis ...
application-test.yml 当在服务器指定 --spring.profiles.active=test 才会生效

1、MySQL

▼
yml
复制代码
spring:
  datasource: 
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/my_db  # yuapi 是数据库的名称 如果是远程 MySQL 例如： jdbc:mysql://192.129.11.11:3306/yuapi
    username: root # 用户名
    password: 123456 # MySQL 设置的密码

2、Redis ，如果使用 Redis 修改 @SpringBootApplication(exclude = {RedisAutoConfiguration.class}) 把 exclude 里面的内容去掉就可以正常使用 Redis

▼
yml
复制代码
spring:
  redis:
    database: 1  
    host: localhost  # 如果线上改成线上 IP
    port: 6379       # Redis 具体运行端口，默认安装 6379
    timeout: 5000    
  #    password: 123456  # 密码，默认安装没有密码，如果服务器 Redis 有密码就修改

3、COS 相关的配置

▼
yml
复制代码
# 对象存储
cos:
  client:
    accessKey: xxx
    secretKey: xxx
    region: xxx
    bucket: xxx

这个 accessKey 就是 SecretId !

官方文档：https://cloud.tencent.com/document/product/436/56390

2）APPID、SecretKey 、SecretId 都是 https://console.cloud.tencent.com/capi 获取的，注意 SecretKey 只能在创建的时候可见，注意保存！

3）host、bucket、region 都在 COS 对象存储那里获取

首先需要创建存储桶，位置 https://console.cloud.tencent.com/cos/bucket

4）获取 host、bucket、region 信息

位置 https://console.cloud.tencent.com/cos/bucket

本地运行

制作 + 上传 JAR 包

Lifecycle -> package 双击

之后我们就可以在 target 目录下面找到打包好的 jar 包

如果报错的话:

删除 target 目录(IDEA 右键删除即可)，重新打包尝试
Maven -> Lifecyle -> clean
退出 IDEA 在文件管理器找到该项目的 .idea 文件右键删除，然后重新打开 IDEA 重新走一遍流程

部署

后面可以参考这篇文章『后端部署（通用）』

相关专栏

教程

项目教程

问答助学