com.amazon.jenkins.ec2fleet

Class EC2FleetNodeComputer

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.Actionable

hudson.model.Computer

hudson.slaves.SlaveComputer

com.amazon.jenkins.ec2fleet.EC2FleetNodeComputer

All Implemented Interfaces:

hudson.model.ExecutorListener, hudson.model.ModelObject, hudson.search.SearchableModelObject, hudson.search.SearchItem, hudson.security.AccessControlled, jenkins.model.ModelObjectWithContextMenu

public class EC2FleetNodeComputer
extends hudson.slaves.SlaveComputer

See Also:

EC2FleetNode

Nested Class Summary

Nested classes/interfaces inherited from class hudson.model.Computer

hudson.model.Computer.DisplayExecutor, hudson.model.Computer.TerminationRequest

Nested classes/interfaces inherited from interface jenkins.model.ModelObjectWithContextMenu

jenkins.model.ModelObjectWithContextMenu.ContextMenu, jenkins.model.ModelObjectWithContextMenu.ContextMenuVisibility, jenkins.model.ModelObjectWithContextMenu.MenuItem

Field Summary

Fields inherited from class hudson.model.Computer

BUILD, CONFIGURE, CONNECT, CREATE, DELETE, DISCONNECT, EXTENDED_READ, nodeName, offlineCause, PERMISSIONS, statusChangeLock, threadPoolForRemoting, transientActions

Constructor Summary

Constructors

Constructor and Description
EC2FleetNodeComputer(hudson.model.Slave slave)

Method Summary

Modifier and Type	Method and Description
String	getDisplayName() Return label which will represent executor in "Build Executor Status" section of Jenkins UI.
EC2FleetNode	getNode()
void	taskCompleted(hudson.model.Executor executor, hudson.model.Queue.Task task, long durationMS) Will be called when task execution finished by slave, detailed documentation SlaveComputer.taskCompleted(Executor, Queue.Task, long)

Methods inherited from class hudson.slaves.SlaveComputer

_connect, disconnect, doDoDisconnect, doLaunchSlaveAgent, doSlaveAgentJnlp, getAbsoluteRemoteFs, getChannel, getChannelToMaster, getClassLoadingCount, getClassLoadingPrefetchCacheCount, getClassLoadingTime, getDefaultCharset, getIcon, getJnlpJars, getJnlpMac, getLauncher, getLogRecords, getOSDescription, getResourceLoadingCount, getResourceLoadingTime, getRetentionStrategy, getSlaveVersion, getSystemInfoExtensions, grabLauncher, isAcceptingTasks, isConnecting, isJnlpAgent, isLaunchSupported, isUnix, kill, openLogFile, setAcceptingTasks, setChannel, setChannel, setChannel, setNode, taskAccepted, taskCompletedWithProblems, tryReconnect

Methods inherited from class hudson.model.Computer

_doScript, addAction, buildEnvironment, checkPermission, cliConnect, cliDisconnect, cliOffline, cliOnline, connect, countBusy, countExecutors, countIdle, currentComputer, disconnect, doChangeOfflineCause, doConfigDotXml, doConfigSubmit, doDoDelete, doDumpExportTable, doProgressiveLog, doRssAll, doRssFailed, doScript, doScriptText, doToggleOffline, getACL, getActions, getApi, getBuilds, getCaption, getComputerPanelBoxs, getConnectTime, getDemandStartMilliseconds, getDisplayExecutors, getEnvironment, getEnvVars, getExecutors, getHeapDump, getHostName, getIconAltText, getIconClassName, getIdleStartMilliseconds, getLoadStatistics, getLog, getLogDir, getLogFile, getLogText, getMonitorData, getName, getNumExecutors, getOfflineCause, getOfflineCauseReason, getOneOffExecutors, getSearchUrl, getSystemProperties, getTerminatedBy, getThreadDump, getTiedJobs, getTimeline, getUrl, getWorkspaceList, hasPermission, interrupt, isAlive, isIdle, isManualLaunchAllowed, isOffline, isOnline, isPartiallyIdle, isTemporarilyOffline, launch, onRemoved, recordTermination, relocateOldLogs, resolveForCLI, setTemporarilyOffline, setTemporarilyOffline, updateByXml, waitUntilOffline, waitUntilOnline

Methods inherited from class hudson.model.Actionable

doContextMenu, getAction, getAction, getActions, getAllActions, getDynamic, replaceAction

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, getSearchName, makeSearchIndex, requirePOST, sendError, sendError, sendError, sendError, sendError

Methods inherited from class java.lang.Object

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

Constructor Detail

EC2FleetNodeComputer

public EC2FleetNodeComputer(hudson.model.Slave slave)

Method Detail

getNode

public EC2FleetNode getNode()

Overrides:

getNode in class hudson.slaves.SlaveComputer

getDisplayName

@Nonnull
public String getDisplayName()

Return label which will represent executor in "Build Executor Status" section of Jenkins UI. After reconfiguration actual EC2FleetNode could be removed before this, so name will be just predefined static.

Specified by:

getDisplayName in interface hudson.model.ModelObject

Overrides:

getDisplayName in class hudson.model.Computer

Returns:

node display name or if node is null predefined text about that

taskCompleted

public void taskCompleted(hudson.model.Executor executor,
                          hudson.model.Queue.Task task,
                          long durationMS)

Will be called when task execution finished by slave, detailed documentation SlaveComputer.taskCompleted(Executor, Queue.Task, long)

EC2 Fleet plugin overrides this method to detect jobs which were failed because of EC2 instance was terminated/stopped. It could be manual stop or because of Spot marked. In all cases as soon as job aborted because of broken connection and slave is offline it will try to resubmit aborted job back to the queue, so user doesn't need to do that manually and another slave could take it.

Implementation details

There is no official recommendation about way how to resubmit job according to https://issues.jenkins-ci.org/browse/JENKINS-49707 moreover some of Jenkins code says it impossible.

method checks Computer.getOfflineCause() for disconnect because of EC2 instance termination it returns result = {OfflineCause$ChannelTermination@13708} "Connection was broken: java.io.IOException: Unexpected termination of the channel\n\tat hudson.remoting.SynchronousCommandTransport$ReaderThread... cause = {IOException@13721} "java.io.IOException: Unexpected termination of the channel" timestamp = 1561067177837

Specified by:

taskCompleted in interface hudson.model.ExecutorListener

Overrides:

taskCompleted in class hudson.slaves.SlaveComputer

Parameters:

executor - executor

task - task

durationMS - duration