OpenSearch 镜像文档（Jelastic PaaS 维护版）

1. 镜像概述

本镜像是由 Jelastic PaaS 维护的 OpenSearch 搜索引擎官方适配版本，作为 OpenSearch Cluster 高级套件的核心及唯一必需组件，用于构建可靠、可自动扩展的搜索与数据分析基础设施。镜像集成了针对负载优化的预配置资源策略，可快速部署并提供安全、高质量的搜索服务及灵活的数据/日志分析能力。

2. 核心功能与特性

2.1 预配置资源优化

针对不同负载场景预配置资源调度策略，减少手动调优成本，确保镜像在各类环境中高效运行。

2.2 内置 Web 管理面板

集成原生 OpenSearch Dashboards（或同类管理界面），提供可视化集群监控、索引管理、数据查询等功能，简化运维操作。

2.3 自动访问恢复

支持服务异常中断后的自动访问恢复机制，提升集群可用性，减少人工干预。

2.4 定期更新与安全补丁

由 Jelastic PaaS 团队持续维护，提供定期版本更新及安全补丁，保障镜像安全性与功能时效性。

3. 适用场景与范围

3.1 安全高质量搜索服务

适用于构建需保障数据安全的全文搜索系统，如企业内部文档搜索、电商商品搜索等场景，支持复杂查询与高效结果返回。

3.2 数据/日志分析平台

可作为日志聚合与分析的核心引擎，支持实时数据摄入、结构化/非结构化数据分析，满足运维监控、业务数据分析需求。

3.3 企业级可扩展搜索解决方案

作为 OpenSearch Cluster 的核心组件，支持构建从单节点到多节点的弹性扩展集群，适配从小型应用到大型企业的搜索服务需求。

4. 使用方法与配置说明

4.1 前提条件

• 已安装 Docker 环境（建议 20.10+ 版本）
• 若部署集群，需参考 OpenSearch Cluster 官方文档 配置网络与节点发现

4.2 Docker Run 快速启动

通过 docker run 命令可快速启动单节点 OpenSearch 服务：

docker run -d \
  --name opensearch-node \
  -p 9200:9200 \  # HTTP API 端口
  -p 9300:9300 \  # 节点间通信端口
  -v opensearch-data:/usr/share/opensearch/data \  # 数据持久化卷
  -e "discovery.type=single-node" \  # 单节点模式（集群部署需调整）
  -e "OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m" \  # JVM 内存配置
  jelastic/opensearch:latest  # 镜像名称（以 Jelastic 官方实际标签为准）

说明：

• -v opensearch-data:/usr/share/opensearch/data：挂载数据卷以持久化索引数据，避免容器重启后数据丢失。
• discovery.type=single-node：单节点模式配置，生产环境集群部署需移除该参数并配置集群发现（如 discovery.seed_hosts）。

4.3 Docker Compose 集群部署示例

对于多节点集群场景，可通过 docker-compose.yml 配置（需结合 OpenSearch Cluster 套件要求）：

version: '3'
services:
  opensearch-node1:
    image: jelastic/opensearch:latest
    container_name: opensearch-node1
    environment:
      - cluster.name=opensearch-cluster
      - node.name=opensearch-node1
      - discovery.seed_hosts=opensearch-node2
      - cluster.initial_master_nodes=opensearch-node1,opensearch-node2
      - OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g
    ports:
      - "9200:9200"
      - "9300:9300"
    volumes:
      - opensearch-data1:/usr/share/opensearch/data

  opensearch-node2:
    image: jelastic/opensearch:latest
    container_name: opensearch-node2
    environment:
      - cluster.name=opensearch-cluster
      - node.name=opensearch-node2
      - discovery.seed_hosts=opensearch-node1
      - cluster.initial_master_nodes=opensearch-node1,opensearch-node2
      - OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g
    ports:
      - "9201:9200"
    volumes:
      - opensearch-data2:/usr/share/opensearch/data

volumes:
  opensearch-data1:
  opensearch-data2:

启动命令：

docker-compose up -d

4.4 核心配置参数

以下为常用环境变量配置（具体参数以 Jelastic 官方文档为准）：

5. 注意事项

• 集群部署依赖：作为 OpenSearch Cluster 套件的核心组件，生产环境集群部署需遵循 Jelastic OpenSearch Cluster 官方文档 配置网络、安全策略及自动扩展规则。
• 数据安全：生产环境需启用 TLS/SSL 加密（默认可能已集成 Jelastic PaaS 安全配置），并限制 API 访问权限。
• 资源需求：根据负载调整 OPENSEARCH_JAVA_OPTS 内存配置，避免因资源不足导致服务不稳定。

更多详细配置及最佳实践，请参考 Jelastic OpenSearch Cluster 文档。