ictu/jacoco-agent-docker

jacoco-agent-docker

镜像概述

jacoco-agent-docker是一个包含Jacoco Java代理的Docker镜像，主要用作卷容器，将Jacoco代理文件通过卷共享给其他Java应用服务，以便进行代码覆盖率分析。Jacoco相关文件位于容器内的/jacoco目录，可通过卷挂载方式供其他服务访问。

核心功能与特性

• 提供Jacoco Java代理（jacocoagent.jar），无需在应用镜像中单独安装
• 作为卷容器使用，通过Docker卷共享Jacoco文件，简化集成流程
• 支持多种Java应用服务器（如JBoss Wildfly、Payara等）
• 卷挂载方式灵活，适用于不同的Docker部署场景

使用场景与适用范围

适用于在Docker环境中运行的Java应用，需要进行代码覆盖率分析的场景。特别适合与JBoss Wildfly、Payara等Java应用服务器配合使用，通过挂载卷的方式快速集成Jacoco代理，收集应用代码执行覆盖率数据。

使用方法与配置说明

Docker Compose示例

JBoss Wildfly示例

yaml
version: '3.8'
services:
  jacoco:
    image: ictu/jacoco-agent-docker:0.8.8
    volumes:
       - jacoco:/jacoco:ro
  www:
    environment:
      JAVA_TOOL_OPTIONS: -javaagent:/jacoco/lib/jacocoagent.jar=excludes=*_javassit_*:javax.xml.soap.*:oasis.*,output=tcpserver,address=*
    image: jboss/wildfly
    volumes:
       - jacoco:/jacoco:ro
volumes:
  jacoco:

说明：

• jacoco服务：使用ictu/jacoco-agent-docker:0.8.8镜像，创建名为jacoco的卷并挂载/jacoco目录（只读）。
• www服务：使用JBoss Wildfly镜像，通过JAVA_TOOL_OPTIONS环境变量配置Jacoco代理，挂载jacoco卷以访问代理文件。
• Jacoco代理参数：excludes指定排除的类，output=tcpserver设置输出方式为TCP服务器，address=*监听所有网络地址。

Payara Server Full示例

yaml
version: '3.8'
services:
  jacoco:
    image: ictu/jacoco-agent-docker:0.8.8
    volumes:
      - jacoco:/jacoco:ro
  www:
    environment:
      JVM_ARGS: -javaagent:/jacoco/lib/jacocoagent.jar=excludes=*_javassit_*:javax.xml.soap.*:oasis.*,output=tcpserver,address=*
    image: payara/server-full:5.2020.6-jdk11
    ports:
      - "8080:8080"
      - "4848:4848"
    volumes:
      - jacoco:/jacoco:ro
volumes:
  jacoco:

说明：

• 与JBoss示例类似，但Payara使用JVM_ARGS环境变量配置Jacoco代理。
• 映射8080（应用端口）和4848（管理端口）到宿主机，方便访问应用和管理控制台。

从Dockerfile构建的Payara Server Full示例

yaml
version: '3.8'
services:
  jacoco:
    image: ictu/jacoco-agent-docker:0.8.8
    volumes:
      - jacoco:/jacoco:ro
  www:
    environment:
      JVM_ARGS: -javaagent:/jacoco/lib/jacocoagent.jar=excludes=*_javassit_*:javax.xml.soap.*:oasis.*,output=tcpserver,address=*
    build: .
    ports:
      - "8080:8080"
      - "4848:4848"
    volumes:
      - jacoco:/jacoco:ro
volumes:
  jacoco:

说明：

• www服务通过当前目录的Dockerfile构建（build: .），其他配置与直接使用Payara镜像的示例一致。
• 适用于需要自定义构建应用镜像的场景，仍可通过卷挂载方式集成Jacoco代理。

配置参数说明

Jacoco代理主要配置参数（通过-javaagent选项传递）：

• excludes：指定排除覆盖率分析的类，多个类用冒号分隔（如*_javassit_*:javax.xml.soap.*）
• output：输出方式，tcpserver表示以TCP服务器模式运行，允许外部工具连接获取数据
• address：监听地址，*表示监听所有网络接口，允许外部访问