hudson.remoting

Class Engine

java.lang.Object

java.lang.Thread

hudson.remoting.Engine

All Implemented Interfaces:

Runnable

@NotThreadSafe
public class Engine
extends Thread

Slave agent engine that proactively connects to Jenkins master.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
boolean	failIfWorkDirIsMissing Fail the initialization if the workDir or internalDir are missing.
String	internalDir Specifies a directory within workDir, which stores all the remoting-internal files.
EngineListener	listener Deprecated. Use events.
String	slaveName
Path	workDir Specifies a default working directory of the remoting instance.

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
Engine(EngineListener listener, List<URL> hudsonUrls, String secretKey, String slaveName)

Method Summary

Modifier and Type	Method and Description
void	addCandidateCertificate(X509Certificate certificate)
void	addListener(EngineListener el)
static Engine	current() When invoked from within remoted Callable (that is, from the thread that carries out the remote requests), this method returns the Engine in which the remote operations run.
URL	getHudsonUrl() Provides Jenkins URL if available.
boolean	isKeepAlive() Returns true if and only if the socket to the master will have Socket.setKeepAlive(boolean) set.
void	removeListener(EngineListener el)
void	run()
void	setAgentLog(Path agentLog) Sets the destination for agent logs.
void	setCandidateCertificates(List<X509Certificate> candidateCertificates)
void	setCredentials(String creds)
void	setFailIfWorkDirIsMissing(boolean failIfWorkDirIsMissing) Sets up behavior if the workDir or internalDir are missing during the startup.
void	setInternalDir(String internalDir) Specifies name of the internal data directory within workDir.
void	setJarCache(JarCache jarCache) Configures custom JAR Cache location.
void	setKeepAlive(boolean keepAlive) Sets the Socket.setKeepAlive(boolean) to use for the connection to the master.
void	setLoggingConfigFile(Path filePath) Sets path to the property file with JUL settings.
void	setNoReconnect(boolean noReconnect)
void	setProxyCredentials(String proxyCredentials)
void	setTunnel(String tunnel)
void	setWorkDir(Path workDir) Specified a path to the work directory.
void	startEngine() Starts the engine.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

listener

@Deprecated
public final EngineListener listener

Deprecated. Use events.

slaveName

public final String slaveName

workDir

@CheckForNull
public Path workDir

Specifies a default working directory of the remoting instance. If specified, this directory will be used to store logs, JAR cache, etc.

In order to retain compatibility, the option is disabled by default.

Jenkins specifics: This working directory is expected to be equal to the agent root specified in Jenkins configuration.

Since:

3.8

internalDir

@Nonnull
public String internalDir

Specifies a directory within workDir, which stores all the remoting-internal files.

This option is not expected to be used frequently, but it allows remoting users to specify a custom storage directory if the default remoting directory is consumed by other stuff.

Since:

3.8

failIfWorkDirIsMissing

@Nonnull
public boolean failIfWorkDirIsMissing

Fail the initialization if the workDir or internalDir are missing. This option presumes that the workspace structure gets initialized previously in order to ensure that we do not start up with a borked instance (e.g. if a filesystem mount gets disconnected).

Since:

3.8

Constructor Detail

Engine

public Engine(EngineListener listener,
              List<URL> hudsonUrls,
              String secretKey,
              String slaveName)

Method Detail

startEngine

public void startEngine()
                 throws IOException

Starts the engine. The procedure initializes the working directory and all the required environment

Throws:

IOException - Initialization error

Since:

3.9

setJarCache

public void setJarCache(@Nonnull
                        JarCache jarCache)

Configures custom JAR Cache location. Starting from TODO, this option disables JAR Caching in the working directory.

Parameters:

jarCache - JAR Cache to be used

Since:

2.24

setLoggingConfigFile

public void setLoggingConfigFile(@Nonnull
                                 Path filePath)

Sets path to the property file with JUL settings.

Parameters:

filePath - JAR Cache to be used

Since:

3.8

getHudsonUrl

@CheckForNull
public URL getHudsonUrl()

Provides Jenkins URL if available.

Returns:

Jenkins URL. May return null if the connection is not established or if the URL cannot be determined in the JnlpAgentEndpointResolver.

setTunnel

public void setTunnel(String tunnel)

setCredentials

public void setCredentials(String creds)

setProxyCredentials

public void setProxyCredentials(String proxyCredentials)

setNoReconnect

public void setNoReconnect(boolean noReconnect)

setAgentLog

public void setAgentLog(@CheckForNull
                        Path agentLog)

Sets the destination for agent logs.

Parameters:

agentLog - Path to the agent log. If null, the engine will pick the default behavior depending on the workDir value

Since:

3.8

setWorkDir

public void setWorkDir(@CheckForNull
                       Path workDir)

Specified a path to the work directory.

Parameters:

workDir - Path to the working directory of the remoting instance. null Disables the working directory.

Since:

3.8

setInternalDir

public void setInternalDir(@Nonnull
                           String internalDir)

Specifies name of the internal data directory within workDir.

Parameters:

internalDir - Directory name

Since:

3.8

setFailIfWorkDirIsMissing

public void setFailIfWorkDirIsMissing(boolean failIfWorkDirIsMissing)

Sets up behavior if the workDir or internalDir are missing during the startup. This option presumes that the workspace structure gets initialized previously in order to ensure that we do not start up with a borked instance (e.g. if a filesystem mount gets disconnected).

Parameters:

failIfWorkDirIsMissing - Flag

Since:

3.8

isKeepAlive

public boolean isKeepAlive()

Returns true if and only if the socket to the master will have Socket.setKeepAlive(boolean) set.

Returns:

true if and only if the socket to the master will have Socket.setKeepAlive(boolean) set.

setKeepAlive

public void setKeepAlive(boolean keepAlive)

Sets the Socket.setKeepAlive(boolean) to use for the connection to the master.

Parameters:

keepAlive - the Socket.setKeepAlive(boolean) to use for the connection to the master.

setCandidateCertificates

public void setCandidateCertificates(List<X509Certificate> candidateCertificates)

addCandidateCertificate

public void addCandidateCertificate(X509Certificate certificate)

addListener

public void addListener(EngineListener el)

removeListener

public void removeListener(EngineListener el)

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

current

public static Engine current()

When invoked from within remoted Callable (that is, from the thread that carries out the remote requests), this method returns the Engine in which the remote operations run.