com.atlassian.bamboo.agent.elastic.server
Interface ElasticInstanceManager

All Superinterfaces:

ElasticAgentTunnelPorts

All Known Implementing Classes:

ElasticInstanceManagerImpl

public interface ElasticInstanceManager
extends ElasticAgentTunnelPorts

Field Summary

static com.atlassian.aws.ec2.EC2InstanceType

DEFAULT_INSTANCE_TYPE

Method Summary

void	addElasticLogEntry(java.lang.String logEntry) Add a line to the elastic activity logs
void	ensureLoginKeyPairExists(com.atlassian.aws.AWSAccount awsAccount) Ensures that a key pair, named "elasticbamboo", has been defined in the configured AWS account.
com.google.common.collect.SetMultimap<ElasticImageConfiguration,RemoteElasticInstance>	getAllElasticAgentsAsMap() Returns all elastic instances in a SetMultimap, keyed by the ElasticImageConfiguration
java.util.List<RemoteElasticInstance>	getAllElasticRemoteAgents() Returns all elastic agents.
java.util.Set<com.atlassian.aws.ec2.EC2InstanceType>	getAllowedInstanceTypes()
java.lang.String	getDefaultImageId()
java.util.List<java.lang.String>	getElasticAgentLogs() Retrieve activity logs
RemoteElasticInstance	getElasticRemoteAgentByInstanceId(java.lang.String instanceId) Retrieve elastic instance of the given ID.
java.util.List<RemoteElasticInstance>	getElasticRemoteAgents() Retrieve a readonly list of any currently existing EC2 instances
java.util.List<RemoteElasticInstance>	getElasticRemoteAgentsByConfiguration(ElasticImageConfiguration elasticImageConfiguration)
java.util.List<RemoteElasticInstance>	getElasticRemoteAgentsByConfiguration(long id)
java.util.List<RemoteElasticInstance>	getRequestedElasticRemoteAgents() Return the elastic instances which have been requested but not yet started up yet.
int	getTotalNumElasticRemoteAgents() Return how many license spots are currently being occupied by elastic instances (pending and running)
boolean	isElasticSupportEnabled()
RemoteElasticInstance	newElasticAgent(RemoteElasticInstanceListener listener, com.atlassian.aws.AWSAccount awsAccount, LocalAgentManager localAgentManager, ElasticImageConfiguration elasticImageConfiguration)
void	registerElasticAgentStarted(RemoteElasticInstance instance) Tell the manager that the agent is up and running
void	registerElasticAgentStopped(RemoteElasticInstance instance) Remove and EC2 instance from the "currently Running map
boolean	validateAwsCredentials(java.lang.String awsAccessID, java.lang.String awsSecretKey, ErrorCollection errorCollection) Validate a set of supplied AWS credentials.

Methods inherited from interface com.atlassian.bamboo.agent.elastic.tunnel.ElasticAgentTunnelPorts

getHTTPProxyPort, getJMSProxyPort, getTunnelPort

Field Detail

DEFAULT_INSTANCE_TYPE

static final com.atlassian.aws.ec2.EC2InstanceType DEFAULT_INSTANCE_TYPE

Method Detail

newElasticAgent

RemoteElasticInstance newElasticAgent(RemoteElasticInstanceListener listener,
                                      com.atlassian.aws.AWSAccount awsAccount,
                                      LocalAgentManager localAgentManager,
                                      ElasticImageConfiguration elasticImageConfiguration)
                                      throws java.security.NoSuchAlgorithmException,
                                             java.security.KeyManagementException,
                                             java.io.IOException,
                                             java.security.cert.CertificateException,
                                             java.security.UnrecoverableKeyException,
                                             java.security.KeyStoreException

Throws:

java.security.NoSuchAlgorithmException

java.security.KeyManagementException

java.io.IOException

java.security.cert.CertificateException

java.security.UnrecoverableKeyException

java.security.KeyStoreException

ensureLoginKeyPairExists

void ensureLoginKeyPairExists(com.atlassian.aws.AWSAccount awsAccount)
                              throws com.atlassian.aws.AWSException

Ensures that a key pair, named "elasticbamboo", has been defined in the configured AWS account.

Parameters:

awsAccount - that should contain the key pair

Throws:

com.atlassian.aws.AWSException - if there is a problem communicating with EC2.

validateAwsCredentials

boolean validateAwsCredentials(java.lang.String awsAccessID,
                               java.lang.String awsSecretKey,
                               ErrorCollection errorCollection)

Validate a set of supplied AWS credentials.

Parameters:

awsAccessID - The Access ID of the Amazon Web Services Account

awsSecretKey - The Secret Key of the Amazon Web Services Account

errorCollection - An ErrorCollection to which validation errors should be added, or null if validation errors are not required.

Returns:

true if the supplied credentials are successfully validated; false otherwise.

getElasticRemoteAgents

@NotNull
java.util.List<RemoteElasticInstance> getElasticRemoteAgents()

Retrieve a readonly list of any currently existing EC2 instances

Returns:

List of RemoteElasticInstance

getRequestedElasticRemoteAgents

@NotNull
java.util.List<RemoteElasticInstance> getRequestedElasticRemoteAgents()

Return the elastic instances which have been requested but not yet started up yet.

Returns:

List of elastic instances which have been requested but not yet started up yet..

getAllElasticRemoteAgents

java.util.List<RemoteElasticInstance> getAllElasticRemoteAgents()

Returns all elastic agents. It includes requested agents as well as active agents

Returns:

getAllElasticAgentsAsMap

com.google.common.collect.SetMultimap<ElasticImageConfiguration,RemoteElasticInstance> getAllElasticAgentsAsMap()

Returns all elastic instances in a SetMultimap, keyed by the ElasticImageConfiguration

Returns:

getTotalNumElasticRemoteAgents

int getTotalNumElasticRemoteAgents()

Return how many license spots are currently being occupied by elastic instances (pending and running)

Returns:

Number of license slots currently occupied by elastic instances (pending and running).

getElasticRemoteAgentByInstanceId

@Nullable
RemoteElasticInstance getElasticRemoteAgentByInstanceId(java.lang.String instanceId)

Retrieve elastic instance of the given ID.

Parameters:

instanceId - of the instance

Returns:

the elastic remote agent specific to the provided instance id

registerElasticAgentStopped

void registerElasticAgentStopped(@NotNull
                                 RemoteElasticInstance instance)

Remove and EC2 instance from the "currently Running map

Parameters:

instance - - the one to be deleted from the map

registerElasticAgentStarted

void registerElasticAgentStarted(@NotNull
                                 RemoteElasticInstance instance)

Tell the manager that the agent is up and running

Parameters:

instance - - the agent that is running

addElasticLogEntry

void addElasticLogEntry(java.lang.String logEntry)

Add a line to the elastic activity logs

Parameters:

logEntry - - the line you want added to the logs

getElasticAgentLogs

java.util.List<java.lang.String> getElasticAgentLogs()

Retrieve activity logs

Returns:

a copy of the current elastic agent logs

isElasticSupportEnabled

boolean isElasticSupportEnabled()

Returns:

true, if elastic support is turned on

getAllowedInstanceTypes

@NotNull
java.util.Set<com.atlassian.aws.ec2.EC2InstanceType> getAllowedInstanceTypes()

Returns:

Set of allowed instance types.

getElasticRemoteAgentsByConfiguration

@NotNull
java.util.List<RemoteElasticInstance> getElasticRemoteAgentsByConfiguration(ElasticImageConfiguration elasticImageConfiguration)

getElasticRemoteAgentsByConfiguration

@NotNull
java.util.List<RemoteElasticInstance> getElasticRemoteAgentsByConfiguration(long id)

getDefaultImageId

@Nullable
java.lang.String getDefaultImageId()