Package hudson.plugins.ec2

Class EC2RetentionStrategy

java.lang.Object

hudson.model.AbstractDescribableImpl<RetentionStrategy<?>>

hudson.slaves.RetentionStrategy<EC2Computer>

hudson.plugins.ec2.EC2RetentionStrategy

All Implemented Interfaces:

ExtensionPoint, Describable<RetentionStrategy<?>>, ExecutorListener

public class EC2RetentionStrategy
extends RetentionStrategy<EC2Computer>
implements ExecutorListener

RetentionStrategy for EC2.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EC2RetentionStrategy.DescriptorImpl

Nested classes/interfaces inherited from class hudson.slaves.RetentionStrategy

RetentionStrategy.Always, RetentionStrategy.Demand

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field	Description
static final boolean	DISABLED
final int	idleTerminationMinutes	Number of minutes of idleness before an instance should be terminated.

Fields inherited from class hudson.slaves.RetentionStrategy

INSTANCE, LIST, NOOP

Constructor Summary

Constructors

Constructor	Description
EC2RetentionStrategy(String idleTerminationMinutes)

Method Summary

Modifier and Type	Method	Description
long	check(EC2Computer c)	Lightweight path: returns immediately so the Queue lock is not held during EC2 API calls.
protected Object	readResolve()
void	start(EC2Computer c)	Lightweight path: returns immediately.
void	taskAccepted(Executor executor, Queue.Task task)
void	taskCompleted(Executor executor, Queue.Task task, long durationMS)
void	taskCompletedWithProblems(Executor executor, Queue.Task task, long durationMS, Throwable problems)

Methods inherited from class hudson.slaves.RetentionStrategy

all, isAcceptingTasks, isManualLaunchAllowed

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

Methods inherited from interface hudson.model.ExecutorListener

taskStarted

Field Details

DISABLED

public static final boolean DISABLED

idleTerminationMinutes

public final int idleTerminationMinutes

Number of minutes of idleness before an instance should be terminated. A value of zero indicates that the instance should never be automatically terminated. Negative values are times in remaining minutes before end of billing period.

Constructor Details

EC2RetentionStrategy

@DataBoundConstructor
public EC2RetentionStrategy(String idleTerminationMinutes)

Method Details

check

public long check(EC2Computer c)

Lightweight path: returns immediately so the Queue lock is not held during EC2 API calls. Heavy work (getState, getUptime, idle timeout, reconnect) is scheduled to run asynchronously outside the Queue lock. See docs/EC2_QUEUE_AUDIT.md.

Specified by:

check in class RetentionStrategy<EC2Computer>

start

public void start(EC2Computer c)

Lightweight path: returns immediately. Heavy work (getState, connect) runs asynchronously so the caller is not blocked by EC2 API calls.

Overrides:

start in class RetentionStrategy<EC2Computer>

readResolve

protected Object readResolve()

taskAccepted

public void taskAccepted(Executor executor,
 Queue.Task task)

Specified by:

taskAccepted in interface ExecutorListener

taskCompleted

public void taskCompleted(Executor executor,
 Queue.Task task,
 long durationMS)

Specified by:

taskCompleted in interface ExecutorListener

taskCompletedWithProblems

public void taskCompletedWithProblems(Executor executor,
 Queue.Task task,
 long durationMS,
 Throwable problems)

Specified by:

taskCompletedWithProblems in interface ExecutorListener