Package com.amazon.jenkins.ec2fleet.fleet

Class AutoScalingGroupFleet

java.lang.Object

com.amazon.jenkins.ec2fleet.fleet.AutoScalingGroupFleet

All Implemented Interfaces:

EC2Fleet

@ThreadSafe
public class AutoScalingGroupFleet
extends Object
implements EC2Fleet

Constructor Summary

Constructors

Constructor	Description
AutoScalingGroupFleet()

Method Summary

Modifier and Type	Method	Description
software.amazon.awssdk.services.autoscaling.AutoScalingClient	createClient(String awsCredentialsId, String regionName, String endpoint)
void	describe(String awsCredentialsId, String regionName, String endpoint, ListBoxModel model, String selectedId, boolean showAll)
FleetStateStats	getState(String awsCredentialsId, String regionName, String endpoint, String id)
Map<String,FleetStateStats>	getStateBatch(String awsCredentialsId, String regionName, String endpoint, Collection<String> ids)
boolean	hasWarmPoolWithInstanceReuse(String awsCredentialsId, String regionName, String endpoint, String autoScalingGroupName)	Returns true when this Auto Scaling Group has a warm pool configured with an instance reuse policy that reuses instances on scale-in (ReuseOnScaleIn=true).
Boolean	isAutoScalingGroup()
void	modify(String awsCredentialsId, String regionName, String endpoint, String id, int targetCapacity, int min, int max)
void	scaleDownWithWarmPool(String awsCredentialsId, String regionName, String endpoint, String autoScalingGroupName, Map<String,EC2AgentTerminationReason> instances)	Scales the Auto Scaling Group down when it has a warm pool with instance reuse.
void	terminateInstances(String awsCredentialsId, String regionName, String endpoint, Collection<String> instanceIds)

Methods inherited from class java.lang.Object

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

Constructor Details

AutoScalingGroupFleet

public AutoScalingGroupFleet()

Method Details

describe

public void describe(String awsCredentialsId,
 String regionName,
 String endpoint,
 ListBoxModel model,
 String selectedId,
 boolean showAll)

Specified by:

describe in interface EC2Fleet

modify

public void modify(String awsCredentialsId,
 String regionName,
 String endpoint,
 String id,
 int targetCapacity,
 int min,
 int max)

Specified by:

modify in interface EC2Fleet

getState

public FleetStateStats getState(String awsCredentialsId,
 String regionName,
 String endpoint,
 String id)

Specified by:

getState in interface EC2Fleet

getStateBatch

public Map<String,FleetStateStats> getStateBatch(String awsCredentialsId,
 String regionName,
 String endpoint,
 Collection<String> ids)

Specified by:

getStateBatch in interface EC2Fleet

isAutoScalingGroup

public Boolean isAutoScalingGroup()

Specified by:

isAutoScalingGroup in interface EC2Fleet

createClient

public software.amazon.awssdk.services.autoscaling.AutoScalingClient createClient(String awsCredentialsId,
 String regionName,
 String endpoint)

terminateInstances

public void terminateInstances(String awsCredentialsId,
 String regionName,
 String endpoint,
 Collection<String> instanceIds)

hasWarmPoolWithInstanceReuse

public boolean hasWarmPoolWithInstanceReuse(String awsCredentialsId,
 String regionName,
 String endpoint,
 String autoScalingGroupName)

Returns true when this Auto Scaling Group has a warm pool configured with an instance reuse policy that reuses instances on scale-in (ReuseOnScaleIn=true).

Only in that case is it safe to scale the ASG down by removing scale-in protection and letting the ASG take the instance, since it is moved to the warm pool for reuse rather than terminated outright. Any failure to look up the warm pool is treated as "no warm pool" so the caller falls back to the pre-warm-pool behavior of terminating instances directly.

scaleDownWithWarmPool

public void scaleDownWithWarmPool(String awsCredentialsId,
 String regionName,
 String endpoint,
 String autoScalingGroupName,
 Map<String,EC2AgentTerminationReason> instances)

Scales the Auto Scaling Group down when it has a warm pool with instance reuse.

Scale-down instances are handed back to the ASG by removing their scale-in protection, so the ASG moves them to the warm pool for reuse (faster, cache-warm builds) instead of terminating them. Instances that must not be reused (e.g. MAX_TOTAL_USES_EXHAUSTED) are terminated directly via terminateInstances(String, String, String, Collection) so the ASG replaces them with a fresh instance.

Should only be called when hasWarmPoolWithInstanceReuse(String, String, String, String) returned true; otherwise use terminateInstances(String, String, String, Collection).