huzhihui/kingbase

镜像概述

构建版本：V008R006C007B0012
暴露端口：54321

该镜像提供人大金仓KingbaseES数据库的容器化部署方案，支持通过环境变量自定义配置，支持数据目录和授权文件挂载，适用于快速搭建数据库服务并进行持久化管理。

核心功能与特性

• 环境变量配置：支持通过环境变量设置初始密码、初始化参数等关键配置
• 数据持久化：可挂载数据目录实现数据持久化存储
• 授权管理：需挂载授权文件以正常使用数据库功能
• 多模式支持：默认采用Oracle模式，可通过初始化参数调整

环境变量说明

KINGBASE_SYSTEM_PASSWORD

• 描述：初始system用户密码
• 默认值：123456

EXTEND_INIT_PARAM

• 描述：扩展人大金仓数据库初始化参数
• 默认值：--locale=en_US.UTF-8 -m oracle --enable-ci
• 说明：默认用户名称、密码文件和容器中数据存储目录不可修改（已固定配置）；具体参数可参考官方文档

ORA_INPUT_EMPTYSTR_ISNULL

• 描述：输入空字符串时的处理措施
• 取值：on（将空字符串作为null处理）、off（不处理）
• 说明：在pg模式下，该参数默认值为off，且禁止设置为on

文件夹挂载要求

必须挂载的目录/文件

1. 数据目录：/opt/Kingbase/ES/V8

   • 要求：该目录必须拥有777权限，或不挂载（不推荐，数据将随容器销毁）

2. 授权文件：/home/kingbase/license.dat

   • 要求：必须挂载有效的授权文件
   • 授权文件下载地址：[***]

使用方法

docker-compose部署示例

以下示例通过docker-compose部署，包含数据目录挂载、授权文件挂载、端口映射及环境变量配置：

yaml
version: '3'
services:
  kingbase-v8r6:
    image: huzhihui/kingbase:v8r6
    container_name: kingbase-v8r6
    networks:
      - default
    environment:
      - "KINGBASE_SYSTEM_PASSWORD=123456"  # 初始system用户密码
    volumes:
      - "./V8:/opt/Kingbase/ES/V8"         # 数据目录挂载
      - "./license.dat:/home/kingbase/license.dat"  # 授权文件挂载
    ports:
      - 54321:54321  # 端口映射
networks:
  default:
    external:
      name: huzhihui  # 使用外部网络（需提前创建）

启动与验证

启动服务

bash
docker-compose up -d

验证启动成功

查看容器日志，出现以下内容表示启动成功：

fixing permissions on existing directory /opt/Kingbase/ES/V8/data ... ok
creating subdirectories ... ok
selecting dynamic shared memory implementation ... posix
selecting default max_connections ... 100
selecting default shared_buffers ... 128MB
selecting default time zone ... Asia/Shanghai
creating configuration files ... ok
Begin setup encrypt device
initializing the encrypt device ... ok
running bootstrap script ... ok
performing post-bootstrap initialization ... ok
create security database ... ok
load security database ... ok
syncing data to disk ... ok


Success. You can now start the database server using:

    /home/kingbase/Server/bin/sys_ctl -D /opt/Kingbase/ES/V8/data -l logfile start

initdb: warning: enabling "trust" authentication for local connections
You can change this by editing sys_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
2023-02-08 09:22:07.127 CST [27] LOG:  sepapower extension initialized
2023-02-08 09:22:07.130 CST [27] LOG:  starting KingbaseES V008R006C007B0012 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 4.1.2 20080704 (Red Hat 4.1.2-46), 64-bit
2023-02-08 09:22:07.130 CST [27] LOG:  listening on IPv4 address "0.0.0.0", port 54321
2023-02-08 09:22:07.130 CST [27] LOG:  listening on IPv6 address "::", port 54321
2023-02-08 09:22:07.131 CST [27] LOG:  listening on Unix socket "/tmp/.s.KINGBASE.54321"
2023-02-08 09:22:07.168 CST [27] LOG:  redirecting log output to logging collector process
2023-02-08 09:22:07.168 CST [27] HINT:  Future log output will appear in directory "sys_log".

镜像构建说明

构建依赖

• 源文件：kingbase.tar.gz（包含Server端完整文件，通过在Ubuntu系统安装后复制Server目录压缩得到）
• 入口脚本：entrypoint.sh（负责权限设置、数据库初始化及启动）
• Dockerfile：定义基础镜像、用户配置、环境变量及启动命令

entrypoint.sh脚本

bash
#! /bin/bash

chmod -R +x /home/kingbase/Server

if [ ! -e "/opt/Kingbase/ES/V8/data/SYS_VERSION" ];then
  mkdir -p /opt/Kingbase/ES/V8/data
  echo ${KINGBASE_SYSTEM_PASSWORD-123456} > /home/kingbase/password
  echo "init param --> /home/kingbase/Server/bin/initdb -U SYSTEM --pwfile=/home/kingbase/password -E UTF8 -D /opt/Kingbase/ES/V8/data ${EXTEND_INIT_PARAM}"
  /home/kingbase/Server/bin/initdb -U SYSTEM --pwfile=/home/kingbase/password -E UTF8 -D /opt/Kingbase/ES/V8/data ${EXTEND_INIT_PARAM}
  if [ -n "${ORA_INPUT_EMPTYSTR_ISNULL}" ]; then
    sed -i "s/ora_input_emptystr_isnull.*/ora_input_emptystr_isnull = ${ORA_INPUT_EMPTYSTR_ISNULL}/" /opt/Kingbase/ES/V8/data/kingbase.conf
  fi
fi

/home/kingbase/Server/bin/kingbase -D /opt/Kingbase/ES/V8/data/

Dockerfile

dockerfile
FROM huzhihui/ubuntu:18.04-fonts
MAINTAINER ***

RUN groupadd kingbase && useradd -g kingbase -m -d /home/kingbase -s /bin/bash kingbase
RUN mkdir -p /opt/Kingbase/ES/V8
ADD kingbase.tar.gz /home/kingbase
ADD entrypoint.sh /entrypoint.sh

RUN chmod +x /entrypoint.sh
RUN chown -R kingbase:kingbase /opt/Kingbase/ES/V8
RUN chown -R kingbase:kingbase /home/kingbase

ENV KINGBASE_SYSTEM_PASSWORD=***
ENV EXTEND_INIT_PARAM="--locale=en_US.UTF-8 -m oracle --enable-ci"
EXPOSE 54321
USER kingbase

ENTRYPOINT ["sh","-c","/entrypoint.sh"]