theme: orange
本文正在参加「金石计划」
这篇文章是为了使用Redis Search 的向量搜索功能提前做的环境准备工作。即讨论如何在准备生产的 linux 环境中安装 RediSearch 和 RedisJSON 模块。
什么是RediSearch?
根据RediSearch的官方文档 RediSearch是这样描述的。
RediSearch为Redis提供二级索引、全文搜索和查询语言。这些功能可以实现多字段查询、聚合、精确短语匹配和文本查询的数字过滤。
对于开发者来说,这意味着你现在可以在Redis上运行类似于SQL的文本搜索查询,以及支持更多的场景。
安装
RediSearch 是作为一个模块安装在 Redis 部署中的。为了使用 RediSearch 的一些高级功能,你需要同时安装 RedisJSON,有三种方式可以安装和使用这些功能。
使用 Redis Cloud - 其提供一个完全免费的管理数据库,最大容量为 30MB。已经包括推荐的模块,如
RediSearch
、RedisJSON
、RedisGraph
、RedisTimeSeries
和RedisBloom
。很适合去体验,熟悉一下RediSearch的功能。使用Docker运行 - 如果你会使用Docker,并且应用程序将会部署Docker,那可以采取这个方式。
从源代码构建 RediSearch - 生产应用的首选方式。
从源代码构建 RediSearch 和 RedisJSON 模块
bash git clone --recursive https://github.com/RediSearch/RediSearch.git cd RediSearch sudo make setup make build
运行以上4条命令后,你应该在~/RediSearch/bin/linux-x64-release/search
的位置有一个名为redisearch.so
的文件。
然后将文件redisearch.so
移至/etc/redis
(这样做是为了防止redis服务器重启时出现权限拒绝的错误)。
如果你实在不想自己构建,可以去官网下载预编译的版本。
同样的方式,去编译 RedisJSON
模块。 bash git clone https://github.com/RedisJSON/RedisJSON.git cd RedisJSON sudo apt install build-essential llvm cmake libclang1 libclang-dev cargo make
运行以上4条命令后,你应该在~/RedisJSON/bin/linux-x64-release
的位置有一个名为rejson.so
的文件。
将文件rejson.so
移至/etc/redis
(这样做是为了防止redis服务器重启时出现权限拒绝的错误) 。
安装 RediSearch 和 RedisJSON 模块
当你准备好redisearch.so和rejson.so文件,接下来你需要将它们加载到redis中,在此之前,务必去报已经以独立或者集群的模式安装好redis。
有两种方法可以让你在redis部署中加载模块,即
- 在发出redis-server命令时使用CLI选项
--loadmodule
(不建议用于生产)。 - 使用
redis.conf
文件 - 在/etc/redis/redis.conf
中添加以下一行(建议用于生产)。
bash loadmodule /etc/redis/redisearch.so loadmodule /etc/redis/rejson.so
然后用sudo service redis-server
重启服务。
检查模块是否成功安装
运行 redis-cli
并输入命令module list
。这将返回有关加载到服务器的模块的信息。下面是我机器上的一个截图,可以看到两个模块都被成功加载。
Docker 部署
看到上面的操作,是不是觉得还真的是有点麻烦,那如果你的机器上已经部署有docker
,不妨试试下面的命令。
``bash docker pull redis/redis-stack-server docker run -v
pwd`/local-redis-stack.conf:/redis-stack.conf -p 6379:6379 redis/redis-stack-server:latest
```
下图为成功运行的容器。
如果有额外的参数,比如设置redis 访问密码,请在命令行添加 -e REDIS_ARGS="--requirepass redis-stack"
如果要在生产环境用,请使用docker-compose进行部署,并挂载redis.conf
覆盖容器的redis配置文件。