org.jenkinsci.plugins.githubautostatus

Class BuildStatusAction

java.lang.Object

hudson.model.InvisibleAction

org.jenkinsci.plugins.githubautostatus.BuildStatusAction

All Implemented Interfaces:

hudson.model.Action, hudson.model.ModelObject

public class BuildStatusAction
extends hudson.model.InvisibleAction

Keeps track of build status for each stage in a build, and provides mechanisms for notifying various subscribers as stages and jobs are completed.

Author:

Jeff Pearce (jxpearce@godaddy.com)

Constructor Summary

Constructors

Constructor and Description
BuildStatusAction(String jobName, String targetUrl, List<String> stageList) Construct a BuildStatusAction

Method Summary

Modifier and Type	Method and Description
void	addBuildStatus(String stageName) Sends pending notifications for the start of a stage
void	addGithubNofifier(GithubNotificationConfig config) Attempts to add a github notifier
void	addInfluxDbNotifier(InfluxDbNotifierConfig influxDbNotifierConfig) Attempts to add an influx db notifier
void	close() Cleans up by sending "complete" status to any steps that are currently pending.
boolean	isIsDeclarativePipeline() Sets flag indicating whether notifications are for a declarative pipeline
void	sendNonStageError(String nodeName) Sends notifications for an error that happens outside of a stage
void	sendNotications(BuildNotifier notifier) Sends all saved notifications to a notifier
void	setIsDeclarativePipeline(boolean isDeclarativePipeline)
void	updateBuildStatusForJob(BuildState buildState, long buildDuration, long blockedDuration) Sends notifications for final build status
void	updateBuildStatusForStage(String nodeName, BuildState buildState) Sends notifications for a completed stage
void	updateBuildStatusForStage(String nodeName, BuildState buildState, long time) Sends notifications for a completed stage

Methods inherited from class hudson.model.InvisibleAction

getDisplayName, getIconFileName, getUrlName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BuildStatusAction

public BuildStatusAction(String jobName,
                         String targetUrl,
                         List<String> stageList)
                  throws IOException

Construct a BuildStatusAction

Parameters:

jobName - the name of the job status is for

targetUrl - link back to Jenkins

stageList - list of stages if known

Throws:

IOException

Method Detail

close

public void close()

Cleans up by sending "complete" status to any steps that are currently pending. Needed because some complex jobs, particularly using down

isIsDeclarativePipeline

public boolean isIsDeclarativePipeline()

Sets flag indicating whether notifications are for a declarative pipeline

Returns:

setIsDeclarativePipeline

public void setIsDeclarativePipeline(boolean isDeclarativePipeline)

addGithubNofifier

public void addGithubNofifier(GithubNotificationConfig config)

Attempts to add a github notifier

Parameters:

config - github notifier config

addInfluxDbNotifier

public void addInfluxDbNotifier(InfluxDbNotifierConfig influxDbNotifierConfig)

Attempts to add an influx db notifier

Parameters:

influxDbNotifierConfig - influx db notifier config

sendNotications

public void sendNotications(BuildNotifier notifier)

Sends all saved notifications to a notifier

Parameters:

notifier - notifier to send to

addBuildStatus

public void addBuildStatus(String stageName)

Sends pending notifications for the start of a stage

Parameters:

stageName - stage name

updateBuildStatusForStage

public void updateBuildStatusForStage(String nodeName,
                                      BuildState buildState,
                                      long time)

Sends notifications for a completed stage

Parameters:

nodeName - node name

buildState - build state

time - stage time

updateBuildStatusForStage

public void updateBuildStatusForStage(String nodeName,
                                      BuildState buildState)

Sends notifications for a completed stage

Parameters:

nodeName - node name

buildState - build state

updateBuildStatusForJob

public void updateBuildStatusForJob(BuildState buildState,
                                    long buildDuration,
                                    long blockedDuration)

Sends notifications for final build status

Parameters:

buildState - final build state

buildDuration - build duration

blockedDuration - time build was blocked before running

sendNonStageError

public void sendNonStageError(String nodeName)

Sends notifications for an error that happens outside of a stage

Parameters:

nodeName - name of node