Package io.jenkins.plugins.namespacecloud.launcher

Class InboundLaunchStrategy

java.lang.Object

hudson.model.AbstractDescribableImpl<AgentLaunchStrategy>

io.jenkins.plugins.namespacecloud.launcher.AgentLaunchStrategy

io.jenkins.plugins.namespacecloud.launcher.InboundLaunchStrategy

All Implemented Interfaces:

ExtensionPoint, Describable<AgentLaunchStrategy>

public class InboundLaunchStrategy
extends AgentLaunchStrategy

Runs the Jenkins inbound agent as a Namespace-managed container, which dials out to the controller over WebSocket.

Namespace-managed containers (those declared at creation time) are treated as critical: if the agent process exits, the instance fails as a whole, which makes a dead agent visible rather than leaving an idle VM burning budget.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	InboundLaunchStrategy.DescriptorImpl

Nested classes/interfaces inherited from class io.jenkins.plugins.namespacecloud.launcher.AgentLaunchStrategy

AgentLaunchStrategy.AgentLaunchStrategyDescriptor

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_IMAGE	Default agent image.

Constructor Summary

Constructors

Constructor	Description
InboundLaunchStrategy()

Method Summary

Modifier and Type	Method	Description
void	configureInstance(Compute.CreateInstanceRequest.Builder builder, LaunchContext ctx)	Contributes to the instance request before it is sent — typically the container that will host the agent, plus any credentials it needs.
ComputerLauncher	createLauncher(NamespaceClient client, Compute.InstanceMetadata instance, LaunchContext ctx)	Builds the Jenkins-side launcher.
String	getImage()
boolean	isExposeDockerSocket()
boolean	isWebSocket()
boolean	requiresNodeRegisteredFirst()	Whether the Jenkins node must be registered before the instance is created.
void	setExposeDockerSocket(boolean exposeDockerSocket)
void	setImage(String image)
void	setWebSocket(boolean webSocket)

Methods inherited from class io.jenkins.plugins.namespacecloud.launcher.AgentLaunchStrategy

getDescriptor, requiresSshGrants

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_IMAGE

public static final String DEFAULT_IMAGE

Default agent image. The JDK tag should track the controller's Java major version so remoting negotiates a matching protocol.

See Also:

• Constant Field Values

Constructor Details

InboundLaunchStrategy

@DataBoundConstructor
public InboundLaunchStrategy()

Method Details

getImage

public String getImage()

setImage

@DataBoundSetter
public void setImage(String image)

isWebSocket

public boolean isWebSocket()

setWebSocket

@DataBoundSetter
public void setWebSocket(boolean webSocket)

isExposeDockerSocket

public boolean isExposeDockerSocket()

setExposeDockerSocket

@DataBoundSetter
public void setExposeDockerSocket(boolean exposeDockerSocket)

requiresNodeRegisteredFirst

public boolean requiresNodeRegisteredFirst()

Description copied from class: AgentLaunchStrategy

Whether the Jenkins node must be registered before the instance is created. True for inbound: the agent connects on its own and the controller rejects a connection from a node it does not know about yet.

Overrides:

requiresNodeRegisteredFirst in class AgentLaunchStrategy

configureInstance

public void configureInstance(@NonNull
 Compute.CreateInstanceRequest.Builder builder,
 @NonNull
 LaunchContext ctx)

Description copied from class: AgentLaunchStrategy

Contributes to the instance request before it is sent — typically the container that will host the agent, plus any credentials it needs.

Specified by:

configureInstance in class AgentLaunchStrategy

createLauncher

@NonNull
public ComputerLauncher createLauncher(@NonNull
 NamespaceClient client,
 @NonNull
 Compute.InstanceMetadata instance,
 @NonNull
 LaunchContext ctx)

Description copied from class: AgentLaunchStrategy

Builds the Jenkins-side launcher. Called once the instance is RUNNING, so implementations may query the instance for connection details.

Specified by:

createLauncher in class AgentLaunchStrategy