hudson.slaves

Class JNLPLauncher

java.lang.Object

hudson.model.AbstractDescribableImpl<ComputerLauncher>

hudson.slaves.ComputerLauncher

hudson.slaves.JNLPLauncher

All Implemented Interfaces:

ExtensionPoint, Describable<ComputerLauncher>

public class JNLPLauncher
extends ComputerLauncher

ComputerLauncher via inbound connections.

Author:

Stephen Connolly, Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JNLPLauncher.DescriptorImpl
static class	JNLPLauncher.DescriptorVisibilityFilterImpl Hides the JNLP launcher when the JNLP agent port is not enabled.

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
static Descriptor<ComputerLauncher>	DESCRIPTOR Deprecated. as of 1.XXX Use Jenkins.getDescriptor(Class)
String	tunnel If the agent needs to tunnel the connection to the master, specify the "host:port" here.
String	vmargs Additional JVM arguments.

Fields inherited from class hudson.slaves.ComputerLauncher

LIST

Constructor Summary

Constructors

Constructor and Description
JNLPLauncher() Deprecated. This Launcher does not enable the work directory. It is recommended to use JNLPLauncher(boolean)
JNLPLauncher(boolean enableWorkDir) Constructor with default options.
JNLPLauncher(String tunnel, String vmargs)
JNLPLauncher(String tunnel, String vmargs, RemotingWorkDirSettings workDirSettings) Deprecated.

Method Summary

Modifier and Type	Method and Description
String	getWorkDirOptions(Computer computer) Gets work directory options as a String.
RemotingWorkDirSettings	getWorkDirSettings() Returns work directory settings.
boolean	isJavaWebStartSupported() Returns true if Java Web Start button should be displayed.
boolean	isLaunchSupported() Returns true if this ComputerLauncher supports programmatic launch of the agent in the target Computer.
void	launch(SlaveComputer computer, TaskListener listener) Launches the agent for the given Computer.
protected Object	readResolve()
void	setWorkDirSettings(RemotingWorkDirSettings workDirSettings)

Methods inherited from class hudson.slaves.ComputerLauncher

afterDisconnect, afterDisconnect, beforeDisconnect, beforeDisconnect, checkJavaVersion, launch

Methods inherited from class hudson.model.AbstractDescribableImpl

getDescriptor

Methods inherited from class java.lang.Object

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

Field Detail

tunnel

@CheckForNull
public final String tunnel

If the agent needs to tunnel the connection to the master, specify the "host:port" here. This can include the special syntax "host:" and ":port" to indicate the default host/port shall be used.

Null if no tunneling is necessary.

Since:

1.250

vmargs

@CheckForNull
public final String vmargs

Additional JVM arguments. Can be null.

Since:

1.297

DESCRIPTOR

@Deprecated
public static Descriptor<ComputerLauncher> DESCRIPTOR

Deprecated. as of 1.XXX Use Jenkins.getDescriptor(Class)

Constructor Detail

JNLPLauncher

@Deprecated
public JNLPLauncher(@CheckForNull
                                String tunnel,
                                @CheckForNull
                                String vmargs,
                                @CheckForNull
                                RemotingWorkDirSettings workDirSettings)

Deprecated.

Constructor.

Parameters:

tunnel - Tunnel settings

vmargs - JVM arguments

workDirSettings - Settings for Work Directory management in Remoting. If null, RemotingWorkDirSettings.getEnabledDefaults() will be used to enable work directories by default in new agents.

Since:

2.68

JNLPLauncher

@DataBoundConstructor
public JNLPLauncher(@CheckForNull
                                          String tunnel,
                                          @CheckForNull
                                          String vmargs)

JNLPLauncher

@Deprecated
public JNLPLauncher()

Deprecated. This Launcher does not enable the work directory. It is recommended to use JNLPLauncher(boolean)

JNLPLauncher

public JNLPLauncher(boolean enableWorkDir)

Constructor with default options.

Parameters:

enableWorkDir - If true, the work directory will be enabled with default settings.

Method Detail

readResolve

protected Object readResolve()

getWorkDirSettings

@Nonnull
public RemotingWorkDirSettings getWorkDirSettings()

Returns work directory settings.

Since:

2.72

setWorkDirSettings

@DataBoundSetter
public final void setWorkDirSettings(@Nonnull
                                                      RemotingWorkDirSettings workDirSettings)

isLaunchSupported

public boolean isLaunchSupported()

Description copied from class: ComputerLauncher

Returns true if this ComputerLauncher supports programmatic launch of the agent in the target Computer.

Overrides:

isLaunchSupported in class ComputerLauncher

launch

public void launch(SlaveComputer computer,
                   TaskListener listener)

Description copied from class: ComputerLauncher

Launches the agent for the given Computer.

If the agent is launched successfully, SlaveComputer.setChannel(InputStream, OutputStream, TaskListener, Channel.Listener) should be invoked in the end to notify Hudson of the established connection. The operation could also fail, in which case there's no need to make any callback notification, (except to notify the user of the failure through StreamTaskListener.) Also note that the normal return of this method call does not necessarily signify a successful launch. If someone programmatically calls this method and wants to find out if the launch was a success, use Computer.isOnline() at the end.

This method must operate synchronously. Asynchrony is provided by Computer.connect(boolean) and its correct operation depends on this.

Overrides:

launch in class ComputerLauncher

listener - The progress of the launch, as well as any error, should be sent to this listener.

getWorkDirOptions

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public String getWorkDirOptions(@Nonnull
                                                                                                                 Computer computer)

Gets work directory options as a String. In public API getWorkDirSettings().toCommandLineArgs(computer) should be used instead

Parameters:

computer - Computer

Returns:

Command line options for launching with the WorkDir

isJavaWebStartSupported

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public boolean isJavaWebStartSupported()

Returns true if Java Web Start button should be displayed. Java Web Start is only supported when the Jenkins server is running with Java 8. Earlier Java versions are not supported by Jenkins. Later Java versions do not support Java Web Start. This flag is checked in config.jelly before displaying the Java Web Start button.

Returns:

true if Java Web Start button should be displayed.

Since:

FIXME