java - 有什么方法可以以编程方式访问在从机上运行的 Jenkins 作业详细信息(例如作业名称、其他作业参数)？

Question

所以想法是获取在从机上运行的 Jenkins 作业详细信息并进一步使用它们。天真地，我在 eclipse 项目中添加了slave.jar，运行了 jenkins 作业并运行了下面的代码，但遗憾的是它不起作用并输出 NullPointerException。浏览了 Jenkins 文档，但没有可靠的帮助

import java.util.List;
import java.util.ListIterator;
import java.io.IOException;
import java.net.URL;
import hudson.remoting.jnlp.Main;

import org.jenkinsci.remoting.engine.WorkDirManager;
import org.jenkinsci.remoting.engine.WorkDirManager.DirType;


public class Sample {

    public static void main(String[] args) throws IOException {

        Main mainObj = new Main();

        List<URL> url = mainObj.urls;

        ListIterator<URL> iterator = url.listIterator();

        while(iterator.hasNext()) {
            System.out.println(iterator.next().getContent());
        }

        WorkDirManager mgr = WorkDirManager.getInstance();

        System.out.println(mgr.getLocationPath(DirType.WORK_DIR).toString());

    }

}

Answer 1

请考虑从 shell 环境中获取您需要的作业详细信息!

Jenkins 将有关作业的各种详细信息注入(inject)到环境中，可以从从属设备上运行的脚本/任务以编程方式访问这些详细信息。

在 Jenkins 服务器上，浏览到 /env-vars.html。在我的本地主机测试服务器上，路径是这样的:http://localhost:8080/env-vars.html/ .

这将为您提供可用于您的作业的环境变量列表。以下是完整列表:

BRANCH_NAME
For a multibranch project, this will be set to the name of the branch being built, for example in case you wish to deploy to production from master but not from feature branches; if corresponding to some kind of change request, the name is generally arbitrary (refer to CHANGE_ID and CHANGE_TARGET).
CHANGE_ID
For a multibranch project corresponding to some kind of change request, this will be set to the change ID, such as a pull request number, if supported; else unset.
CHANGE_URL
For a multibranch project corresponding to some kind of change request, this will be set to the change URL, if supported; else unset.
CHANGE_TITLE
For a multibranch project corresponding to some kind of change request, this will be set to the title of the change, if supported; else unset.
CHANGE_AUTHOR
For a multibranch project corresponding to some kind of change request, this will be set to the username of the author of the proposed change, if supported; else unset.
CHANGE_AUTHOR_DISPLAY_NAME
For a multibranch project corresponding to some kind of change request, this will be set to the human name of the author, if supported; else unset.
CHANGE_AUTHOR_EMAIL
For a multibranch project corresponding to some kind of change request, this will be set to the email address of the author, if supported; else unset.
CHANGE_TARGET
For a multibranch project corresponding to some kind of change request, this will be set to the target or base branch to which the change could be merged, if supported; else unset.
BUILD_NUMBER
The current build number, such as "153"
BUILD_ID
The current build ID, identical to BUILD_NUMBER for builds created in 1.597+, but a YYYY-MM-DD_hh-mm-ss timestamp for older builds
BUILD_DISPLAY_NAME
The display name of the current build, which is something like "#153" by default.
JOB_NAME
Name of the project of this build, such as "foo" or "foo/bar".
JOB_BASE_NAME
Short Name of the project of this build stripping off folder paths, such as "foo" for "bar/foo".
BUILD_TAG
String of "jenkins-${JOB_NAME}-${BUILD_NUMBER}". All forward slashes ("/") in the JOB_NAME are replaced with dashes ("-"). Convenient to put into a resource file, a jar file, etc for easier identification.
EXECUTOR_NUMBER
The unique number that identifies the current executor (among executors of the same machine) that’s carrying out this build. This is the number you see in the "build executor status", except that the number starts from 0, not 1.
NODE_NAME
Name of the agent if the build is on an agent, or "master" if run on master
NODE_LABELS
Whitespace-separated list of labels that the node is assigned.
WORKSPACE
The absolute path of the directory assigned to the build as a workspace.
JENKINS_HOME
The absolute path of the directory assigned on the master node for Jenkins to store data.
JENKINS_URL
Full URL of Jenkins, like http://server:port/jenkins/ (note: only available if Jenkins URL set in system configuration)
BUILD_URL
Full URL of this build, like http://server:port/jenkins/job/foo/15/ (Jenkins URL must be set)
JOB_URL
Full URL of this job, like http://server:port/jenkins/job/foo/ (Jenkins URL must be set)
GIT_COMMIT
The commit hash being checked out.
GIT_PREVIOUS_COMMIT
The hash of the commit last built on this branch, if any.
GIT_PREVIOUS_SUCCESSFUL_COMMIT
The hash of the commit last successfully built on this branch, if any.
GIT_BRANCH
The remote branch name, if any.
GIT_LOCAL_BRANCH
The local branch name being checked out, if applicable.
GIT_CHECKOUT_DIR
The directory that the repository will be checked out to. This contains the value set in Checkout to a sub-directory, if used.
GIT_URL
The remote URL. If there are multiple, will be GIT_URL_1, GIT_URL_2, etc.
GIT_COMMITTER_NAME
The configured Git committer name, if any, that will be used for FUTURE commits from the current workspace. It is read from the Global Config user.name Value field of the Jenkins Configure System page.
GIT_AUTHOR_NAME
The configured Git author name, if any, that will be used for FUTURE commits from the current workspace. It is read from the Global Config user.name Value field of the Jenkins Configure System page.
GIT_COMMITTER_EMAIL
The configured Git committer email, if any, that will be used for FUTURE commits from the current workspace. It is read from the Global Config user.email Value field of the Jenkins Configure System page.
GIT_AUTHOR_EMAIL
The configured Git author email, if any, that will be used for FUTURE commits from the current workspace. It is read from the Global Config user.email Value field of the Jenkins Configure System page.
MERCURIAL_REVISION
Full ID of revision checked out.
MERCURIAL_REVISION_SHORT
Abbreviated ID of revision checked out.
MERCURIAL_REVISION_NUMBER
Number of revision checked out (not portable across clones).
MERCURIAL_REVISION_BRANCH
Branch of revision checked out, if not checking out by branch head.
MERCURIAL_REPOSITORY_URL
URL of repository.
SVN_REVISION
Subversion revision number that's currently checked out to the workspace, such as "12345"
SVN_URL
Subversion URL that's currently checked out to the workspace.

因此，在 Java 代码中，您可以使用 System.getEnv(String name) 来获取所需的环境变量。

请告诉我们您的情况! :D