it.dockins.dockerslaves.api

Class OneShotSlave

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.Node

hudson.model.Slave

it.dockins.dockerslaves.api.OneShotSlave

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<hudson.model.Node>, hudson.model.ModelObject, hudson.model.ReconfigurableDescribable<hudson.model.Node>, hudson.model.Saveable, hudson.search.SearchableModelObject, hudson.search.SearchItem, hudson.security.AccessControlled, hudson.slaves.EphemeralNode, Serializable, jenkins.util.io.OnMaster

Direct Known Subclasses:

DockerSlave

public abstract class OneShotSlave
extends hudson.model.Slave
implements hudson.slaves.EphemeralNode

A slave that is designed to be used only once, for a specific $Run, and as such has a life cycle to fully match the Run's one.

Provisioning such a slave should be a lightweight process, so one can provision them at any time and concurrently to match $Queue load. Typical usage is Docker container based Jenkins agents.

Actual launch of the Slave is postponed until a $Run is created, so we can have a 1:1 match between Run and Executor lifecycle:

• dump the launch log in build log.
• mark the build as $Result.NOT_BUILT on launch failure.
• shut down and remove the Executor on build completion

See Also:

Serialized Form

Nested Class Summary

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

hudson.model.Slave.JnlpJar, hudson.model.Slave.SlaveDescriptor

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

hudson.model.Node.InternalComputerListener, hudson.model.Node.Mode

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
static hudson.model.listeners.RunListener	RUN_LISTENER We listen to loggers creation by $Runs so we can write the executor's launch log into build log.

Fields inherited from class hudson.model.Slave

name, remoteFS

Fields inherited from class hudson.model.Node

holdOffLaunchUntilSave

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor and Description
OneShotSlave(String name, String nodeDescription, String remoteFS, String labelString, hudson.slaves.ComputerLauncher launcher)

Method Summary

Modifier and Type	Method and Description
hudson.Launcher	createLauncher(hudson.model.TaskListener listener) Pipeline does not use the same mecanism to use nodes, so we also need to consider $createLauncher(TaskListener) as an event to determine first use of the slave.
OneShotComputer	getComputer()
int	getNumExecutors()

Methods inherited from class hudson.model.Slave

createComputer, equals, getClockDifferenceCallable, getDescriptor, getLabelString, getLauncher, getMode, getNodeDescription, getNodeName, getNodeProperties, getRemoteFS, getRetentionStrategy, getRootPath, getUserId, getWorkspaceFor, getWorkspaceRoot, hashCode, readResolve, setLabelString, setLauncher, setMode, setNodeName, setRetentionStrategy, setUserId, toString

Methods inherited from class hudson.model.Node

canTake, canTake, checkPermission, createPath, getACL, getAssignedLabels, getChannel, getClockDifference, getDisplayName, getFileSystemProvisioner, getLabelCloud, getNodePropertyDescriptors, getSearchUrl, getSelfLabel, hasPermission, isAcceptingTasks, isHoldOffLaunchUntilSave, reconfigure, save, toComputer

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, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface hudson.slaves.EphemeralNode

asNode

Field Detail

RUN_LISTENER

@Extension(ordinal=1.7976931348623157E308)
public static final hudson.model.listeners.RunListener RUN_LISTENER

We listen to loggers creation by $Runs so we can write the executor's launch log into build log. Relying on this implementation detail is fragile, but we don't really have a better option yet.

Constructor Detail

OneShotSlave

public OneShotSlave(String name,
                    String nodeDescription,
                    String remoteFS,
                    String labelString,
                    hudson.slaves.ComputerLauncher launcher)
             throws hudson.model.Descriptor.FormException,
                    IOException

Throws:

hudson.model.Descriptor.FormException

IOException

Method Detail

getNumExecutors

public int getNumExecutors()

Overrides:

getNumExecutors in class hudson.model.Slave

getComputer

public OneShotComputer getComputer()

Overrides:

getComputer in class hudson.model.Slave

createLauncher

public hudson.Launcher createLauncher(hudson.model.TaskListener listener)

Pipeline does not use the same mecanism to use nodes, so we also need to consider $createLauncher(TaskListener) as an event to determine first use of the slave.

Overrides:

createLauncher in class hudson.model.Slave