Package org.jvnet.hudson.test.junit.jupiter

Class InboundAgentExtension

java.lang.Object

org.jvnet.hudson.test.junit.jupiter.InboundAgentExtension

All Implemented Interfaces:

org.junit.jupiter.api.extension.AfterEachCallback, org.junit.jupiter.api.extension.Extension

public class InboundAgentExtension
extends Object
implements org.junit.jupiter.api.extension.AfterEachCallback

This is the JUnit Jupiter implementation of InboundAgentFixture. Usage:

 @RegisterExtension
 private final InboundAgentRule inboundAgent = InboundAgentExtension.newBuilder().build();
 

See Also:

• InboundAgentFixture
• JenkinsRule.createComputerLauncher(hudson.EnvVars)
• JenkinsRule.createSlave()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	InboundAgentExtension.AgentArguments
static final class	InboundAgentExtension.Options	The options used to (re)start an inbound agent.

Constructor Summary

Constructors

Constructor	Description
InboundAgentExtension()

Method Summary

Modifier and Type	Method	Description
void	afterEach(org.junit.jupiter.api.extension.ExtensionContext context)
hudson.model.Slave	createAgent(JenkinsRule r, String name)	Creates, attaches, and starts a new inbound agent.
hudson.model.Slave	createAgent(JenkinsRule r, InboundAgentExtension.Options options)	Creates, attaches, and optionally starts a new inbound agent.
void	createAgent(RealJenkinsExtension extension, String name)
void	createAgent(RealJenkinsExtension extension, InboundAgentExtension.Options options)
static String[]	createAgentRJR(JenkinsRule r, InboundAgentExtension.Options options)
static InboundAgentExtension.AgentArguments	getAgentArguments(JenkinsRule r, String name)
boolean	isAlive(String name)	Checks whether an existing inbound agent process is currently running.
void	start(JenkinsRule r, String name)	(Re-)starts an existing inbound agent.
void	start(JenkinsRule r, InboundAgentExtension.Options options)	(Re-)starts an existing inbound agent.
void	start(InboundAgentExtension.AgentArguments agentArguments, InboundAgentExtension.Options options)
void	start(InboundAgentExtension.AgentArguments agentArguments, InboundAgentExtension.Options options, boolean stop)
void	start(RealJenkinsExtension r, InboundAgentExtension.Options options)	(Re-)starts an existing inbound agent.
void	startOnly(RealJenkinsExtension extension, InboundAgentExtension.Options options)	Starts an existing inbound agent without waiting for it to go online.
void	stop(String name)	Stops an existing inbound agent.
void	stop(JenkinsRule r, String name)	Stop an existing inbound agent and wait for it to go offline.
void	stop(RealJenkinsExtension rjr, String name)	Stop an existing inbound agent and wait for it to go offline.
static void	waitForAgentOffline(JenkinsRule r, String name)
static void	waitForAgentOnline(JenkinsRule r, String name, Map<String,Level> loggers)

Methods inherited from class java.lang.Object

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

Constructor Details

InboundAgentExtension

public InboundAgentExtension()

Method Details

createAgent

public hudson.model.Slave createAgent(@NonNull
 JenkinsRule r,
 @CheckForNull
 String name)
                               throws Exception

Creates, attaches, and starts a new inbound agent.

Parameters:

name - an optional Slave.getNodeName()

Throws:

Exception

createAgent

public hudson.model.Slave createAgent(@NonNull
 JenkinsRule r,
 InboundAgentExtension.Options options)
                               throws Exception

Creates, attaches, and optionally starts a new inbound agent.

Parameters:

options - the options

Throws:

Exception

createAgent

public void createAgent(@NonNull
 RealJenkinsExtension extension,
 @CheckForNull
 String name)
                 throws Throwable

Throws:

Throwable

createAgent

public void createAgent(@NonNull
 RealJenkinsExtension extension,
 InboundAgentExtension.Options options)
                 throws Throwable

Throws:

Throwable

start

public void start(@NonNull
 JenkinsRule r,
 @NonNull
 String name)
           throws Exception

(Re-)starts an existing inbound agent.

Throws:

Exception

start

public void start(@NonNull
 JenkinsRule r,
 InboundAgentExtension.Options options)
           throws Exception

(Re-)starts an existing inbound agent.

Throws:

Exception

start

public void start(@NonNull
 RealJenkinsExtension r,
 InboundAgentExtension.Options options)
           throws Throwable

(Re-)starts an existing inbound agent.

Throws:

Throwable

start

public void start(InboundAgentExtension.AgentArguments agentArguments,
 InboundAgentExtension.Options options)
           throws Exception

Throws:

Exception

start

public void start(InboundAgentExtension.AgentArguments agentArguments,
 InboundAgentExtension.Options options,
 boolean stop)
           throws IOException

Throws:

IOException

startOnly

public void startOnly(@NonNull
 RealJenkinsExtension extension,
 InboundAgentExtension.Options options)
               throws Throwable

Starts an existing inbound agent without waiting for it to go online.

Throws:

Throwable

stop

public void stop(@NonNull
 JenkinsRule r,
 @NonNull
 String name)
          throws InterruptedException

Stop an existing inbound agent and wait for it to go offline.

Throws:

InterruptedException

stop

public void stop(@NonNull
 RealJenkinsExtension rjr,
 @NonNull
 String name)
          throws Throwable

Stop an existing inbound agent and wait for it to go offline.

Throws:

Throwable

stop

public void stop(@NonNull
 String name)

Stops an existing inbound agent. You need only call this to simulate an agent crash, followed by start(org.jvnet.hudson.test.JenkinsRule, java.lang.String).

isAlive

public boolean isAlive(String name)

Checks whether an existing inbound agent process is currently running. (This is distinct from whether Jenkins considers the computer to be connected.)

afterEach

public void afterEach(@NonNull
 org.junit.jupiter.api.extension.ExtensionContext context)

Specified by:

afterEach in interface org.junit.jupiter.api.extension.AfterEachCallback

getAgentArguments

public static InboundAgentExtension.AgentArguments getAgentArguments(JenkinsRule r,
 String name)
                                                              throws IOException

Throws:

IOException

waitForAgentOnline

public static void waitForAgentOnline(JenkinsRule r,
 String name,
 Map<String,Level> loggers)
                               throws Exception

Throws:

Exception

waitForAgentOffline

public static void waitForAgentOffline(JenkinsRule r,
 String name)
                                throws InterruptedException

Throws:

InterruptedException

createAgentRJR

public static String[] createAgentRJR(JenkinsRule r,
 InboundAgentExtension.Options options)
                               throws Throwable

Throws:

Throwable