hudson.remoting.jnlp

Class Main

java.lang.Object

hudson.remoting.jnlp.Main

public class Main
extends Object

Entry point to JNLP agent.

See also jenkins-agent.jnlp.jelly in the core.

Author:

Kohsuke Kawaguchi

Field Summary

Fields

Modifier and Type	Field and Description
File	agentLog Specifies a destination for error logs.
List<String>	args Two mandatory parameters: secret key, and agent name.
List<String>	candidateCertificates
String	credentials
String	directConnection Connect directly to the TCP port specified, skipping the HTTP(S) connection parameter download.
boolean	disableHttpsCertValidation Disables HTTPs Certificate validation of the server when using JnlpAgentEndpointResolver.
boolean	failIfWorkDirIsMissing Fail the initialization if the workDir or internalDir are missing.
boolean	headlessMode
String	instanceIdentity The master's instance identity.
String	internalDir Specifies a directory within workDir, which stores all the remoting-internal files.
File	jarCache
File	loggingConfigFile Specified location of the property file with JUL settings.
boolean	noKeepAlive
boolean	noReconnect
List<String>	protocols When instanceIdentity is set, the agent skips connecting via http(s) where it normally obtains the configured protocols.
String	proxyCredentials
boolean	showHelp Shows help message and then exits
boolean	showVersion Shows version information and then exits
String	tunnel
List<URL>	urls
boolean	webSocket
Map<String,String>	webSocketHeaders
File	workDir Specifies a default working directory of the remoting instance.

Constructor Summary

Constructors

Constructor and Description
Main()

Method Summary

Modifier and Type	Method and Description
static void	_main(String[] args) Main without the argument handling.
Engine	createEngine()
void	main()
static void	main(String[] args)

Methods inherited from class java.lang.Object

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

Field Detail

tunnel

public String tunnel

headlessMode

public boolean headlessMode

urls

public List<URL> urls

webSocket

public boolean webSocket

webSocketHeaders

public Map<String,String> webSocketHeaders

credentials

public String credentials

proxyCredentials

public String proxyCredentials

noReconnect

public boolean noReconnect

noKeepAlive

public boolean noKeepAlive

candidateCertificates

public List<String> candidateCertificates

disableHttpsCertValidation

public boolean disableHttpsCertValidation

Disables HTTPs Certificate validation of the server when using JnlpAgentEndpointResolver. This option is not recommended for production use.

agentLog

@CheckForNull
public File agentLog

Specifies a destination for error logs. If specified, this option overrides the default destination within workDir. If both this options and workDir is not set, the log will not be generated.

Since:

3.8

loggingConfigFile

@CheckForNull
public File loggingConfigFile

Specified location of the property file with JUL settings.

Since:

3.8

workDir

@CheckForNull
public File 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

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

jarCache

public File jarCache

Since:

2.24

directConnection

public String directConnection

Connect directly to the TCP port specified, skipping the HTTP(S) connection parameter download.

Since:

3.34

instanceIdentity

public String instanceIdentity

The master's instance identity.

Since:

3.34

See Also:

Instance Identity

protocols

public List<String> protocols

When instanceIdentity is set, the agent skips connecting via http(s) where it normally obtains the configured protocols. When no protocols are given the agent tries all protocols it knows. Use this to limit the protocol list.

Since:

3.34

showHelp

public boolean showHelp

Shows help message and then exits

Since:

3.36

showVersion

public boolean showVersion

Shows version information and then exits

Since:

3.36

args

public List<String> args

Two mandatory parameters: secret key, and agent name.

Constructor Detail

Main

public Main()

Method Detail

main

public static void main(String[] args)
                 throws IOException,
                        InterruptedException

Throws:

IOException

InterruptedException

_main

public static void _main(String[] args)
                  throws IOException,
                         InterruptedException,
                         org.kohsuke.args4j.CmdLineException

Main without the argument handling.

Throws:

IOException

InterruptedException

org.kohsuke.args4j.CmdLineException

main

public void main()
          throws IOException,
                 InterruptedException

Throws:

IOException

InterruptedException

createEngine

public Engine createEngine()