一、安装部署
1,导入镜像
#导入镜像(root用户)
[root@node docker ]# mv kdb_x86_64_V008R006C009B0014.tar kingbase.tar
[root@node docker]# docker load -i kingbase.tar#查看镜像(root用户)
[root@node docker]# docker images
2、运行镜像
(1)设置环境变量
#(root用户)
docker run -idt --privileged -p ${hostport}:${containerport} \
–v ${宿主机挂载目录}:${容器挂载目录} \
-e NEED_START=${need_start} \
-e DB_USER=${username} \
-e DB_PASSWORD=${passwd} \
-e DB_MODE=${dbmode} \
-e ENCODING=${encoding} \
--name kingbase kingbase:v1 \
/usr/sbin/init#数据库默认用户名:system 数据库默认密码:12345678ab 数据库默认 data 目录:/home/kingbase/userdata/data 金仓数据库镜像:kingbase:v1
#设置数据库 data 目录的持久化路径时, 需要如下设置:
-v 选项冒号左侧宿主机挂载目录 (/mnt/data) 权限需要设置 755 的权限(chmod -R 755 /mnt/data), 不然会报权限(Permission denied) 错误。
-v 选项冒号右侧为容器内的挂载路径需要设置为/home/kingbase/userdata, 不然 data 目录无法持久化。
(2)最小启动命令
docker run -tid --privileged \
--name kingbase \
kingbase:v1 /usr/sbin/init#查看
docker ps
3.完整启动命令
[root@node docker]# mkdir /mnt/data
[root@node docker]# chmod -R 755 /mnt/data/
[root@node docker]# mkdir /home/kingbase/userdata -p[root@node docker]# docker run -tid --privileged -p 4321:54321 -v /mnt/data:/home/kingbase/userdata/ -e NEED_START=yes -e DB_USER=kingbase -e DB_PASSWORD=123456 -e DB_MODE=oracle --name kingbase kingbase_v008r006c009b0014_single_x86:v1 /usr/sbin/init
4.数据库自动运行
#启动容器+交互式进入容器(root用户)
[root@node docker]# docker exec -it kingbase /bin/bash
[kingbase@e2792704eadb ~]$ #查看状态
[kingbase@e2792704eadb ~]$ sys_ctl -D /home/kingbase/userdata/data/ status
5.ksql访问数据库
#默认是kingbase用户
[kingbase@e2792704eadb ~]$ ksql -Ukingbase -d test -p54321#注意:su - root 会导致环境变量丢失,PATH 中没有 ksql(也无法 ksql 免密登录), 推荐使用 su root
6.容器外访问数据库
#宿主机远程访问需要加-h 及改变映射端口。非root用户(找一个客户端去执行验证)
[kingbase@node1 ~]$ /home/kingbase/Kingbase/ES/V8/Server/bin/ksql -Ukingbase -d test -p 4321 -h 192.168.40.32
7.license持久化以及更换
#容器启动后对应的 license.dat 文件会复制到 etc 持久化目录,并建立软连接。kingbase用户执行。
[kingbase@e2792704eadb ~]$ ls -l /home/kingbase/install/kingbase/bin/license.dat
[kingbase@e2792704eadb ~]$ ls -l /home/kingbase/install/kingbase/etc/
#更新容器挂载目录/mnt/data/etc 目录下的 license.dat 文件(容器内挂载目录应为/home/kingbase/userdata/ 而不是/home/kingbase/userdata/data), 进入容器后,并输入命令修改成正确权限。[kingbase@e2792704eadb ~]$ chown kingbase:kingbase /home/kingbase/userdata/etc/license.dat
[kingbase@e2792704eadb ~]$ chmod 755 /home/kingbase/userdata/etc/license.dat
8.数据库启停
#进入容器/home/kingbase/install/kingbase/bin 目录(kingbase用户)
[kingbase@e2792704eadb ~]$ /home/kingbase/install/kingbase/bin/sys_ctl -D /home/kingbase/userdata/data/ stop
[kingbase@e2792704eadb ~]$ /home/kingbase/install/kingbase/bin/sys_ctl -D /home/kingbase/userdata/data/ start
9.使用 docker logs 查看容器脚本执行日志
#root用户
[root@node docker]# docker logs kingbase
3、选项介绍
为了防止报错,可以先执行以下删除不必要的干扰。
#先查看container id,然后删除运行的容器
[root@node docker]# docker ps
CONTAINER ID [root@node docker]# docker rm -f id号
1.-p绑定端口
#(root用户)
[root@ docker]# docker run -tid --privileged -p 4321:54321 -v /mnt/data:/home/kingbase/userdata/ --name kingbase kingbase_v008r006c009b0014_single_x86:v1 /usr/sbin/init将容器内部端口绑定到宿主机端口 4321 上,在宿主机内连接该数据库宿主机可成功访问对应数据库
#找一个客户端去连接(root用户)
${安装目录}/bin/ksql -Usystem -d test -h 192.168.40.32 -p 4321
2.-v挂载目录
#使用-v 可以将容器内数据目录(/home/kingbase/userdata/)挂载到宿主机设置数据库 data 目录的持久化路径时, 需要如下设置: -v 选项冒号左侧宿主机挂载目录 (/mnt/data) 权限需要设置 755 的权限(chmod -R 755 /mnt/data), 不然会报权限 (Permission denied) 错误。-v 选项冒号右侧为容器内的挂载路径需要设置为/home/kingbase/userdata, 不然 data 目录无法持久化。[root@node docker]# docker run -tid --privileged -p 4321:54321 -v /mnt/data:/home/kingbase/userdata/ --name kingbase kingbase_v008r006c009b0014_single_x86:v1 /usr/sbin/init#查看挂载是否生效
[root@node docker]# docker inspect -f ‘{{.Mounts}}’ kingbase‘[{bind /mnt/data /home/kingbase/userdata true rprivate}]’#持久化数据挂载成功。进入容器。
[root@node docker]# docker exec -it kingbase /bin/bash
[kingbase@10c45ebe9024 ~]$
3.DB_USER: 数据库用户
[root@node docker]# docker run -tid --privileged -p 4321:54321 -v /mnt/data:/home/kingbase/userdata/ -e DB_USER=kingbase --name kingbase kingbase_v008r006c009b0014_single_x86:v1[root@node docker]# docker exec -it kingbase /bin/bash[kingbase@d6b7a7d50e2e ~]$ ksql -Ukingbase -d test
4.DB_PASSWORD: 数据库初始密码
[root@localhost docker]# docker run -tid --privileged -p 4321:54321 -v /mnt/data:/home/kingbase/userdata/ -e DB_USER=kingbase -e DB_PASSWORD=123 --name kingbase kingbase_v008r006c009b0014_single_x86:v1 /usr/sbin/init#找一个客户端去访问测试
${安装目录}/bin/ksql -Ukingbase -dtest -p4321 -h 192.168.40.32
5.DB_MODE: 数据库模式
[kingbase@85ffc680f5d0 ~]$ cat /home/kingbase/userdata/data/initdb.conf |grep mode
--dbmode=oracle
6.NEED_START: 进入容器后是否启动数据库
默认是yes
7.ENCODING: 数据库启动的字符集
默认是UTF8
8.配置文件持久化及修改配置文件后生效
#启动容器后, 一些配置文件会跟着 data 目录一起持久化,包括 kingbase.conf等配置文件. 在持久化目录中修改配置文件后,使用下面的命令来生效:
[kingbase@85ffc680f5d0 ~]$ /home/kingbase/install/kingbase/bin/sys_ctl reload -D /home/kingbase/userdata/data/
9.安装正确性验证
1.#查看容器状态
[root@node ~]# docker ps 2.#看启动日志
[root@node ~]# docker logs kingbase3.#进入容器查看进程
[root@node docker]# docker exec -it kingbase /bin/bash
[kingbase@85ffc680f5d0 ~]$ /home/kingbase/install/kingbase/bin/sys_ctl -D /home/kingbase/userdata/data/ status
sys_ctl: server is running (PID: 87)
10.卸载数据库
1.#先停库
[root@node docker]# docker stop kingbase2.#删除容器
docker ps #查看
docker rm -f id #执行删除3.#删除镜像
docker images
docker rmi (IMAGE ID)
4、注意事项
1.#当使用 docker load -i kingbase.tar 命令报错时,可使用 docker import kingbase.tar 命令,尝试重新导包。2.#创建容器的的时候,可以在“docker run“命令中加--restart=always,将重启策略改为任何情况都重启。3.#docker 版本大于 20.10.0