mwed/elasticsearch

Elasticsearch Circle CI构建镜像

镜像概述

本镜像专为Circle CI持续集成/持续部署环境优化，基于官方Elasticsearch基础镜像构建，针对CI场景进行轻量化配置与性能调优，旨在为Circle CI构建流程提供便捷、可靠的Elasticsearch服务支持，满足应用构建或测试阶段对Elasticsearch服务的依赖需求。

核心功能与特性

• Circle CI兼容性：针对Circle CI容器运行环境优化，支持与Circle CI构建代理无缝集成
• 轻量级配置：默认启用开发模式配置，减少资源占用，加快启动速度（平均启动时间<30秒）
• 灵活参数调优：支持通过环境变量自定义Elasticsearch核心参数，适配不同测试场景
• 多版本支持：提供Elasticsearch 7.x/8.x主流版本标签，满足不同应用兼容性需求
• 无持久化默认配置：默认禁用数据持久化，适合CI临时服务场景，避免磁盘空间占用

使用场景

• 应用单元测试/集成测试阶段需连接Elasticsearch实例验证功能
• 构建流程中需执行Elasticsearch索引初始化、数据导入等前置操作
• CI环境下Elasticsearch插件开发或功能验证
• 微服务架构中依赖Elasticsearch的服务组件构建验证

使用方法与配置说明

基础使用（Circle CI配置）

在Circle CI配置文件（.circleci/config.yml）中添加服务定义：

yaml
version: 2.1
jobs:
  build-and-test:
    docker:
      - image: cimg/base:current
      - image: elasticsearch-circleci:8.10.4  # 指定镜像版本
        environment:
          - ES_JAVA_OPTS: "-Xms256m -Xmx256m"  # 调整JVM内存（CI环境建议256-512m）
          - discovery.type: single-node  # 单节点模式（CI场景推荐）
          - cluster.name: circle-ci-test  # 集群名称标识
    steps:
      - checkout
      - run: echo "等待Elasticsearch启动..."
      - run: curl --retry 10 --retry-delay 5 -v http://localhost:9200/_cluster/health?wait_for_status=green&timeout=30s
      - run: ./run-tests.sh  # 执行依赖Elasticsearch的测试脚本

独立运行示例（本地调试用）

bash
docker run -d \
  --name es-circleci \
  -p 9200:9200 \
  -e "ES_JAVA_OPTS=-Xms256m -Xmx256m" \
  -e "discovery.type=single-node" \
  -e "cluster.name=local-ci-test" \
  elasticsearch-circleci:8.10.4

核心环境变量配置

启动状态验证

Elasticsearch启动完成后可通过以下命令验证服务状态：

bash
curl http://localhost:9200/_cluster/health

返回状态为"status":"green"时表示服务就绪。

注意事项

• CI环境资源有限，建议通过ES_JAVA_OPTS严格控制JVM内存占用（推荐256-512m）
• 避免在CI流程中启用数据持久化，如需临时存储可挂载Circle CI工作区目录：-v $CIRCLE_WORKSPACE_DIR/es-data:/usr/share/elasticsearch/data
• 不同Elasticsearch版本配置参数存在差异，使用时需对应官方版本文档调整环境变量
• 生产环境请勿使用本镜像，建议使用官方标准镜像并配置完整安全策略