docker安装es及在laravel中的应用

docker安装elasticsearch

关于es的详细介绍以及安装包编译安装的方式,可以看之前的文章:安装Elasticsearch搜索引擎

这次换个花样,使用docker(这里不解释docker是什么了,不了解的自行百度)来安装,直接开搞,操作如下

  1. 安装docker

    # 安装
    yum install -y docker
    # 查看版本信息
    docker version
    # 修改docker的镜像源
    vim /etc/docker/daemon.json
    
    {
        "registry-mirrors": ["https://ftnejmh3.mirror.aliyuncs.com"]
    }
    
     # 启动docker
    systemctl start docker
    # 停止docker
    systemctl stop docker
    # 查看docker状态
    systemctl status docker
    # 重新启动docker
    systemctl restart docker
    

    如果docker没有命令自动补全功能,可以安装如下

    yum -y install bash-completion
    source /usr/share/bash-completion/bash_completion
    
  2. 拉取es镜像(文件有点大,需要一定时间)

    docker pull elasticsearch:7.12.1
    
  3. 在宿主机创建和容器内共享的目录

    # 存放配置文件目录
    mkdir -p /docker/es/conf
    # 存放数据目录
    mkdir -p /docker/es/data
    # 存放日志目录
    mkdir -p /docker/es/logs
    # 存放插件目录
    mkdir -p /docker/es/plugins
    # 创建好目录后为了防止下边创建容器报错,给宿主机的这个es目录赋个读写权限
    chmod -R 777 /docker/es/
    
  4. 创建es配置文件(参数意思不解释,上方提到的文章内有解释)

    vi /docker/es/conf/elasticsearch.yml

    cluster.name: my-application 
    node.name: node-1 
    path.data: /usr/share/elasticsearch/data 
    path.logs: /usr/share/elasticsearch/logs
    network.host: 0.0.0.0
    http.port: 9200
    cluster.initial_master_nodes: ["node-1"]
    
  5. 构建容器(构建很快,但是容器内es的启动速度很慢,构建完先耐心等待一下)

    docker run -p 9200:9200 -d --name es -e ES_JAVA_OPTS="-Xms256m -Xmx256m" -v /docker/es/conf/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml -v /docker/es/data:/usr/share/elasticsearch/data -v /docker/es/plugins:/usr/share/elasticsearch/plugins -v /docker/es/logs:/usr/share/elasticsearch/logs --privileged=true elasticsearch:7.12.1
    
  6. 异常处理

    好事多磨,一般这里都会出点小问题,启动失败使用 docker logs es | grep error 命令来查看报错信息。我遇到的有异常:max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]

    解决方案:

    1. 修改配置sysctl.conf:
    vi /etc/sysctl.conf
    2. 在尾行添加以下内容:
    vm.max_map_count=655300
    3. 刷新配置:
    sysctl -p
    
  7. 测试,在浏览器中访问服务地址+9200的端口,可以显示以下信息证明安装成功

    PS:如果打不开,请检查es是否正确启动以及9200端口是否开放

    {
      "name" : "node-1",
      "cluster_name" : "my-application",
      "cluster_uuid" : "b-ovHR-GRvunpTmWOfoLKw",
      "version" : {
        "number" : "7.12.1",
        "build_flavor" : "default",
        "build_type" : "docker",
        "build_hash" : "3186837139b9c6b6d23c3200870651f10d3343b7",
        "build_date" : "2021-04-20T20:56:39.040728659Z",
        "build_snapshot" : false,
        "lucene_version" : "8.8.0",
        "minimum_wire_compatibility_version" : "6.8.0",
        "minimum_index_compatibility_version" : "6.0.0-beta1"
      },
      "tagline" : "You Know, for Search"
    }
    

安装es的可视化面板 kibana

  1. 拉取镜像

    docker pull kibana:7.12.1
    
  2. 在宿主机创建和容器内共享的目录

    mkdir -p /docker/kibana/conf
    
  3. 创建配置文件
    vi /docker/kibana/conf/kibana.yml

    server.name: kibana
    server.host: "0.0.0.0"
    elasticsearch.hosts: ["http://你的es地址:9200"]   
    xpack.monitoring.ui.container.elasticsearch.enabled: true
    
  4. 构建容器

    docker run -p 5601:5601 -d --name kibana -v /docker/kibana/conf/kibana.yml:/usr/share/kibana/config/kibana.yml --privileged=true kibana:7.12.1
    
  5. 访问测试:http://服务ip:5601

安装es的ik分词器

  1. 下载安装包

    wget https://github.com/medcl/elasticsearch-analysis-ik/releases/tag/v7.12.1
    
  2. 解压安装包

    PS:这个安装包解压完文件是分散的,所以需要在 plugins 目录下先建好放置文件的目录

    mkdir /docker/es/plugins/ik
    mv elasticsearch-analysis-ik-7.12.1.zip /docker/es/plugins/ik/
    cd /docker/es/plugins/ik
    unzip elasticsearch-analysis-ik-7.12.1.zip
    rm -rf elasticsearch-analysis-ik-7.12.1.zip
    
  3. 重启es容器

    docker restart es
    
  4. 注意事项

    安装es的ik分词器可能会导致es内存溢出,可以在es配置中增加内存限制

    indices.fielddata.cache.size: 50%
    

es在laravel中的应用

  1. 安装composer组件包

    composer require elasticsearch/elasticsearch "7.12.x" --ignore-platform-reqs
    
  2. 配置

    # 在 .env 文件中加入es的地址配置,如果是集群存在多个地址则用 ,隔开
    ES_HOSTS=172.17.0.8,172.17.0.9,172.17.0.10
    # 在 config/database.php 配置文件中加入
    # 端口不用加,默认就是9200,但是如果改了端口那这里就要加入端口的配置
    'elasticsearch' => [
     'hosts' => explode(',', env('ES_HOSTS')),
    ]
    
  3. 初始化 Elasticsearch 对象,并注入到 laravel 容器中

    在 App/Providers/AppServiceProvider.php 文件的register方法中定义服务对象

    <?php
    
    namespace App\Providers;
    
    use Illuminate\Support\ServiceProvider;
    use Elasticsearch\ClientBuilder as ESClientBuilder;
    
    class AppServiceProvider extends ServiceProvider
    {
        /**
         * Register any application services.
         *
         * @return void
         */
        public function register()
        {
            // 注册一个名为 es 的单例
            $this->app->singleton('es', function () {
                // 从配置文件读取 Elasticsearch 服务器列表
                $builder =  ESClientBuilder::create()->setHosts(config('database.elasticsearch.hosts'));
                // 如果是开发环境
                if (app()->environment() === 'local'){
                    // 配置日志,Elasticsearch 的请求和返回数据将打印到日志文件中,便于调试
                    $builder->setLogger(app('log')->driver());
                }
                
                return $builder->build();
            });
        }
    
        /**
         * Bootstrap any application services.
         *
         * @return void
         */
        public function boot()
        {
            //
        }
    }
    

    然后就可以在项目中使用 app('es') 的方式来调用es了

  4. 测试是否配置成功

    [root@localhost blog]# php artisan tinker
    Psy Shell v0.10.8 (PHP 7.4.20 — cli) by Justin Hileman
    >>> app('es')->info()
    => [
         "name" => "node-1",
         "cluster_name" => "my-application",
         "cluster_uuid" => "b-ovHR-GRvunpTmWOfoLKw",
         "version" => [
           "number" => "7.12.1",
           "build_flavor" => "default",
           "build_type" => "docker",
           "build_hash" => "3186837139b9c6b6d23c3200870651f10d3343b7",
           "build_date" => "2021-04-20T20:56:39.040728659Z",
           "build_snapshot" => false,
           "lucene_version" => "8.8.0",
           "minimum_wire_compatibility_version" => "6.8.0",
           "minimum_index_compatibility_version" => "6.0.0-beta1",
         ],
         "tagline" => "You Know, for Search",
       ]
    >>>
    

    使用 app('es')->info() 可以打印出es相关信息,则安装配置成功

  5. 在laravel中简单封装一个类来使用es

    这里只以搜索为例,增删改都很简单,就不演示了

    创建一个 service 类,来处理es搜索的结构体

    <?php
    /**
     * Created by PhpStorm
     * User: Ricky Wong
     * Date: 2021/8/1
     * Time: 19:58
     */
    
    namespace App\Services;
    
    
    class ElasticSearchService
    {
        /**
         * 定义基础结构体
         * @var array
         */
        protected $params = [
            'index' => 'products',
            'type' => '_doc',
            'body' => [
                'query' => [
                    'bool' => [
                        'filter' => [],
                        'must'  => []
                    ]
                ]
            ]
        ];
    
        /**
         * 分页
         * @param int $size 每页显示多少条
         * @param int $page 页码
         * @return $this
         */
        public function paginate($size = 20, $page = 1)
        {
            $this->params['body']['from'] = ($page - 1) * $size;
            $this->params['body']['size'] = $size;
    
            return $this;
        }
    
        /**
         * 数据状态值精确查询
         * @param int $status 状态标识
         * @return $this
         */
        public function status($status = 1)
        {
            $this->params['body']['query']['bool']['filter'] = [
                'term' => ['status' => $status]
            ];
    
            return $this;
        }
    
        /**
         * 排序
         * 如需多字段排序多次调用此方法即可
         * @param string $field 排序字段
         * @param string $direction 排序方式 asc|desc
         * @return $this
         */
        public function order($field, $direction)
        {
            if (!isset($this->params['body']['sort'])) {
                $this->params['body']['sort'] = [];
            }
            $this->params['body']['sort'][] = [$field => $direction];
    
            return $this;
        }
    
        /**
         * 关键词,按多字段权重搜索
         * @param array $keywords 搜索词数组
         * @return $this
         */
        public function keywords($keywords)
        {
            $keywords = is_array($keywords) ? $keywords : [$keywords];
            foreach ($keywords as $keyword) {
                $this->params['body']['query']['bool']['must'][] = [
                    'multi_match' => [
                        'query' => $keyword,
                        'fields' => [
                            'long_name^3',
                            'name^2'
                        ],
                        // most_fields 多字段匹配度更高   best_fields  完全匹配占比更高
                        'type' => 'most_fields'
                    ]
                ];
            }
    
            return $this;
        }
    
        /**
         * 指定需要返回的字段
         * @param array $fields 字段数组
         * @return $this
         */
        public function select($fields = [])
        {
            $this->params['body']['_source'] = $fields;
    
            return $this;
        }
    
        /**
         * 搜索词高亮设置
         * @param array $fields 高亮搜索词数组
         * @return $this
         */
        public function highlight($fields)
        {
            $array = [];
            foreach ($fields as $field) {
                $array[$field] = (object)[];
            }
    
            $this->params['body']['highlight'] = [
                // 自定义高亮样式
                'pre_tags' => "<p style='color: red;'>",
                'post_tags' => "</p>",
                'fields' => $array
            ];
    
            return $this;
        }
    
        /**
         * 返回结构体
         * @return array
         */
        public function getParams()
        {
            return $this->params;
        }
    }
    

    创建控制器,在其中定义方法来调用service,这里只展示这个方法

        /**
         * 搜索
         * @param Request $request
         * @param ElasticSearchService $service
         * @return \Illuminate\Http\JsonResponse
         */
        public function search(Request $request, ElasticSearchService $service)
        {
            $page = $request->input('page', 1);
            $size = $request->input('perPage', 20);
            $keyword =  $request->input('keyword', '');
            $order = $request->input('order', '');
            try {
                $builder = $service->status()->paginate($size, $page);
                if (!empty($keyword)) {
                    // 将多个以空格隔开的关键词转为数组
                    $keywords = array_filter(explode(' ', $keyword));
                    $builder->keywords($keywords);
                }
                if (!empty($order)) {
                    if (preg_match('/^(.+)_(asc|desc)$/', $order,$match)) {
                        $builder->order($match[1], $match[2]);
                    }
                }
                $params = $builder->select(['name', 'long_name'])->highlight(['name', 'long_name'])->getParams();
    
                return response()->json(['result' => true, 'data' => app('es')->search($params)]);
            } catch (\Exception $e) {
                Log::error($e->getMessage());
                return response()->json(['result' => false, 'data' => []]);
            }
        }
    
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,189评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,577评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,857评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,703评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,705评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,620评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,995评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,656评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,898评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,395评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,982评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2 342

推荐阅读更多精彩内容