com.atlassian.bamboo.buildqueue.manager

Interface ExecutableAgentsMatrix

All Known Implementing Classes:

ExecutableAgentsMatrixImpl

public interface ExecutableAgentsMatrix

Method Summary

Modifier and Type	Method and Description
void	addBuildAgent(BuildAgent buildAgent) Record an agent matching ALL requirements
void	addBuildAgents(Collection<BuildAgent> buildAgents) Record a collection of agents matching ALL requirements
void	addDedicatedNonMatchingBuildAgent(BuildAgent buildAgent) Record build agent dedicated to the job/plan/project but not satisfying all requirements
void	addDedicatedNonMatchingImage(ElasticImageConfiguration elasticImageConfiguration) Record image configuration dedicated to the job/plan/project but not satisfying all requirements
void	addImageMatch(ElasticImageConfiguration imageMatch) Record an image that matches all requirements
void	addImageToMatrix(String requirementKey, ElasticImageConfiguration image) Record an image matching a requirement.
void	addRequirementWithNoAgentMatch(ImmutableRequirement requirement) Record a requirement that does not have any matching agents.
void	addRequirementWithNoImageMatch(ImmutableRequirement requirement) Record a requirement that does not have any matching image.
SortedSet<BuildAgent>	getBuildAgents() Get a set of agents that match ALL requirements.
Collection<BuildAgent>	getBuildAgents(String requirementKey)
SortedSet<BuildAgent>	getDedicatedNonMatchingBuildAgents()
List<ElasticImageConfiguration>	getDedicatedNonMatchingImages()
Collection<ElasticImageConfiguration>	getImageFromMatrix(String requirementKey)
List<ElasticImageConfiguration>	getImageMatches() Get a set of elastic images that match ALL requirements.
Collection<BuildAgent>	getOnlineEnabledBuildAgents() Get a set of agents that match ALL requirements AND are currently enabled and online.
int	getRequirementCount()
Set<ImmutableRequirement>	getRequirementsWithNoMatches() Retrieve a list of all requirements which were not matched by any agent or image.
boolean	isElasticBambooEnabled() Check if elastic support is enabled
void	put(String requirementKey, BuildAgent agent) Record an agent matching a requirement.
void	setElasticBambooEnabled(boolean elasticBambooEnabled) Mark whether elastic support is enabled or not
void	setRequirementCount(int requirementCount)

Method Detail

addBuildAgent

void addBuildAgent(@NotNull
                   BuildAgent buildAgent)

Record an agent matching ALL requirements

Parameters:

buildAgent - that matches

addBuildAgents

void addBuildAgents(@NotNull
                    Collection<BuildAgent> buildAgents)

Record a collection of agents matching ALL requirements

Parameters:

buildAgents - that match

addImageMatch

void addImageMatch(@NotNull
                   ElasticImageConfiguration imageMatch)

Record an image that matches all requirements

Parameters:

imageMatch - image that matches

addImageToMatrix

void addImageToMatrix(@NotNull
                      String requirementKey,
                      @NotNull
                      ElasticImageConfiguration image)

Record an image matching a requirement. May also get recorded to match all requirements

Parameters:

requirementKey - for requirement that matches

image - that matches

put

void put(@NotNull
         String requirementKey,
         @NotNull
         BuildAgent agent)

Record an agent matching a requirement. May also get recorded to match all requirements

Parameters:

requirementKey - of requirement matched

agent - that matches

getBuildAgents

@NotNull
SortedSet<BuildAgent> getBuildAgents()

Get a set of agents that match ALL requirements. i.e. these agents could build the executable. Includes offline and disabled agents

Returns:

a set of agents that match all requirements.

getBuildAgents

@Nullable
Collection<BuildAgent> getBuildAgents(@NotNull
                                                String requirementKey)

Parameters:

requirementKey - of requirement

Returns:

a collection of agents that match a single requirement

getImageMatches

@NotNull
List<ElasticImageConfiguration> getImageMatches()

Get a set of elastic images that match ALL requirements. i.e. these images could build the executable.

Returns:

a list of images that match all requirements.

getImageFromMatrix

@Nullable
Collection<ElasticImageConfiguration> getImageFromMatrix(@NotNull
                                                                   String requirementKey)

Parameters:

requirementKey - of requirement

Returns:

a collection of images that match a single requirement

getOnlineEnabledBuildAgents

@NotNull
Collection<BuildAgent> getOnlineEnabledBuildAgents()

Get a set of agents that match ALL requirements AND are currently enabled and online. i.e. these agents could build the executable now

Returns:

set of online enabled build agents that match all requirements

addRequirementWithNoAgentMatch

void addRequirementWithNoAgentMatch(@NotNull
                                    ImmutableRequirement requirement)

Record a requirement that does not have any matching agents.

Parameters:

requirement - that didn't have a match

addRequirementWithNoImageMatch

void addRequirementWithNoImageMatch(@NotNull
                                    ImmutableRequirement requirement)

Record a requirement that does not have any matching image.

Parameters:

requirement - that didn't have a match

getRequirementsWithNoMatches

@NotNull
Set<ImmutableRequirement> getRequirementsWithNoMatches()

Retrieve a list of all requirements which were not matched by any agent or image. If elastic capability is disabled it will ignore images and just look at agent matches.

Returns:

Set of requirements with no matches

setElasticBambooEnabled

void setElasticBambooEnabled(boolean elasticBambooEnabled)

Mark whether elastic support is enabled or not

Parameters:

elasticBambooEnabled - whether elastic bamboo is enabled

isElasticBambooEnabled

boolean isElasticBambooEnabled()

Check if elastic support is enabled

Returns:

true if elastic bamboo is enabled, otherwise false

getRequirementCount

int getRequirementCount()

Returns:

How many requirements were used to generate this matrix

setRequirementCount

void setRequirementCount(int requirementCount)

Parameters:

requirementCount - How many requirements were used to generate this matrix

addDedicatedNonMatchingImage

void addDedicatedNonMatchingImage(@NotNull
                                  ElasticImageConfiguration elasticImageConfiguration)

Record image configuration dedicated to the job/plan/project but not satisfying all requirements

Parameters:

elasticImageConfiguration -

addDedicatedNonMatchingBuildAgent

void addDedicatedNonMatchingBuildAgent(@NotNull
                                       BuildAgent buildAgent)

Record build agent dedicated to the job/plan/project but not satisfying all requirements

Parameters:

buildAgent -

getDedicatedNonMatchingBuildAgents

@NotNull
SortedSet<BuildAgent> getDedicatedNonMatchingBuildAgents()

Returns:

list of dedicated agents that don't match all requirements

getDedicatedNonMatchingImages

@NotNull
List<ElasticImageConfiguration> getDedicatedNonMatchingImages()

Returns:

list of dedicated images that don't match the all requirements