Skip to content

快速开始

xuxijie edited this page Mar 22, 2023 · 14 revisions

下文镜像托管在Docker Hub上,如果访问不稳定,可以尝试阿里云镜像

  • 运行镜像:registry.cn-hangzhou.aliyuncs.com/havenask/ha3_runtime:0.3.0
  • 开发镜像:registry.cn-hangzhou.aliyuncs.com/havenask/ha3_dev:0.3.0

启动服务

单机模式

Havenask引擎提供了可以直接运行的镜像,无需重新编译即可快速构建搜索服务。

通过镜像启动引擎的步骤如下:

  • 创建容器 其中CONTAINER_NAME为指定的容器名
git clone [email protected]:alibaba/havenask.git
cd havenask/docker
docker pull havenask/ha3_runtime:0.3.0
./create_container.sh <CONTAINER_NAME> havenask/ha3_runtime:0.3.0
  • 登陆容器
./<CONTAINER_NAME>/sshme
  • 运行测试
    启动运行时容器后,构建测试数据索引以及查询引擎的方法见example

集群模式

集群模式需要通过Havenask的分布式运维工具部署,详细信息请参考Havenask分布式运维工具

编译代码

编译环境

  • 请确保编译的机器内存在15G以上,mac编译时需调整Docker容器资源上限(包括CPU、Memory、Swap等),具体路径:Docker Desktop->setting->Resources。
  • 请确保cpu位8core以上,不然编译比较慢。

获取开发镜像

docker pull havenask/ha3_dev:0.3.0

下载代码

cd ~
git clone [email protected]:alibaba/havenask.git

启动容器

cd ~/havenask/docker
./create_container.sh <DOCKER_NAME> havenask/ha3_dev:0.3.0

以ssh的方式登陆容器

cd ~/havenask/docker/<DOCKER_NAME>
## ssh进入容器
./sshme

执行编译指令

执行以下指令。如果报"fatal error: Killed signal terminated program cc1plus"错误,是由于编译机器内存不足导致的,请build时减少线程数(如:./build 5)

./configure
./build

单独编译子项目

以indexlib为例

cd ~/havenask/aios/indexlib
## -j为编译线程数
scons install -j30
## 执行ut,进入指定的目录
scons . -u -j20
Clone this wiki locally