制作jdk17+pinpoint-agent基础镜像

本文仅介绍制作镜像，pinpoint 知识不在此介绍，不了解 pinpoint 知识 ，请先行学习

1.背景介绍

新搭建的java应用，基于 Springboot3.2.0 + Spring6.1.1 + jdk17 版本。

从Springboot3开始，jdk最低要求为jdk17，因为之前 jdk1.8 + pinpoint agent 镜像不能再使用。

在制作 jdk17 + pinpoint-agent 基础镜像前，需要用到 pinpoint agent 包。

在制作调试过程中，发现 pinpoint官网 提供的 pinpoint agent 包，都不支持jdk17。

下载（2024/2/7下载）pinpoint源码后，查看最新master分支，发现已在支持jdk17，只是还处于快照版本，未正式发布。

通过编译 pinpoint 源码后，得到 pinpoint-agent-3.0.0-SNAPSHOT 包。

pinpoint-agent-3.0.0-SNAPSHOT 包计划沿用之前安装的 pinpoint collector 服务。

pinpoint collector 服务为：10.28.19.106

2.编写dockerfile

准备好 pinpoint-agent-3.0.0-SNAPSHOT 包后，再找一个jdk17基础镜像，在此之上，将 pinpoint agent 集成进去。

挑选jdk17基础镜像时，对比分析了下镜像大小，这里选择的是 eclipse-temurin:17.0.10_7-jre-alpine

脚本如下，复制粘贴至命令控制台可在/opt目录下，直接创建 jdk17-pinpoint.dockerfile

tee /opt/jdk17-pinpoint.dockerfile << \EOF
# 基础镜像
FROM eclipse-temurin:17.0.9_9-jre-alpineLABEL maintainer="胡桃夹子 <infowangxin@139.com>"# 环境变量设置
ENV TZ="Asia/Shanghai"
ENV PINPOINT="-javaagent:/opt/pinpoint-agent-3.0.0-SNAPSHOT/pinpoint-bootstrap.jar -Dprofiler.jdbc.mssql=true -Dprofiler.jdbc.mssql.tracesqlbindvalue=true"# 安装包
COPY pinpoint-agent-3.0.0-SNAPSHOT.tar.gz /optRUN tar -vxf /opt/pinpoint-agent-3.0.0-SNAPSHOT.tar.gz -C /opt \&& rm /opt/pinpoint-agent-3.0.0-SNAPSHOT.tar.gz
EOF

上面dockerfile文件中，-Dprofiler.jdbc.mssql=true -Dprofiler.jdbc.mssql.tracesqlbindvalue=true 这段，可以选择去掉，

这段是开启 pinpoint 打印 sqlserver sql 脚本及参数。

3.制作镜像

先获取jdk基础 eclipse-temurin:17.0.10_7-jre-alpine

docker pull eclipse-temurin:17.0.10_7-jre-alpine

jdk基础镜像获取成功之后，再进入opt目录构建 jdk17 + pinpoint-agent 基础镜像

cd /opt
docker build --no-cache -f jdk17-pinpoint.dockerfile -t myharbor.com/java:17.0.10_7-jre-alpine-pinpoint .

4.制作应用镜像

这里介绍如何与应用集成在一起制作docker镜像，这里准备了demo.jar，由 Springboot3.2.0 + Spring6.1.1 + jdk17 编译产生。

已完成了 demo.jar 测试，可正常运行。

4.1 编写应用dockerfile

脚本如下，复制粘贴至命令控制台可在/opt目录下，直接创建 demo.dockerfile

tee /opt/demo.dockerfile << \EOF
# 镜像模板
FROM myharbor.com/java:17.0.10_7-jre-alpine-pinpoint# 环境变量设置
ENV JAR=demo.jar
ENV TZ="Asia/Shanghai"# 添加标签，使用构建参数
LABEL maintainer="胡桃夹子 <infowangxin@139.com>"# VOLUME 指定了临时文件目录为/tmp。
# 其效果是在主机 /var/lib/docker 目录下创建了一个临时文件，并链接到容器的/tmp
VOLUME /tmp# 指定默认目录
WORKDIR /opt/app# 传包
COPY $JAR .# 设置Pinpoint Agent的相关环境变量
ENV PINPOINT_OPT="$PINPOINT -Dprofiler.transport.grpc.collector.ip=10.28.19.106"# 带pinpoint-agent启动
ENTRYPOINT [ "sh", "-c", "java ${PINPOINT_OPT} $JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -DLANG=en_US.UTF-8 -Djava.security.egd=file:/dev/./urandom -jar $JAR"]
# 不带pinpoint-agent启动
# ENTRYPOINT [ "sh", "-c", "java $JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -DLANG=en_US.UTF-8 -Djava.security.egd=file:/dev/./urandom -jar $JAR"]
EOF

4.2编写应用docker-compose

脚本如下，复制粘贴至命令控制台可在/opt目录下，直接创建 demo-docker-compose.yml

tee /opt/demo-docker-compose.yml << \EOF
version: "3.1"services:demo:image: 'myharbor.com/demo:0.0.1-SNAPSHOT'container_name: demoports:- "18899:8080"environment:- JAVA_OPTS=-Dpinpoint.applicationName=demo -Dpinpoint.agentId=demo-108node
networks:devops:external:name: devops01
EOF

demo-docker-compose.yml 文件中的 pinpoint.applicationName 为pinpoint中展示的应用名、pinpoint.agentId 为节点名。

4.3应用测试

应用镜像构建

cd /opt
docker build --no-cache -f demo.dockerfile -t myharbor.com/demo:0.0.1-SNAPSHOT .

应用启动服务

cd /opt
docker-compose -f demo-docker-compose.yml up -d

观察 demo docker容器节点启动是否正常

docker logs -f --tail 1000 demo

当 demo 容器节点日志最前面有出现 pinpoint agent 日志，有打印 docker collector ip 等参数，表示当前 demo 应用已成功集成。

浏览器访问应用，再去 pinpoint web 中查看 demo 链路及日志情况。

至此，完成 jdk17 + pinpoint-agent 基础镜像制作，及与应用如何集成等所有步骤。

引用Reference

• CentOS8搭建nfs服务
• Kubernetes1.25.4版本安装
• kubeasz安装kubernetes1.25.5
• k8s一键安装redis单机版
• k8s一键安装mysql8单机版
• k8s部署springboot应用
• Docker安装及学习
• Docker制作springboot运行应用镜像
• Docker制作Java8环境镜像
• Docker安装Mysql5.7.31
• Docker安装Mysql8.1.0
• Elasticsearch单机版本安装
• Elasticsearch集群安装
• ELK安装
• Docker安装ELK
• zookeeper集群安装
• Nginx日志切割
• RabbitMQ集群安装
• Docker安装RabbitMQ单机版
• springboot集成prometheus+grafana
• windows11安装android应用
• Windows下多个JDK版本快速切换
• MongoDB主从仲裁模式安装
• 制作jdk17+pinpoint-agent基础镜像