jcjabouille/hbase-standalone

镜像概述

jcjabouille/hbase-standalone是一个独立运行的HBase服务器镜像，主要用于测试环境（如Testcontainers），可快速部署单节点HBase服务，无需复杂的分布式配置，方便开发和测试过程中集成HBase功能。

核心功能和特性

• 独立运行：单容器即可运行完整HBase服务，无需依赖外部ZooKeeper或其他HBase节点
• 端口自定义：支持通过环境变量配置HBase Master和Region Server端口
• 测试友好：兼容Testcontainers，适合在自动化测试中作为临时HBase服务使用
• 快速启动：简化部署流程，缩短测试环境搭建时间

使用场景

• 开发环境中需要快速搭建HBase服务进行功能验证
• 自动化测试（尤其是集成测试）中作为临时HBase服务提供数据存储支持
• 学习和研究HBase基础功能的本地环境搭建

使用方法和配置说明

基本运行命令

通过docker run直接启动HBase独立服务：

bash
docker run --env HBASE_MASTER_PORT=16000 --env HBASE_REGION_PORT=16020 jcjabouille/hbase-standalone:2.4.9

环境变量配置

Testcontainers集成示例（Scala）

以下是在Scala测试中使用该镜像的示例代码：

scala
private[test] class GenericHbase2Container
    extends GenericContainer[GenericHbase2Container](
      DockerImageName.parse("jcjabouille/hbase-standalone:2.4.9")
    ) {
  // 随机获取可用端口（Master端口从18000开始查找，Region端口从20000开始查找）
  private val randomMasterPort: Int = FreePortFinder.findFreeLocalPort(18000)
  private val randomRegionPort: Int = FreePortFinder.findFreeLocalPort(20000)
  private val hostName: String = InetAddress.getLocalHost.getHostName

  // 创建HBase配置对象
  val hbase2Configuration: Configuration = HBaseConfiguration.create
  
  // 暴露必要端口
  addExposedPort(randomMasterPort)
  addExposedPort(randomRegionPort)
  addExposedPort(2181)  // ZooKeeper端口
  
  // 设置容器主机名
  withCreateContainerCmdModifier { cmd: CreateContainerCmd =>
    cmd.withHostName(hostName)
    ()
  }
  
  // 等待容器启动完成（通过日志判断）
  waitingFor(Wait.forLogMessage(".*0 row.*", 1))
  // 设置启动超时时间（10分钟）
  withStartupTimeout(Duration.ofMinutes(10))
  
  // 配置环境变量（自定义端口）
  withEnv("HBASE_MASTER_PORT", randomMasterPort.toString)
  withEnv("HBASE_REGION_PORT", randomRegionPort.toString)
  
  // 设置端口映射
  setPortBindings(Seq(s"$randomMasterPort:$randomMasterPort", s"$randomRegionPort:$randomRegionPort").asJava)

  // 启动后配置HBase客户端连接参数
  override protected def doStart(): Unit = {
    super.doStart()
    hbase2Configuration.set("hbase.client.pause", "200")
    hbase2Configuration.set("hbase.client.retries.number", "10")
    hbase2Configuration.set("hbase.rpc.timeout", "3000")
    hbase2Configuration.set("hbase.client.operation.timeout", "3000")
    hbase2Configuration.set("hbase.client.scanner.timeout.period", "10000")
    hbase2Configuration.set("zookeeper.session.timeout", "10000")
    hbase2Configuration.set("hbase.zookeeper.quorum", "localhost")
    hbase2Configuration.set("hbase.zookeeper.property.clientPort", getMappedPort(2181).toString)
  }
}

注意事项

• 该镜像主要用于测试环境，不建议在生产环境中使用
• 启动时需确保映射的端口未被占用，或使用随机端口避免冲突
• 首次启动可能需要较长时间（约1-2分钟），具体取决于宿主机性能