dajobe/hbase

HBase Docker镜像

镜像概述和主要用途

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

核心功能和特性

• 运行HBase 2.1.2版本，内置Zookeeper，无需额外部署
• 支持数据持久化，可通过卷挂载将数据存储到宿主机
• 提供Web UI监控界面，包括Master、Thrift、REST服务及Zookeeper状态
• 可自定义容器主机名，支持多实例部署（需调整端口）
• 支持通过Thrift和Java API连接HBase进行操作

使用场景和适用范围

适用于本地开发、测试环境，快速搭建HBase服务进行应用调试。不建议用于生产环境，生产环境需考虑高可用、数据备份等更复杂配置。

使用方法和配置说明

构建镜像

bash
$ docker build -t dajobe/hbase .

拉取镜像

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

bash
$ docker pull dajobe/hbase

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

运行HBase

手动运行

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

使用脚本运行（自动配置hosts）

运行以下脚本会自动编辑宿主机/etc/hosts文件，将hbase-docker主机名别名指向容器（需输入sudo密码）：

bash
$ ./start-hbase.sh

多实例部署

如需在同一主机运行多个HBase容器，可通过-h/--hostname参数指定不同主机名，同时可能需要调整端口（未测试）。

自定义主机名

通过环境变量HBASE_DOCKER_HOSTNAME自定义容器主机名：

bash
$ docker run --name=my-hbase -h my-hbase -e HBASE_DOCKER_HOSTNAME=my-hbase -d dajobe/hbase

查看HBase状态

假设容器DNS名为hbase-docker，可通过以下URL访问状态页面：

• Master状态：[***]
• Thrift UI：[***]
• REST服务器UI：[***]
• 嵌入式Zookeeper状态：[***]

查看HBase日志

实时查看最新日志

bash
$ docker attach $id

按^C可 detach（不终止容器）。

查看所有日志

bash
$ docker logs $id

通过数据卷查看日志文件

若使用卷挂载（如-v $PWD/data:/data），可直接查看宿主机目录：

bash
$ ls $PWD/data/logs

测试HBase功能

通过Python（Thrift）测试

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

1. 安装Happybase：

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

2. 连接测试：

   python
   $ python
   Python 2.7.15 (default, Jan 12 2019, 21:07:57)
   [GCC 4.2.1 Compatible Apple LLVM 10.0.0 (clang-1000.11.45.5)] on darwin
   Type "help", "copyright", "credits" or "license" for more information.
   >>> 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（HBase Shell）测试

bash
$ docker run --rm -it --link $id:hbase-docker dajobe/hbase hbase shell
HBase Shell
Use "help" to get list of supported commands.
Use "exit" to quit this interactive shell.
For Reference, please visit: http://hbase.apache.org/2.0/book.html#shell
Version 2.1.2, r1dfc418f77801fbfb59a125756891b9100c1fc6d, Sun Dec 30 21:45:09 PST 2018
Took 0.0472 seconds
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(main):003:0>

上述示例显示了通过Happybase创建的table-name表。若宿主机已安装HBase发行版，可通过配置hbase.zookeeper.quorum=hbase-docker（Zookeeper端口2181），使用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