CoreMedia Solr基础镜像

该镜像基于DockerHub上的官方Solr镜像构建，并添加了以下功能：

• 用于配置环境变量的脚本逻辑
• 支持主从（leader/follower）架构的脚本逻辑
• JMX Prometheus代理

发布说明

发布说明可在GitHub查看。

许可证

与所有Docker镜像一样，此镜像包含的其他软件可能采用不同许可证（例如基础发行版中的Bash、coreutils等，以及包含的主要软件的任何直接或间接依赖项）。

• solr - Apache License 2.0

• prometheus jmx exporter - Apache License 2.0

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用均符合其中包含的所有软件的相关许可证要求。

规格说明

⚠️ 2022-09-30 - 当前规格可在GitHub查看

目录结构

与默认Solr镜像不同，此镜像仅将索引存储在/var/solr中，而将配置和其他类路径文件分开存储。这允许通过推出新版本镜像来替换配置和自定义代码，从而实现升级流程。

• /opt/solr/server/solr - Solr主目录，由环境变量SOLR_HOME设置。
• /var/solr/data - Solr核心目录，由Java系统属性-DcoreRootDirectory设置。
• /opt/solr/prometheus - Prometheus JMX代理的配置目录。

环境变量

• SOLR_HEAP - 默认值为512m。
• SOLR_OPTS - 默认值为-XX:-UseLargePages。
• EXIT_ON_OOM - 默认值为true。
• PROMETHEUS - 默认值为false。

端口

• 8983 - 标准Solr端口。
• 8199 - 若启用，Prometheus代理端口。

卷

/var/solr应作为挂载卷以持久化搜索索引。

主从索引复制

要启用主从索引复制，需添加另一个Solr容器实例，并配置以下环境变量：

• SOLR_LEADER - 在从节点上设置为false。
• SOLR_FOLLOWER - 在从节点上设置为true。
• SOLR_LEADER_URL - 设置为主节点的Solr URL。
• SOLR_FOLLOWER_AUTOCREATE_CORES - 设置为true以自动为从节点创建核心。
• SOLR_FOLLOWER_AUTOCREATE_CORES_LIST - 设置为空格分隔的核心名称列表，用于控制该从节点应复制哪些核心。
• SOLR_FOLLOWER_AUTOCREATE_THRESHOLD - 设置为数值，用于指定在创建所有找到的核心并启动Solr之前，至少需要等待的核心数量。仅当SOLR_FOLLOWER_AUTOCREATE_CORES_LIST为空时生效。

示例

1. 构建镜像：

docker build -t coremedia/solr-base .

2. 运行docker-compose配置：

docker-compose --profiles with-replication up

docker-compose.yml配置如下：

version: "3.8"

services:
  solr-leader:
    image: coremedia/solr-base
    container_name: solr-leader
    ports:
    - 8983:8983
    volumes:
    - solr-leader_data:/var/solr
    
  # 使用副本时不能设置container_name
  solr-follower:
    image: coremedia/solr-base  
    profiles:
      - with-replication
    depends_on:
      - solr-leader
    environment:
      SOLR_LEADER: "false"
      SOLR_FOLLOWER: "true"
      SOLR_LEADER_URL: [***]
    deploy:
      mode: replicated
      replicas: 3
    ports:
      # 仅定义容器端口可避免主机端口冲突，Docker将选择随机端口
      - "8983" 
    volumes:
      # 每个副本的匿名卷挂载
      - /var/solr 

volumes:
  solr-leader_data: {}