1 概述

CloudBeaver是一个免费的开放源代码的基于Web的数据库管理工具；支持多种数据库，允许像常规电子表格一样处理数据，支持多种格式的数据导出/迁移。
在处理和维护其他数据库迁移到达梦数据库过程中，用本工具连接不同的数据库还是挺方便的。本文介绍将CloudBeaver的容器应用增加达梦数据库支持，在完成配置后也可以保存本地用于虚拟机部署。

2 获取CloudBeaver容器应用

2.1 拉取镜像

查找cloudbeaver容器镜像：
[docker@db1 ~]$ docker search cloudbeaver

将选择的镜像拉取到本地：
[docker@db1 ~]$ docker pull dbeaver/cloudbeaver

查看镜像信息：
[docker@db1 ~]$ docker images

2.2 运行cloudbeaver

执行以下命令运行容器应用：
[docker@db1 ~]$ docker run -d --restart=always --name cloudbeaver dbeaver/cloudbeaver
84a66fbd54c42c49cc8b2dabce68432042f57c611c94393da340285f677e62aa
[docker@db1 ~]$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
84a66fbd54c4 dbeaver/cloudbeaver "./run-server.sh" 16 seconds ago Up 15 seconds 8978/tcp cloudbeaver

2.3 拷贝cloudbeaver应用到虚拟机

[docker@db1 ~]$ mkdir cloudbeaver
[docker@db1 ~]$ cd cloudbeaver
[docker@db1 cloudbeaver]$ docker cp 84a66fbd54c4:/opt .
Successfully copied 287MB to /home/docker/cloudbeaver/.

文件拷贝后可以停止和删除临时应用：
[docker@db1 cloudbeaver]$ docker stop cloudbeaver
[docker@db1 cloudbeaver]$ docker rm cloudbeaver

3 添加达梦数据库配置

3.1 加载DM驱动

将DM8的驱动文件DmJdbcDriver18.jar传到以下目录：
[docker@db1 cloudbeaver]$ mkdir -p opt/cloudbeaver/drivers/dameng

3.2 修改io.cloudbeaver.resources.drivers.base包

[docker@db1 cloudbeaver]$ find . -name io.cloudbeaver.resources.drivers.base*
./opt/cloudbeaver/server/plugins/io.cloudbeaver.resources.drivers.base_1.0.73.202305081041.jar
用解压软件打开io.cloudbeaver.resources.drivers.base_1.0.73.202305081041.jar包，修改plugin.xml文件。

plugin.xml文件增加内容详见以下红框部分：

3.3 修改org.jkiss.dbeaver.ext.generic

[docker@db1 cloudbeaver]$ find . -name org.jkiss.dbeaver.ext.generic*
./opt/cloudbeaver/server/plugins/org.jkiss.dbeaver.ext.generic_2.3.191.202305081041.jar
用解压软件打开org.jkiss.dbeaver.ext.generic_2.3.191.202305081041.jar包，修改plugin.xml文件。

3.3.1 修改plugin.xml

plugin.xml文件增加内容详见以下红框部分：

<driver
id="dameng"
label="DAMENG"
icon="icons/dameng_icon.png"
iconBig="icons/dameng_icon.png"
class="dm.jdbc.driver.DmDriver"
sampleURL="jdbc:dm://{host}[:{port}]"
defaultPort="5236"
webURL="https://www.dameng.com/"
description="DAMENG JDBC driver">
<file type="jar" path="drivers/dameng" bundle="drivers.dameng"/>
</driver>

3.3.2 增加图标

将以下达梦图标命名为：dameng_icon.png，加入下图icons目录中：

4 打包镜像并运行应用

4.1 打包镜像

编辑Dockerfile：

[docker@db1 ~]$ cd cloudbeaver
[docker@db1 cloudbeaver]$ vi Dockerfile
FROM centos:7
WORKDIR /opt
ADD opt .
ENV JAVA_HOME=/opt/java/openjdk
ENV PATH=$JAVA_HOME/bin:$PATH
EXPOSE 8978
WORKDIR /opt/cloudbeaver
ENTRYPOINT ["./run-server.sh"]

打包镜像：
[docker@db1 cloudbeaver]$ docker build -t dm/cloudbeaver:v23.0.4-1 .

查看镜像列表：

4.2 运行dm-cloudbeaver

执行以下命令运行容器应用：
[docker@db1 cloudbeaver]$ docker run -d --restart=always --name dm-cloudbeaver -p 8978:8978 dm/cloudbeaver:v23.0.4-1

至此，已完成支持达梦数据库的cloudbeaver部署。

5 dm-cloudbeaver简要使用说明

5.1 登录

启动cloudbeaver应用后，用浏览器访问（根据应用所在环境修改IP）：http://192.168.228.8:8978
初始界面如下：

点击NEXT，配置登录账号和密码：

继续点击NEXT，再点击FINISH后进入登录界面：

首次登录会默认显示pg库连接，因为没配置所以异常，这个可以忽略。浏览器再次访问：http://192.168.228.8:8978 即可，以后不会再出现异常。

输入前面配置的账号和密码登录后，可以配置语言环境为简体中文：

5.2 配置达梦数据库连接

点击左上角的加号按钮，选择DAMENG数据库：

配置数据库IP、端口，以及连接用户和密码后，可点击“测试连接”验证：

验证通过后，点击右上角“创建”按钮，即完成配置。
如查询数据库实例：

6 镜像迁移

完成一次支持达梦数据库的cloudbeaver配置后，如果想在其他服务器运行，按以下步骤即可。
1、保存镜像文件：
$ docker save -o dm-cloudbeaver.tar dm/cloudbeaver:v23.0.4-1

2、将dm-cloudbeaver.tar传到需要运行的服务器（具备docker环境）

3、新服务器上加载镜像文件
$ docker load -i dm-cloudbeaver.tar

4、执行以下命令创建应用cloudbeaver并启动：
$ docker run -d --restart=always --name dm-cloudbeaver -p 8978:8978 dm/cloudbeaver:v23.0.4-1
注：粗体的端口号可根据需要进行修改。

cloudbeaver应用创建后可使用以下命令停止和启动应用：
停止cloudbeaver：
$ docker stop dm-cloudbeaver

启动cloudbeaver：
$ docker start dm-cloudbeaver

达梦在线服务平台 https://eco.dameng.com