在Jenkins部署项目时,使用docker打包镜像,并在publish到服务器时读取kustomize资源配置。
使用过程中遇到一些部署的错误,本文将描述这些问题的现象以及排查办法。
问题1:kustomize报错conflict between map
一开始发现overlay/kustomization.yaml中编写了两个包含json格式配置的Configmap,认为是这两个Configmap的问题,于是将Configmap单独写为两个yaml文件,并在overlay/kustomization.yaml中通过resources进行加载。
但是,问题并没有解决。
通过阅读Jenkins Job日志中获取kustomize资源的时报错信息,发现它讲的意思应该是有container冲突了。
于是再次阅读overlay/kustomization.yaml,发现通过patchesStrategicMerge补丁文件加载了overlay/env.yaml和overlay/deploy.yaml,而这两个yaml中的确在containers定义了同名的container,而这就是问题根源。
解决:删除overlay/env.yaml中container的配置,使用base/env.yaml的配置即可。
问题2:测试环境发布成功后代码未更新
这个问题不那么容易解决,得捋清思路。
首先得确认测试环境代码是否真的未更新,还是分支取错了;其次得从发布到部署的链路一路排查,究竟是在docker打包镜像时就出错了,还是部署到测试环境时出错。
有了思路,就挨个排查。
At first print log in the source code, recommit and then run jenkins job. 由于没有权限进入pod查看docker image内容,只能从打包docker前的zip包中解压出源码的jar包,发现刚才提交的打印日志代码是存在的。接下来查看Jenkins部署日志,关注pushlish docker image的部分,对比kustomize获取docker image的配置,发现kustomize获取docker image的路径与latest镜像的路径不匹配,导致部署到服务器的docker image始终为之前打包的某一个特定版本。
Solution:modify kustomize config to the path of latest docker image.
问题3:Jenkins部署成功后程序启动失败
Jenkins job run完以后显示Success, 但是实际访问程序失败。一开始以为是Jenkins的配置出错导致没触发程序启动,排查配置似乎没毛病。直到去看了测试环境的启动日志,发现报错问题在于有配置项不存在,而这个配置项所在的application.yaml会在build docker image的时候给build进去,后续获取。
解决:在application.yaml新增所需配置项,这属于代码开发人员维护配置的意识不强造成的defect。
问题4:程序启动成功后报错java.nio.file.NoSuchFileException
程序不会骗人,从java.nio.file.NoSuchFileException的字面意思可以推测,这个文件真的不存在。于是搜索使用这个文件的地方,发现这个文件是ssl证书相关的。
现在需要去找到这个文件的存放路径,继续阅读Jenkins job的日志,发现在打包docker image的Dockerfile中使用ADD指令添加了这个文件,而ADD这个文件的路径的确与使用文件时路径不符。
解决:修改Dockerfile中的文件存储路径,或者修改kustomize配置中获取文件的路径。