Docker应用连接TDengine数据库的解决方案

1、工作环境

• 开发工具：IDEA，安装插件docker
• TDengine Version：2.0.20.5
• taos jdbc Version: 2.0.22
• Springboot Version: 2.4.5
• Docker Version： 20.10.10

---

2、Dockerfile设置

### 基础镜像
FROM openjdk:8

### 作者
MAINTAINER luojiarui <luojiarui2@163.com>

### 系统编码
ENV LANG=C.UTF-8 LC_ALL=C.UTF-8

### 声明挂载点，容器内此路径会对应宿主机的某个文件夹
VOLUME /tmp

### 应用构建成功以后jar文件被复制到镜像内，名字也改为app.jar
ADD target/service-app-1.0-SNAPSHOT.jar app.jar

### 启动容器时的进程
ENTRYPOINT ["java"， "-jar", "/app.jar"]

### 暴露的端口
EXPOSE 8099
    

在IDEA中编写一个Dorckerfile，文件的位置和springboot项目的根目录一致。

使用远程的Ubuntu服务器的docker进行镜像打包和部署。

再检查一遍项目的配置文件，这里需要设置jdbc的连接配置：

### 设置JDBC的连接地址，必须加上taos的账号密码，这里使用的是TDengine的默认密码
taosJdbc:
    url: jdbc:TAOS://node1:6030//alpha_db？user=root&password=taosdata

### 使用Restful连接taos的配置也记录下来
url:
    taos-path: http://node1:6041/rest/sql
    table: alpha_db.can_super

从项目的配置文件中，可以看到FQDN设置的是node1。

node1是TDengine机所在机器的地址，其真实ip地址为： 129.122.12.12。

特别要注意这里的修改，否则会出现问题。

---

3、创建容器

根据镜像文件service-app:v1创建容器的命令如下。

docker run 
    -d ## 后台运行
    -name service-app ## 容器命令
    -p 8099:8099 ## 端口映射，<主机端口: 容器端口>
    -v /usr/local/taos/driver/libtaos.so.2.0.20.5:/usr/lib/libtaos.so ## 指定容器里taos的数据库客户端
    -v /usr/share/zoneinfo:/usr/share/zoneinfo ## 数据卷映射
    -e TZ=AsiaShanghai ## 时区
    --add-host=node1:10.30.5.55 ## 增加DNS解析
    service-app:v1 ## 容器名

---

4、容器内缺少驱动

问题1: java使用JDBC建立简介，在windows系统上可以正常运行，打包放到docker容器中运行时，出现如下异常：

$ Caused by: Java.lang.NoClassDefFonderError： Could not initialize calss com.taosdata.jdbc.TSDBJNIConnecter
....

通过查找前人的方案，通过指定taos驱动和时区，解决该问题。

https://github.com/taosdata/TDengine/issues/4238 “java.lang.NoClassDefFoundError: Could not initialize class com.taosdata.jdbc.TSDBJNIConnector #4238”

问题2：使用的基础镜像Aline不支持

$ /user/lib/libtaos.so: Error loading shared libary ld-linux-x86-64.so.2: No such file or directory (needed by /usr/lib/libtaos.so)
...

在驱动已经映射的基础上，依然缺少某些文件，那么就找一下为什么缺少的原因。

进入docker以后，查找一下。

### 进入docker
root@xxxx: docker exec -it service-app sh

### 查找
/# ldd /usr/lib/libtaos.so
    ldd(0x7fefebee2000)
    libpthread.so.0 => ldd(0x7fefebee2000)
    libm.so.6 => ldd(0x7fefebee2000)
    librt.so.1 => ldd(0x7fefebee2000)
    libc.so.6 => ldd(0x7fefebee2000)
Error loading shared libaray ld-linux-x86-64.so.2: No such file or directory (need by /usr/lib/libtaos.so)
Error relocating /usr/lib/libtaos.so: _pthread_register_cancel: sysbol not found
...

可以看出这里缺少某些东西，判断是由于我们使用了精简版的JDK，那么我们就将原来的alpine版本的JDK给更换掉。

### 原来的基础镜像
FROM openjdk:8-alpine

### 更换为
FROM openjdk:8

通过更换基础镜像，虽然镜像文件从161MB增加到了320MB，但是该问题解决。

---

5、容器无法连接TDengine

无法连接TDengine： TDengine ERROR （80000015）： Unable to resolve FQDN.

JNI CONNECTION is NULL

解决该问题的办法即是注意JDBC连接的时候不能使用IP地址，然后在运行的容器的时候增加以下的命令。

    --add-host=node1:10.30.5.55 ## 增加DNS解析

---

6、总结

目前TDengine暂时没有看到官方指导案例，在使用docker连接TDengine的时候注意以上细节，一般不会有任何问题。
另外还要注意设置docker的时区问题，否则在使用时间范围查询数据库时会出现时区偏差。

特别感谢涛思数据的董工提供的技术支持。

如果您觉得上面的内容对您有帮助欢迎点赞、评论、转发！
更多内容请查阅作者博客：https://jiaruiblog.com，欢迎打赏支持
或者star作者github: https://github.com/Jarrettluo?tab=repositories