基于docker和jenkins的java覆盖率工具jacoco配置

jacoco是常用的一个开源覆盖率工具，目前使用比较广泛，这段时间工作中也引入了覆盖率统计，这段时间也踩了不少坑，所以有必要记录下。

一　工具清单

(1) maven

(2) docker

(3) jenkins 工具，使用pipeline构建项目

(4) jacoco agent

(5) jacoco 的maven插件

(6) 测试相关工具(testng等）

二 搭建过程记录

1 安装jenkins的jacoco插件
在jenkins的系统管理中，点击manage plugins，进入到插件管理页面。在available下，搜索jacoco，然后进行安装。

安装完成后，按照提示重启jenkins。

2 在docker 镜像中加入java agnet的启动配置
编写dockerfile如下，

FROM base

ENV APP_NAME=appjava
ENV C_ENVIRONMENT="dev"
ENV JAVA_OPTS="-server"
ENV PROFILE=docker

COPY ./ENTRYPOINT.sh /data/ENTRYPOINT.sh
COPY ./jacocoagent.jar /tmp/jacocoagent.jar    #将本地javaagnet.jar加到镜像中。

#带java agnet参数运行java -jar命令，注意address要写0.0.0.0

ENTRYPOINT exec java -javaagent:/tmp/jacocoagent.jar=includes=*,output=tcpserver,port=6305,address=0.0.0.0 $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -Dspring.profiles.active=${
   PROFILE} -jar /data/${
   APP_NAME}.jar

COPY ./appbuild/target/${
   APP_NAME}.jar /data/${
   APP_NAME}.jar

#开放一个端口供客户端dump数据使用
EXPOSE 6305

3 构建docker容器
启动时，需要在docker run中加入端口映射（使用docker run的-P参数，如可将宿主机的6305端口映射至容器的6305端口）
启动容器后，使用telnet命令查看指定宿主机的Ip的端口是否打开，如果打开说明 java agent正常启动。
4 执行自动化或者手工测试
执行一些测试脚本或者手工测试，然后服务器端的java agent就会记录下测试的覆盖率数据。
5 使用maven的 jacoco插件dump覆盖率数据
在要进行构建的maven项目（可以是自动化测试所在的项目或者被测服务所在项目）加入jacoco的插件。在pom文件中加入下面的元素。

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.22.2</version>
            <configuration>
            </configuration>
        </plugin>

        <plugin>
            <groupId>org.jacoco