【Jenkins】远程API接口：Java 包装接口使用示例

jenkins-rest 库是一个面向对象的 Java 项目，它通过编程方式提供对 Jenkins REST API 的访问，以访问 Jenkins 提供的一些远程 API。它使用 jclouds 工具包构建，可以轻松扩展以支持更多 REST 端点。其功能集不断发展，用户可以通过拉取请求贡献新的端点。在当前状态下，使用此库可以提交作业、跟踪其通过队列的进度并监控其执行直到完成，并获取构建状态。目前提供的服务包括：

• 端点定义（属性或环境变量）
• 身份验证（通过属性或环境变量进行基本和 API 令牌）
• Crumbs Issuer 支持（自动检测 crumbs）
• 文件夹支持
• 作业 API（构建、构建信息、带参数构建、配置、创建、删除、描述、禁用、启用、作业信息、最后构建编号、最后构建时间戳和渐进文本）
• 插件管理器 API（安装必要的插件、列出当前插件）
• 队列 API（取消、列出队列项、查询队列项）
• 统计 API（总体负载）
• 系统 API（系统信息）

引入依赖jar包

在工程pom.xml文件中引入如下配置，classifier配置一定要加上：

<dependency>
    <groupId>io.github.cdancygroupId>
    <artifactId>jenkins-restartifactId>
    <version>1.0.2version>
    <classifier>allclassifier>
dependency>

注意，jenkins-rest 要求至少 jdk11，可以在这里查看

使用代码示例

假设Jenkins地址是 http://192.168.56.114:8080

1、初始化客户端链接

private static JenkinsClient client;
private static final String JENKINS_URL = "http://192.168.56.114:8080";

public static void init() {
    client = JenkinsClient.builder()
            .endPoint(JENKINS_URL) // Jenkins地址
            .credentials("admin:admin123") // 账号密码.
            .build();

    SystemInfo systemInfo = client.api().systemApi().systemInfo();
    log.info("jenkinsVersion: {}", systemInfo.jenkinsVersion());
}

2、查询任务列表

public static void jobs() {
    JobsApi jobsApi = client.api().jobsApi();
    JobList jobList = jobsApi.jobList("");
    jobList.jobs().forEach(job -> System.out.println(job.name()));
}

3、触发无参任务构建

返回的value不为null，代表执行成功

public static void build() {
    JobsApi jobsApi = client.api().jobsApi();
    // 必须是无参数任务
    String jobName = "job_no_params";
    IntegerResponse response = jobsApi.build("", jobName);
    System.out.println("build = " + response);
    // 返回的value不为null，代表执行成功
    if (response.value() != null) {
        System.out.println("任务执行成功：" + jobName);
    } else {
        System.out.println("任务执行失败：" + response.errors());
    }
}

4、触发有参任务构建

这里的任务必须是带参数的，如果调用的无参任务，会报错！

返回的value不为null，代表执行成功

public static void buildWithParameters() {
    JobsApi jobsApi = client.api().jobsApi();
    Map<String, List<String>> properties = new HashMap<>();
    properties.put("ENV", Collections.singletonList("prod"));
    // 必须是有参数任务
    String jobName = "job_with_params";
    IntegerResponse response = jobsApi.buildWithParameters("", jobName, properties);
    System.out.println("buildWithParameters = " + response);
    // 返回的value不为null，代表执行成功
    if (response.value() != null) {
        System.out.println("任务执行成功：" + jobName);
    } else {
        System.out.println("任务执行失败：" + response.errors());
    }
}

5、创建新任务

创任务必须传入xml配置数据

public static void createJob() {
    JobsApi jobsApi = client.api().jobsApi();
    String configXml = "\n" +
            "\n" +
            "  \n" +
            "    \n" +
            "    \n" +
            "      \n" +
            "      \n" +
            "      \n" +
            "      \n" +
            "    \n" +
            "  \n" +
            "  \n" +
            "  false\n" +
            "  \n" +
            "  \n" +
            "    \n" +
            "    true\n" +
            "  \n" +
            "  \n" +
            "  false\n" +
            "\n";
    String newJobName = "java_api_02";
    RequestStatus status = jobsApi.create("", newJobName, configXml);
    if (status.value()) {
        System.out.println("任务创建成功： " + newJobName);
    } else {
        System.out.println("任务创建失败： " + newJobName);
    }
}

6、删除任务

public static void delete() {
    JobsApi jobsApi = client.api().jobsApi();
    String jobName = "api05";
    RequestStatus status = jobsApi.delete("", jobName);
    System.out.println("delete = " + status);
    if (status.value()){
        System.out.println("任务删除成功： " + jobName);
    }else{
        System.out.println("任务删除失败： " + status.errors());
    }
}

7、禁用/启用任务

public static void disable() {
    JobsApi jobsApi = client.api().jobsApi();
    boolean flag = jobsApi.disable("", "api01");
    System.out.println("disable = " + flag);
}

public static void enable() {
    JobsApi jobsApi = client.api().jobsApi();
    boolean flag = jobsApi.enable("", "api01");
    System.out.println("enable = " + flag);
}

8、查询最近构建序号

public static void lastBuildNumber() {
    JobsApi jobsApi = client.api().jobsApi();
    String jobName = "job_no_params";
    Integer lastBuildNumber = jobsApi.lastBuildNumber("", jobName);
    System.out.println("lastBuildNumber = " + lastBuildNumber);
}

9、Jenkins服务负载情况查询

public static void overallLoad() {
    OverallLoad overallLoad = client.api().statisticsApi().overallLoad();
    System.out.println("overallLoad = " + overallLoad);
}

参考

• jenkins-rest