smizy/hbase

docker-hbase

![CircleCI]([***]

镜像概述

基于Alpine Linux的Apache HBase Docker镜像，提供轻量级、可快速部署的HBase服务。该镜像集成Hadoop生态组件，支持通过脚本灵活生成不同规模的Hadoop+HBase集群配置，简化分布式环境的搭建流程。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 灵活扩展：支持通过配置参数调整集群规模（ZooKeeper、NameNode、DataNode、HMaster、RegionServer数量）
• 一键部署：提供make_docker_compose_yml.sh脚本自动生成docker-compose配置文件
• 完整生态：集成Hadoop分布式文件系统(HDFS)和ZooKeeper服务
• 易于管理：支持标准Docker Compose命令进行服务启停、日志查看和状态监控

使用场景

• 开发环境中的HBase应用程序测试与调试
• 小规模HBase集群功能验证
• 学习和研究HBase分布式数据库的基本操作
• 快速搭建临时HBase环境进行数据处理实验

使用方法与配置说明

环境准备

1. 确保已安装Docker和Docker Compose
2. 如需使用Docker Machine，加载默认环境变量：

   bash
   # 按需加载默认环境变量
   eval $(docker-machine env default)
   

创建网络

创建专用网络以确保集群内服务通信：

bash
# 创建网络
docker network create vnet

生成docker-compose配置文件

使用脚本生成不同规模的配置文件：

小尺寸集群（无冗余）

适用于开发和测试，仅包含必要组件：

bash
# 生成小尺寸（无冗余）的docker-compose.yml文件
zookeeper=1 namenode=1 datanode=1 ./make_docker_compose_yml.sh hdfs hbase > docker-compose.yml

默认尺寸集群（高可用配置）

包含完整的冗余组件，适用于更接近生产的环境：

bash
# 生成默认尺寸集群配置（zookeeper=3, namenode=2, journalnode=3, datanode=3, hmaster=2, regionserver=3）
./make_docker_compose_yml.sh hdfs hbase > docker-compose.yml

启动服务

启动Hadoop+HBase集群：

bash
# 启动hadoop+hbase
docker-compose up -d

查看服务状态

查看日志

bash
# 持续查看日志输出
docker-compose logs -f

检查容器状态

bash
# 检查运行中的容器状态
docker-compose ps

示例输出：

     Name                   Command               State                  Ports                
---------------------------------------------------------------------------------------------
datanode-1       entrypoint.sh datanode           Up      50010/tcp, 50020/tcp, 50075/tcp     
hmaster-1        entrypoint.sh hmaster-1          Up      16000/tcp, 0.0.0.0:32771->16010/tcp 
namenode-1       entrypoint.sh namenode-1         Up      0.0.0.0:32770->50070/tcp, 8020/tcp  
regionserver-1   entrypoint.sh regionserver       Up      16020/tcp, 16030/tcp                
zookeeper-1      entrypoint.sh -server 1 1 vnet   Up      2181/tcp, 2888/tcp, 3888/tcp

查看资源使用情况

bash
# 查看所有容器的资源使用统计
docker ps --format {{.Names}} | xargs docker stats

使用HBase Shell

通过容器执行HBase Shell进行交互操作：

bash
# 进入HBase Shell
docker exec -it -u hbase regionserver-1 hbase shell

Shell操作示例：

bash
hbase(main):001:0> create 'test', 'cf'  # 创建表test，包含列族cf
hbase(main):002:0> list 'test'          # 列出表test
hbase(main):003:0> put 'test', 'row1', 'cf:a', 'value1'  # 插入数据
hbase(main):004:0> put 'test', 'row2', 'cf:b', 'value2'
hbase(main):005:0> put 'test', 'row3', 'cf:c', 'value3'
hbase(main):006:0> scan 'test'          # 扫描表数据
hbase(main):007:0> get 'test', 'row1'   # 获取指定行数据
hbase(main):008:0> disable 'test'       # 禁用表
hbase(main):009:0> drop 'test'          # 删除表
hbase(main):010:0> exit                 # 退出Shell

停止与清理

停止服务

bash
# 关闭hadoop/hbase服务
docker-compose stop

清理容器

bash
# 移除容器（同时删除关联卷）
docker-compose rm -v