daunnc/hbase

HBase Docker镜像文档

镜像概述

本镜像用于在Docker容器中运行HBase，包含嵌入式Zookeeper，数据存储在容器内部文件系统。由于HBase通过主机名从容器内Zookeeper传递连接数据，需编辑本地服务器的/etc/hosts文件添加容器主机名条目。未来可能通过Docker新网络功能优化此问题，但目前尚未实现。

核心功能和特性

• 集成HBase与嵌入式Zookeeper，无需额外Zookeeper服务
• 数据持久化到容器内文件系统，支持挂载外部数据卷
• 提供Web UI监控HBase Master、Region Servers、Thrift和REST服务状态
• 支持通过Thrift和Java API连接HBase
• 可自定义容器主机名

使用场景

• 开发环境中快速部署HBase进行应用测试
• 学习和演示HBase功能
• 小型HBase集群的本地模拟

使用方法

构建镜像

bash
$ docker build -t daunnc/hbase .

拉取镜像

如需直接使用已构建的镜像：

bash
$ docker pull daunnc/hbase

更多详情请访问 https://hub.docker.com/r/daunnc/hbase/

运行HBase

手动运行

bash
$ mkdir data
$ id=$(docker run --name=hbase-docker -h hbase-docker -d -v $PWD/data:/data daunnc/hbase)

使用脚本自动配置hosts

运行脚本自动编辑/etc/hosts文件，将容器主机名"hbase-docker"解析到容器IP（需sudo权限）：

bash
$ ./start-hbase.sh

自定义主机名

通过-h或--hostname参数指定不同主机名，可在同一主机运行多个HBase容器（可能需要修改端口，未测试）：

bash
$ docker run --name=my-hbase -h my-hbase -d daunnc/hbase

或通过环境变量HBASE_DOCKER_HOSTNAME设置：

bash
$ docker run -e HBASE_DOCKER_HOSTNAME=my-hbase -d daunnc/hbase

查看HBase状态

假设容器主机名为"hbase-docker"，可通过以下URL访问Web UI：

• Master状态：[***] Servers状态链接在此页面）
• Thrift UI：[***]
• REST服务UI：[***]
• 嵌入式Zookeeper状态：[***]

查看HBase日志

实时查看最新日志

bash
$ docker attach $id

按^C可退出但不终止容器。

查看所有日志

bash
$ docker logs $id

通过数据卷查看日志文件

若挂载了数据卷（如-v $PWD/data:/data），可直接查看卷目录下的日志：

bash
$ ls $PWD/data/logs

测试HBase功能

通过Python Thrift测试

使用Happybase库（基于Thrift协议）连接HBase：

1. 安装Happybase：

bash
$ pip install happybase  # 或 pip install --user happybase

2. 连接并操作HBase：

python
>>> import happybase
>>> connection = happybase.Connection('hbase-docker', 9090)  # 9090为Thrift API端口
>>> connection.create_table('table-name', {'family': dict()})  # 创建表
>>> connection.tables()  # 列出所有表
['table-name']
>>> table = connection.table('table-name')
>>> table.put('row-key', {'family:qual1': 'value1', 'family:qual2': 'value2'})  # 插入数据
>>> for k, data in table.scan():  # 扫描表数据
...   print(k, data)
...
row-key {'family:qual1': 'value1', 'family:qual2': 'value2'}

通过Java Shell测试

使用HBase Shell连接容器内HBase：

bash
$ docker run --rm -it --link $id:hbase-docker daunnc/hbase hbase shell

进入Shell后可执行HBase命令：

hbase(main):001:0> status
1 active master, 0 backup masters, 1 servers, 0 dead, 2.0000 average load
Took 0.7255 seconds
hbase(main):002:0> list
TABLE
table-name
1 row(s)
Took 0.0509 seconds
=> ["table-name"]

若本地有HBase分发版，可通过配置hbase.zookeeper.quorum=hbase-docker连接容器内Zookeeper，使用bin/hbase shell操作。

本地代理HBase UI

若Docker运行在远程服务器，可通过SSH端口转发在本地浏览器访问HBase UI。在~/.ssh/config中添加：

Host my-docker-server
Hostname 1.2.3.4  # 远程Docker服务器IP
    LocalForward 127.0.0.1:16010 127.0.0.1:16010
    LocalForward 127.0.0.1:9095 127.0.0.1:9095
    LocalForward 127.0.0.1:8085 127.0.0.1:8085

通过ssh my-docker-server连接后，可在本地访问：

• Master状态：http://localhost:***/master-status
• Thrift UI：http://localhost:9095/thrift.jsp
• REST服务UI：http://localhost:8085/rest.jsp
• Zookeeper状态：http://localhost:***/zk.jsp

参考链接

• Happybase文档
• https://github.com/wbolster/happybase