wikibase/elasticsearch

Wikibase Suite Elasticsearch 镜像文档

1. 镜像概述与主要用途

Wikibase Suite Elasticsearch 镜像（以下简称 "WBS Elasticsearch 镜像"）是 Wikibase Suite (WBS) 的核心组件之一，专为简化 Wikibase 生产环境自托管而设计。该镜像基于 Elasticsearch 构建，并集成了针对 Wikimedia/Wikibase 的自定义插件，旨在为自托管的 Wikibase 实例提供高效的搜索与索引能力，支持用户维护类似 Wikidata 的知识图谱数据。

2. 核心功能与特性

• Elasticsearch 基础能力：提供全文搜索、分布式索引、实时数据分析等 Elasticsearch 原生功能，支持大规模知识图谱数据的高效存储与检索。
• Wikimedia/Wikibase 自定义插件：集成专为 Wikibase 数据模型优化的插件，确保与实体、属性、声明等 Wikibase 核心数据结构的兼容性，提升知识图谱数据的搜索准确性。
• WBS 生态集成：作为 Wikibase Suite 的一部分，可无缝对接 Wikibase 应用、数据库等其他组件，简化整体部署流程。

3. 使用场景与适用范围

• 自托管 Wikibase 实例：适用于需要独立部署 Wikibase 以管理自有知识图谱数据的个人或组织。
• 知识图谱搜索需求：满足对结构化/半结构化知识数据（如实体关系、属性值）的高效搜索、过滤及聚合分析场景。
• 生产环境部署：支持企业、研究机构等在生产环境中稳定运行 Wikibase 实例，提供可靠的搜索服务支撑。

4. 使用方法与配置说明

4.1 获取镜像

镜像的具体版本及获取方式，请参考 https://github.com/wmde/wikibase-release-pipeline/tree/main/build/elasticsearch/README.md%E3%80%82

4.2 基本运行示例

4.2.1 独立运行（docker run）

bash
docker run -d --name wbs-elasticsearch \
  -p 9200:9200 \  # 映射 Elasticsearch HTTP 端口
  -e discovery.type=single-node \  # 单节点模式（测试/开发环境）
  wikibase/wbs-elasticsearch:latest

注：生产环境需根据集群规模调整配置（如 discovery.seed_hosts、资源限制等），详细参数见官方文档。

4.2.2 集成 Docker Compose

作为 Wikibase Suite 一部分，建议通过 Docker Compose 与其他组件协同部署。典型配置片段示例：

yaml
version: '3'
services:
  elasticsearch:
    image: wikibase/wbs-elasticsearch:latest
    container_name: wbs-elasticsearch
    ports:
      - "9200:9200"
    environment:
      - discovery.type=single-node  # 单节点模式（根据部署规模调整）
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"  # JVM 内存配置
    volumes:
      - elasticsearch-data:/usr/share/elasticsearch/data  # 持久化存储索引数据
    networks:
      - wikibase-network  # 与 Wikibase 其他组件共享网络

  # 其他组件（如 wikibase、数据库等）...

volumes:
  elasticsearch-data:  # 定义数据卷

networks:
  wikibase-network:  # 定义内部网络

4.3 配置参考

镜像的详细配置（如环境变量、插件参数、性能优化）请查阅 https://github.com/wmde/wikibase-release-pipeline/tree/main/build/elasticsearch/README.md%E3%80%82%E5%AE%8C%E6%95%B4%E7%9A%84 Wikibase Suite 部署流程，可参考 https://github.com/wmde/wikibase-release-pipeline/blob/main/deploy/README.md%E3%80%82

5. 相关文档与资源

• https://github.com/wmde/wikibase-release-pipeline/tree/main/build/elasticsearch/README.md
• https://github.com/wmde/wikibase-release-pipeline/blob/main/deploy/README.md
• Wikibase 官方网站
• Elasticsearch 官方文档