hausgold/opensearch

hausgold/opensearch Docker镜像文档

!https://raw.githubusercontent.com/hausgold/docker-opensearch/master/docs/assets/project.svg

https://github.com/hausgold/docker-opensearch/actions/workflows/package.yml/badge.svg?branch=master](https://github.com/hausgold/docker-opensearch/actions/workflows/package.yml)

镜像概述

本Docker镜像以https://hub.docker.com/r/opensearchproject/opensearch%E4%B8%BA%E5%9F%BA%E7%A1%80%EF%BC%8C%E9%9B%86%E6%88%90%E4%BA%86mDNS/ZeroConf%E6%A0%88%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E7%9B%B4%E6%8E%A5%E9%80%9A%E8%BF%87%60opensearch.local%60%E8%AE%BF%E9%97%AEOpenSearch%E6%9C%8D%E5%8A%A1%EF%BC%88%E7%AB%AF%E5%8F%A39200%E3%80%819600%E5%8F%8A80%E4%BB%A3%E7%90%86%EF%BC%89%E3%80%82

核心功能

• 基于官方OpenSearch镜像构建，保持原生功能
• 集成mDNS/ZeroConf，支持自动发现
• 默认主机名opensearch.local，无需手动配置网络
• 端口80通过haproxy代理9200，简化访问
• 支持自定义mDNS主机名及别名
• 兼容Elasticsearch版本响应格式

前提条件

• 主机已启用Avahi守护进程
• 主机已启用mDNS NSS查找

快速开始

运行以下命令即可启动OpenSearch服务：

bash
$ docker run --rm hausgold/opensearch

端口9200通过haproxy代理至80，使opensearch.local可直接访问。端口9200和9600保持原生配置。

如需使用自定义插件，请参考插件使用文档。

若需启用Elasticsearch版本兼容性，添加以下环境变量：

compatibility.override_main_response_version='true'

docker-compose使用示例

yaml
services:
  opensearch:
    image: hausgold/opensearch
    environment:
      # 注意.local后缀
      MDNS_HOSTNAME: opensearch.test.local
      OPENSEARCH_JAVA_OPTS: -Xms128m -Xmx128m
      discovery.type: single-node
      compatibility.override_main_response_version: 'false'
    ulimits:
      # 由于systemd/pam的RLIMIT_NOFILE设置（容器内为最大值），Java进程可能会分配过大的限制，
      # 导致"无法分配文件描述符表 - 内存不足"错误。降低此值可暂时解决该问题。
      #
      # 参考: http://bit.ly/2U62A80
      # 参考: http://bit.ly/2T2Izit
      nofile:
        soft: 100000
        hard: 100000

主机配置

安装nss-mdns包，启用并启动avahi-daemon.service。然后编辑/etc/nsswitch.conf文件，修改hosts行如下：

bash
hosts: ... mdns4_minimal [NOTFOUND=return] resolve [!UNAVAIL=return] dns ...

配置自定义mDNS主机名

通过环境变量MDNS_HOSTNAME可自定义主机名，示例：

bash
$ docker run --rm -e MDNS_HOSTNAME=something.else.local hausgold/opensearch

此时服务可通过something.else.local访问。

通过MDNS_CNAMES环境变量可配置多个别名（CNAME），使用逗号分隔：

bash
$ docker run --rm \
  -e MDNS_HOSTNAME=something.else.local \
  -e MDNS_CNAMES=nothing.else.local,special.local \
  hausgold/opensearch

此时服务可通过something.else.local、nothing.else.local和special.local访问。

其他顶级域名

默认使用.local作为mDNS顶级域名。若需使用其他顶级域名，需配置主机Avahi服务以支持自定义TLD。

扩展阅读

• Docker/mDNS演示：https://github.com/Jack***/docker-mdns
• Archlinux配置指南：[***]
• Ubuntu/Debian配置指南：[***]