
ilum/hiveProduction-ready Apache Hive Metastore and HiveServer2 images optimized for Kubernetes and Ilum.
. It is specifically designed for cloud-native environments with built-in support for major cloud storage providers.
hive with UID 1001)linux/amd64 and linux/arm64bash# Run Hive Metastore with local Derby database docker run -d \ --name ilum-hive-metastore \ -e SERVICE_NAME=metastore \ -p 9083:9083 \ ilum/hive:<version>
For production deployments, use the official Ilum Hive Metastore Helm Chart.
<version>: Apache Hive 3.1.3 + Hadoop 3.3.6 + Tez 0.9.2TIP: Choosing a version: Always use a version that matches your Hadoop/Spark ecosystem requirements (Hadoop 3.x is standard for Ilum).
| Variable | Description |
|---|---|
| SERVICE_NAME | Defines the service to run: metastore or hiveserver2 |
| DB_DRIVER | Database driver: postgres (recommended) or derby (default) |
| Variable | Default Value | Description |
|---|---|---|
| IS_RESUME | false | Set to true to skip schema initialization on restart |
| SCHEMA_COMMAND | initSchema | Schema tool action: initSchema or upgradeSchema |
| SERVICE_OPTS | - | Additional JVM options (e.g. heap size) |
| VERBOSE | false | Enable verbose logging during startup |
Variables can also be defined with hyphens if required by your configuration management.
| Container Path | Purpose |
|---|---|
/opt/hive/data/warehouse | Default Hive Warehouse location (Local/S3/GCS) |
/opt/hive/conf | Hive configuration — mount custom XMLs here |
/home/hive/.beeline | Beeline command history and configuration |
yaml# docker-compose example volumes: - ./hive-site.xml:/opt/hive/conf/hive-site.xml - ./warehouse:/opt/hive/data/warehouse
TIP:
Use HIVE_CUSTOM_CONF_DIR env to point to a folder with custom hive-site.xml and core-site.xml. They will be automatically linked at startup.
| Port | Service |
|---|---|
9083 | Hive Metastore (Thrift) |
*** | HiveServer2 (Thrift/JDBC) |
*** | HiveServer2 Web UI |
The image runs as user hive (UID 1001). When mounting host volumes, ensure directories have appropriate permissions:
bash# On host sudo chown -R 1001:1001 /path/to/warehouse /path/to/conf
CAUTION: Never pass passwords or cloud keys directly in environment variables!
Recommended methods:
Before production deployment, scan the image:
bash# Trivy trivy image ilum/hive:<version>
Run command from the docker/ilum-hive-metastore directory:
bashdocker buildx build \ --platform linux/amd64,linux/arm64 \ -t ilum/hive:<version> \ --push .
bashdive ilum/hive:<version>
bash# Syft syft ilum/hive:<version> -o spdx-json > sbom.json




manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务