国产化数据库人大金仓（KingBase）部署教程

第一步：获取人大金仓docker镜像#

如果你有现成的镜像压缩包，比如kingbase\_v008r006c008b0014\_single\_x86.tar，那么可以跳过此步骤。

如果没有，打开

https://www.kingbase.com.cn/download.html

找到**“KingbaseES数据库Docker镜像”**，右侧选择需要使用版本，然后在下方选择对应CPU的镜像包进行下载，一般选择X64_Linux，如果你使用的是国产化CPU，也可以选择对应的CPU版本进行下载。（过程中可能会需要填写一些信息，看着填写即可）

接着你会得到一个tar格式的镜像压缩包。

第二步：上传镜像压缩包至服务器#

可以随意找个文件夹塞进去，比如笔者喜欢放在/home下，然后cd进入该目录

1
cd /home

第三步：使用docker读取镜像压缩包#

1
docker load -i kingbase_v008r006c008b0014_single_x86.tar

把压缩包的名字改成你实际压缩包的名字，读取完成后，可以使用images指令，查看当前已加载镜像。

1
docker images

第四步：创建数据持久化目录#

这个目录的作用是持久化数据库的数据，避免容器重启后数据丢失，笔者喜欢在根目录下创建一个data文件夹

1
cd /
2
mkdir data
3
cd /data
4
mkdir kingbase
5
cd /data/kingbase
6
mkdir data
7
cd /data/kingbase/data

稍后将会把容器内的数据库目录挂载到本地/data/kingbase/data目录下

第五步：编写docker-compose.yml文件#

老规矩，回到笔者最爱的home，创建docker-compose.yml文件

1
cd /home
2
vim docker-compose.yml

在docker-compose.yml中编写如下内容

1
services:
2
    kingbase:
3
        # 这里可以自行修改你的容器名称（需自行修改）
4
        container_name: kingbase
5
        # 这里是镜像名称，如果你不知道镜像名称可以使用docker images查看（需自行修改）
6
        image: kingbase_v008r006c008b0014_single_x86:v1
7
        privileged: true
8
        restart: always
9
        environment:
10
            TZ: "Asia/Shanghai"
11
            # 访问数据库的用户名（需自行修改）
12
            DB_USER: xxxx
13
            # 访问数据库的密码（需自行修改）
14
            DB_PASSWORD: xxxx
15
        ports:
16
            # 容器内部与外部的端口映射（默认不要动，kingbase默认使用54321端口）
17
            - "54321:54321"
18
        volumes:
19
            # 持久化目录映射，如果你刚才创建/data/kingbase/data/，那么你可以直接使用下面这个映射配置
20
            - /data/kingbase/data/:/home/kingbase/userdata/data/

保存docker-compose.yml文件

第六步：创建并运行容器#

使用docker-compose工具开始创建容器，首先确保处在docker-compose.yml同级目录中

1
cd /home

然后执行如下命令

1
docker-compose -f docker-compose.yml up -d

等待容器创建完毕

第七步：查看容器运行状态#

使用如下命令查看容器的运行状态

1
docker ps -a

不出意外，你应该会看到

STATUS表示Up xx xx，即表示容器正在运行，部署完成。

下面是一些常用的容器管理指令

1
# 启动容器
2
docker start 容器名称或容器id
3
# 停止容器
4
docker stop 容器名称或容器id
5
# 重启容器
6
docker restart 容器名称或容器id
7
# 删除容器
8
docker rm 容器名称或容器id

第八步：访问数据库#

接下来你就可以使用各类DB工具进行访问了，需要注意的是，人大金仓默认初始数据库是kingbase，用户名和密码是刚才docker-compose.yml配置中的用户名和密码，端口号使用54321