wangpan007/kingbase

Kingbase Docker镜像文档

镜像概述

Kingbase Docker镜像提供了Kingbase数据库的容器化部署方案，支持多种数据库兼容模式（oracle、pg、mysql、sqlserver），可通过环境变量灵活配置数据库参数，实现快速部署和运行。镜像包含完整的数据库初始化和启动逻辑，支持持久化存储，适用于开发测试、生产环境等多种场景。

核心功能与特性

• 多模式支持：兼容oracle、pg（PostgreSQL）、mysql、sqlserver四种数据库模式
• 环境变量配置：通过环境变量设置数据库用户、密码、运行模式等核心参数
• 持久化存储：支持数据卷挂载，确保数据持久化
• 自动启动：配置后可自动初始化并启动数据库服务
• 大小写敏感控制：针对不同模式提供大小写不敏感配置选项

使用场景

• 开发环境快速搭建Kingbase数据库服务
• 测试环境验证多数据库模式兼容性
• 生产环境部署Kingbase数据库（需配合持久化存储和高可用配置）
• 容器化环境（Docker/K8s）中的数据库服务部署

使用方法

Docker部署

基本运行命令

bash
docker run -tid --privileged \
-p 4321:54321 \
-v /opt/kingbase/data:/home/kingbase/userdata/ \
--restart=always \
-e NEED_START=yes  \
-e DB_USER=kingbase  \
-e DB_PASSWORD=123456 \
-e DB_MODE=oracle  \
--name kingbase  \
kingbase:v1 /usr/sbin/init

参数说明

• --privileged：授予容器特权模式，确保数据库服务正常运行
• -p 4321:54321：端口映射，主机4321端口映射到容器54321端口
• -v /opt/kingbase/data:/home/kingbase/userdata/：数据卷挂载，持久化数据库数据
• --restart=always：容器退出时自动重启
• --name kingbase：指定容器名称为kingbase

K8s部署

1. 持久化存储声明（PVC）

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: kingbase-data-pvc
  namespace: datasource
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 20Gi 
  storageClassName: local

2. 部署（Deployment）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: kingbase
  namespace: datasource
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kingbase
  template:
    metadata:
      labels:
        app: kingbase
    spec:
      containers:
        - name: kingbase
          image: kingbase:v1
          args: ["/usr/sbin/init"]
          ports:
            - containerPort: 54321
          env:
            - name: NEED_START
              value: "yes"
            - name: DB_USER
              value: "kingbase"
            - name: DB_PASSWORD
              value: "123456"
            - name: DB_MODE
              value: "oracle"
          volumeMounts:
            - name: kingbase-data
              mountPath: /home/kingbase/userdata/data
          securityContext:
            privileged: true
      volumes:
        - name: kingbase-data
          persistentVolumeClaim:
            claimName: kingbase-data-pvc

3. 服务（Service）

yaml
apiVersion: v1
kind: Service
metadata:
  name: datasource-kingbase
  namespace: datasource
spec:
  type: NodePort
  ports:
    - port: 54321
      targetPort: 54321
  selector:
    app: kingbase

注意：K8s服务名称不要直接设置为"kingbase"，避免与Kingbase自身initdb的变量冲突。

环境变量说明

模式与大小写敏感配置关系

• oracle模式：通过-e ENABLE_CI=yes配置大小写不敏感
• pg模式：初始化不带--enable-ci选项（大小写敏感）
• mysql模式：初始化带--enable-ci选项（大小写不敏感）
• sqlserver模式：--enable-ci选项设置不生效