快速开始

由于docker对于Mac M1芯片的支持问题。建议使用Linux或者搭载非M1芯片的Mac机器运行

启动容器

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

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

获取镜像

docker pull havenask/ha3_runtime:0.1

通过代码中的docker脚本创建容器，DOCKER_NAME为指定的容器名

cd ~
git clone [email protected]:alibaba/havenask.git
cd ~/havenask/docker
## 如果是Linux环境执行以下指令
./create_container.sh <DOCKER_NAME> havenask/ha3_runtime:0.1
## 如果是Mac环境执行以下指令
./create_container_mac.sh <DOCKER_NAME> havenask/ha3_runtime:0.1

以ssh的方式登陆容器

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

运行测试

启动运行时容器后，构建测试数据索引以及查询引擎的方法见example

编译代码

编译环境

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

获取开发镜像

docker pull havenask/ha3_dev:0.1

下载代码

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

启动容器

cd ~/havenask/docker
## 如果是Linux环境执行以下指令
./create_container.sh <DOCKER_NAME> havenask/ha3_dev:0.1
## 如果是Mac环境执行以下指令
./create_container_mac.sh <DOCKER_NAME> havenask/ha3_dev:0.1

以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