Docker

Docker 环境下使用 Easysearch #

在使用 Docker 运行 Easysearch 之前，请确保已进行 系统调优并安装好 Docker 服务，且 Docker 服务正常运行。

最快方式：启动临时的 docker 容器，可以从前台查看到 admin 随机生成的初始密码

  • 注： Docker 环境一般用于临时验证，如需要长期使用请务必进行数据持久化
# 直接运行镜像使用随机密码（数据及配置未持久化）
docker run --name easysearch --ulimit memlock=-1:-1 -p 9200:9200 infinilabs/easysearch:1.13.1

# 使用自定义密码，可以使用环境变量配置 （需要 1.8.2 及以后的版本才支持）
echo EASYSEARCH_INITIAL_ADMIN_PASSWORD=you_complex_pass > .env
# 通过从环境变量文件设置初始密码（数据及配置未持久化）
docker run --name easysearch --env-file ./.env --ulimit memlock=-1:-1 -p 9200:9200 infinilabs/easysearch:1.13.1

# 使用自定义密码及命名卷 (数据持久化到命名卷)
docker run -d --name easysearch \
  --ulimit memlock=-1:-1 \
  --env-file ./.env -p 9200:9200 \
  -v ezs-data:/app/easysearch/data \
  -v ezs-config:/app/easysearch/config \
  -v ezs-logs:/app/easysearch/logs \
  infinilabs/easysearch:1.13.1

数据持久化到本地（数据可长期使用） #

设置自定义密码，并从宿主机挂载数据目录、配置目录及日志目录，配置 jvm 内存为 512m。

  1. 在宿主机上创建目录
# 创建数据及日志存储目录
sudo mkdir -p /data/easysearch/{data,logs}
# 进入操作目录
cd /data/easysearch
# 根据自己的需求，设置成安全的密码
sudo echo EASYSEARCH_INITIAL_ADMIN_PASSWORD=you_complex_pass > .env
  1. 修改目录权限
# 注意：需要根据 Docker 运行环境判断是否需要调整权限，如在 MacOS 上使用 OrbStack 则不需要调整权限。
# 容器内 ezs 用户的 uid 为 602，通过调整宿主机的目录权限，确保在容器内部 ezs 用户有权限读写挂载的数据卷
sudo chown -R 602:602 /data/easysearch
  1. 从镜像初始化 config 目录
# 将镜像中的 config 目录复制到本地目录
docker run --rm --env-file ./.env -v /data/easysearch:/work infinilabs/easysearch:1.13.1 cp -rf /app/easysearch/config /work
  1. 后台运行容器
#后台启动容器，并指定内存大小及挂载数据、日志目录，设定好容器名称及容器主机名称
#如需调整配置文件，可以修改以下配置文件
# 1. /data/easysearch/config/easysearcy.yml
# 2. /data/easysearch/config/jvm.options
# 3. /data/easysearch/config/log4j2.properties
docker run -d --restart always -p 9200:9200 \
              --ulimit memlock=-1:-1 \
              -e ES_JAVA_OPTS="-Xms512m -Xmx512m" \
              -v /data/easysearch/data:/app/easysearch/data \
              -v /data/easysearch/config:/app/easysearch/config \
              -v /data/easysearch/logs:/app/easysearch/logs \
              --name easysearch --hostname easysearch \
              infinilabs/easysearch:1.13.1
  1. 升级 Easysearch 版本
# 先停止并删除正在运行的容器
docker stop easysearch && docker rm easyserach
# 再修改第 3 步中镜像的版本，重新运行命令即可

后续验证工作，请继续查看 安装指南

©INFINI.LTD, All Rights Reserved.