64

I wanted to show the user who triggered a Jenkins job in the post job email. This is possible by using the plugin Build User Vars Plugin and the env variable BUILD_USER. But this variable do not get initialized when the job is triggered by a scheduler.

How can we achieve this? I know we have a plugin called - EnvInject Plugin, and that can be used...

But I just want to know how we can use this and achieve the solution...

18 Answers 18

60

SIMPLE SOLUTIONS (NO PLUGINS) !!

METHOD 1: Via Shell

BUILD_TRIGGER_BY=$(curl -k --silent ${BUILD_URL}/api/xml | tr '<' '\n' | egrep '^userId>|^userName>' | sed 's/.*>//g' | sed -e '1s/$/ \//g' | tr '\n' ' ') echo "${BUILD_TRIGGER_BY}" 

METHOD 2: Via Groovy

node('master') { BUILD_TRIGGER_BY = sh ( script: "BUILD_BY=\$(curl -k --silent ${BUILD_URL}/api/xml | tr '<' '\n' | egrep '^userId>|^userName>' | sed 's/.*>//g' | sed -e '1s/\$/ \\/ /g'); if [[ -z \${BUILD_BY} ]]; then BUILD_BY=\$(curl -k --silent ${BUILD_URL}/api/xml | tr '<' '\n' | grep '^shortDescription>' | sed 's/.*user //g;s/.*by //g'); fi; echo \${BUILD_BY}", returnStdout: true ).trim() echo "${BUILD_TRIGGER_BY}" } 

METHOD 3: Via Groovy (Recommended this method for security reasons)

BUILD_TRIGGER_BY = currentBuild.getBuildCauses()[0].shortDescription + " / " + currentBuild.getBuildCauses()[0].userId echo "${BUILD_TRIGGER_BY}" 

OUTPUT:

Started by user Admin / [email protected] 

Note: Output will be both User ID and User Name

Sign up to request clarification or add additional context in comments.

5 Comments

For Method 3, the "${}" is optional for the first line if you are interested only in userid BUILD_TRIGGER_BY = currentBuild.getBuildCauses()[0].userId echo "BUILD_TRIGGER_BY: ${BUILD_TRIGGER_BY}"
Love this. However, it does not work for builds that were triggered from another pipeline. It is not hard to solve that though, you just need method 1 or 2 and parse upstreamUrl/upstreamBuild/api/xml to jump to the parent job and retry.
Method 1 and 2 require anonymous access to the server as the curl calls are unauthenticated. Prefer method 3 for security reasons.
Not sure what edits have happened over the years, but "OUTPUT" doesn't look like it matches any of the methods since it doesn't have a :. Probably should be BUILD_TRIGGER_BY: [email protected] ?
@theswine: You can also use the third method on the result of getUpstreamBuilds(). Example.
38

Build user vars plugin wasn't working for me so I did a quick-and-dirty hack:

BUILD_CAUSE_JSON=$(curl --silent ${BUILD_URL}/api/json | tr "{}" "\n" | grep "Started by") BUILD_USER_ID=$(echo $BUILD_CAUSE_JSON | tr "," "\n" | grep "userId" | awk -F\" '{print $4}') BUILD_USER_NAME=$(echo $BUILD_CAUSE_JSON | tr "," "\n" | grep "userName" | awk -F\" '{print $4}') 

14 Comments

that is actually the best answer if you can not use any plugins (like the "inject env" or "Build User Vars Plugin").
Getting information from the ${BUILD_URL}/ API /json API is very useful
this is not working for me even if I am executing this in script section
I would actually argue this is the better approach because plugins are thee biggest complicating factor to keeping Jenkins up to date in my experience as a Jenkins operator.
I needed the variables in groovy so based on this I came up with the following hack: BUILD_CAUSE_JSON = sh ( script: "curl --silent ${BUILD_URL}/api/json | tr '{}' '\n' | grep 'Started by'", returnStdout: true ).trim() echo "BUILD_CAUSE_JSON: ${BUILD_CAUSE_JSON}" BUILD_USER_ID=new groovy.json.JsonSlurper().parseText("{${BUILD_CAUSE_JSON}}").userId echo "BUILD_USER_ID: ${BUILD_USER_ID}"
|
28

This can be done using the Jenkins Build User Vars Plugin which exposes a set of environment variables, including the user who started the build. It gives environment variables like BUILD_USER_ID, EMAIL, etc.

When the build is triggered manually by a logged-in user, that user's userid is available in the BUILD_USER_ID environment variable.

However, this environment variable won't be replaced / initialized when the build is automatically triggered by a Jenkins timer / scheduler.

Attached a screenshot for detailsenter image description here

This can be resolved by injecting a condition to the Job by using Conditional Build Step Plugin / Run Condition Plugin,where in to each job we can add a condition to initialize the variable BUILD_USER_ID only when the build is caused or triggered by the Timer or scheduler, by setting a condition using the regular expression..

Comments

17

Without Plugin ->

def cause = currentBuild.getBuildCauses('hudson.model.Cause$UserIdCause') echo "userName: ${cause.userName}" 

2 Comments

Great, it worked for me with some change. This code gave me the name of the user, and in a list (or whatever it is called in groovy). What I needed though is the short username, which seems to be called user id. This worked for that (also needed to take the first element from the list): echo "userName: ${cause.userId[0]}" (I googled for "hudson.model.Cause UserIIdCause" and the first result javadoc.jenkins.io/hudson/model/Cause.UserIdCause.html helped me). Used this on Jenkins 2.263.1
Doesn't work if the build is triggered by a git commit.
12

Install 'Build User Vars Plugin' and use like below:- [ See https://plugins.jenkins.io/build-user-vars-plugin ]

enter image description here

Be sure to check mark the Set jenkins user build variables checkbox under Build Environment for your Jenkins job's configuration.

enter image description here

Comments

7

I found similar but really working on Jenkins 2.1.x and easy for my understanding way. And it works without any plugins.

if (currentBuild.getBuildCauses('hudson.model.Cause$UserIdCause')['userId']){ // Will be run only if someone user triggers build // Because in other cases this contructions returns null } 

You can use in this construction any classes described here. They will be returns maps with usable values.

2 Comments

Just FYI to anybody who might try this - in newer versions the getBuildCauses() will actually be an array so you might need to do currentBuild.getBuildCauses('hudson.model.Cause$UserIdCause')[0]['userId'] instead. +1 for the answer! :)
Also, look out for downstream jobs. We found UserIdCause to be null on downstream jobs so checked for UpstreamCause first and if found then checked build user of that build.
5

This gets the username who clicked "Build Now" in a Jenkins pipeline job.

@NonCPS def getBuildUser() { return currentBuild.rawBuild.getCause(Cause.UserIdCause).getUserId() } 

1 Comment

Two notes: 1. Required admin permission to allow that call. 2. I added a ? right before the last dot, in order to get null instead of an exception.
3

I'm using a combination of the 'Execute Shell' and 'Env Inject' plugin as follows:

  1. Create an 'Execute Shell' build step that uses shell parameter substitution to write default the value and echo that value into a file. Example highlighted in screen shot below.
  2. Use the 'Env Inject' file to read that file as properties to set.

Jenkins build steps to default variables

1 Comment

This option worked for me. This is a little annoying for me as I am passing the build variables to another job and when I try to trigger a parameterzied build on another job it doesn't work when I provide the same "vars" property file. I ended up saving the file as an artifact from the original job and retrieving from the other which would be more difficult to create a template.
3

The token $BUILD_CAUSE from the email-ext plugin is what you are looking for.

You can see the full content token reference when you click the ? just after the Attach build log combobox at the email content configuration.

Some tokens get added by plugins, but this one should be aviable by default.

Edit: As pointed out by bishop in the comments, when using the EnvInject plugin, the $BUILD_CAUSE token gets changed to behave differently.

5 Comments

$BUILD_CAUSE does not include the user.
For you that is. When I do start the build manually i see my name in the message. 'BUILD_CAUSE: Gestartet durch Benutzer Dominik Gebhart' Translated: Started by user Dominik Gebhart. When its started by a Poll triggered from postCommit hook or timer, and it builds on SCM changes, it contains 'Build wurde durch eine SCM-Änderung ausgelöst.'Translated: Build triggered by SCM changes'. Do you think the content of the variable was modified by another plugin?
Indeed. The email-ext plugin defines it as you say, but then the env-inject plugin overrides it. Please note this in your answer so I can flip my vote from -1 to +1! (Vote locked until post edit.)
Have also tested if $CAUSE gets overridden too?
Also, it should only override when you activate the EvnInject in your job, not just by having this Plugin installed.
3

How to return Username & UserId:

UserName: currentBuild.rawBuild.getCause(Cause.UserIdCause).getUserName()

UserId: currentBuild.rawBuild.getCause(Cause.UserIdCause).getUserId()

1 Comment

Gives error Scripts not permitted to use method org.jenkinsci.plugins.workflow.support.steps.build.RunWrapper getRawBuild.
2

I have written a groovy script to extract the started by which would correctly get the source, regardless if user, scm or timer (could add more). It would recursively navigate the build tree to get the "original" 'started by' cause https://github.com/Me-ion/jenkins_build_trigger_cause_extractor

Comments

1

Just to elaborate on Musaffir Lp's answer. The Conditional Build Step plugin now supports the Build Cause directly - it requires the Run Condition Plugin also.

If you wanted to detect when the build was started by a timer you can select a Run? value of Build Cause, with Build Cause of: TimerTrigger

enter image description here

This is a little simpler and more robust than using a regex. There are also other triggers you can detect, for example when the build was a result of Source Control Management commit, you can select: SCMTrigger.

Comments

1

This below is working for me.

Install "user build vars plugin"

Build Name = ${BUILD_NUMBER}_${TICKET}_${ENV,var="BUILD_USER_ID"} 

enter image description here

Comments

1

I created a function that return the Triggered Job Name:

String getTriggeredJob(CURRENT_BUILD) { if (CURRENT_BUILD.upstreamBuilds.size() > 0) { TRIGGERED_JOB = CURRENT_BUILD.upstreamBuilds[0].projectName if (!TRIGGERED_JOB.isEmpty()) { return TRIGGERED_JOB } } return "Self" } 

CURRENT_BUILD is env var currentBuild

Comments

1

I wanted to trigger build initiator info to one of my slack/flock group so I used following way to get build initiator email and name by writing in Declarative fashion .

I am just printing here, you can use to store in some environment variable or write in one file giving file path according to your own convenience..

pipeline { environment { BRANCH_NAME = "${env.BRANCH_NAME}" } agent any stages{ stage('Build-Initiator-Info'){ sh 'echo $(git show -s --pretty=%ae)' sh 'echo $(git show -s --pretty=%an)' } } } 

Comments

0

Get the current User name from the Jenkins pipeline script:

 wrap([$class: 'BuildUser']) { echo "BUILD_USER that started this Pipeline: ${BUILD_USER}" } 

Output: BUILD_USER that started this Pipeline: USERNAME

Is this helpful?

Comments

-1

For declarative pipeline syntax, here is a quick hack, base on @Kevin answer. For declarative pipeline you need to enclose them in a node, else you will get an error/ build failure

node { def BUILD_FULL = sh ( script: 'curl --silent '+buildURL+' | tr "{}" "\\n" | grep -Po \'"shortDescription":.*?[^\\\\]"\' | cut -d ":" -f2', returnStdout: true ) slackSend channel: '#ci-cd', color: '#000000', message: "The pipeline was ${BUILD_FULL} ${GIT_COMMIT_MSG} " } 

The output will be slack notification sent to your slack channel with the git short description

Comments

-1

There is other way to get user_id, where you don't need to install anything.

BUILD_USER_ID = sh ( script: 'id -u', returnStdout: true ).trim() echo "bUILD USER: ${BUILD_USER_ID }" 

Comments

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.