com.atlassian.bamboo.plan

Class ExecutableAgentsHelperImpl

java.lang.Object

com.atlassian.bamboo.plan.ExecutableAgentsHelperImpl

All Implemented Interfaces:

ExecutableAgentsHelper

public class ExecutableAgentsHelperImpl
extends Object
implements ExecutableAgentsHelper

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.bamboo.plan.ExecutableAgentsHelper

ExecutableAgentsHelper.ExecutableQuery, ExecutableAgentsHelper.ExecutorQuery

Constructor Summary

Constructors

Constructor and Description

ExecutableAgentsHelperImpl(CachedPlanManager cachedPlanManager, ExecutionStatusProvider executionStatusProvider, com.atlassian.plugin.PluginAccessor pluginAccessor, AgentAssignmentService agentAssignmentService, CapabilityRequirementsMatcher capabilityRequirementsMatcher, CapabilitySetManager capabilitySetManager, ElasticInstanceManager elasticInstanceManager, ElasticImageConfigurationAccessor elasticImageConfigurationAccessor)

Method Summary

Modifier and Type	Method and Description
boolean	canExecute(BuildAgent buildAgent, CommonContext context, ImmutableRequirementSet requirements) Returns true or false depending on whether the agent can execute the given context, taking into account requirement set and other global settings such as agent assignments.
Collection<BuildAgent>	getExecutableAgents(ExecutableAgentsHelper.ExecutorQuery executorQuery)
ExecutableAgentsMatrix	getExecutableAgentsMatrix(ExecutableAgentsHelper.ExecutorQuery executorQuery)
Collection<ImmutableBuildable>	getExecutableBuildables(ExecutableAgentsHelper.ExecutableQuery executableQuery) Collection of buildables for which this agent can execute.
Collection<Environment>	getExecutableEnvironments(ExecutableAgentsHelper.ExecutableQuery executableQuery)
Collection<ElasticImageConfiguration>	getExecutableImages(ExecutableAgentsHelper.ExecutorQuery executorQuery) Calculates the list of elastic images that are capable of running an agent that can build a Buildable plan.
boolean	isAgentEligibleForReceivingJobs(long agentId) This method checks if agent is eligible to receive new jobs.
boolean	planHasExecutableAgents(PlanKey planKey, boolean includeDisabled) Checks if a Buildable can be built on any active agent.
boolean	planHasExecutableAgents(PlanResultKey planResultKey) Checks if a Job can be built on any active agent.
void	resendStopAgentMessageIfRequired(long agentId) If agent is online and BuildAgent.isRequestedToBeStopped() is true, the system will re-request the agent stop.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutableAgentsHelperImpl

public ExecutableAgentsHelperImpl(CachedPlanManager cachedPlanManager,
                                  ExecutionStatusProvider executionStatusProvider,
                                  com.atlassian.plugin.PluginAccessor pluginAccessor,
                                  AgentAssignmentService agentAssignmentService,
                                  CapabilityRequirementsMatcher capabilityRequirementsMatcher,
                                  CapabilitySetManager capabilitySetManager,
                                  ElasticInstanceManager elasticInstanceManager,
                                  ElasticImageConfigurationAccessor elasticImageConfigurationAccessor)

Method Detail

getExecutableAgents

@NotNull
 @Transactional
public Collection<BuildAgent> getExecutableAgents(@NotNull
                                                                           ExecutableAgentsHelper.ExecutorQuery executorQuery)

Specified by:

getExecutableAgents in interface ExecutableAgentsHelper

canExecute

public boolean canExecute(@NotNull
                          BuildAgent buildAgent,
                          @NotNull
                          CommonContext context,
                          @NotNull
                          ImmutableRequirementSet requirements)

Description copied from interface: ExecutableAgentsHelper

Returns true or false depending on whether the agent can execute the given context, taking into account requirement set and other global settings such as agent assignments.

Specified by:

canExecute in interface ExecutableAgentsHelper

getExecutableAgentsMatrix

public ExecutableAgentsMatrix getExecutableAgentsMatrix(@NotNull
                                                        ExecutableAgentsHelper.ExecutorQuery executorQuery)

Specified by:

getExecutableAgentsMatrix in interface ExecutableAgentsHelper

isAgentEligibleForReceivingJobs

public boolean isAgentEligibleForReceivingJobs(long agentId)

Description copied from interface: ExecutableAgentsHelper

This method checks if agent is eligible to receive new jobs.

Specified by:

isAgentEligibleForReceivingJobs in interface ExecutableAgentsHelper

Returns:

true iff agent it's ok to receive jobs (i.e. we haven't requested it's shutdown)

resendStopAgentMessageIfRequired

public void resendStopAgentMessageIfRequired(long agentId)

Description copied from interface: ExecutableAgentsHelper

If agent is online and BuildAgent.isRequestedToBeStopped() is true, the system will re-request the agent stop.

Specified by:

resendStopAgentMessageIfRequired in interface ExecutableAgentsHelper

getExecutableImages

public Collection<ElasticImageConfiguration> getExecutableImages(@NotNull
                                                                 ExecutableAgentsHelper.ExecutorQuery executorQuery)

Description copied from interface: ExecutableAgentsHelper

Calculates the list of elastic images that are capable of running an agent that can build a Buildable plan.

Specified by:

getExecutableImages in interface ExecutableAgentsHelper

Returns:

planHasExecutableAgents

@Transactional
public boolean planHasExecutableAgents(@NotNull
                                                      PlanKey planKey,
                                                      boolean includeDisabled)

Checks if a Buildable can be built on any active agent. This implementation utilises information already available in ExecutionStatus if it exists.

Specified by:

planHasExecutableAgents in interface ExecutableAgentsHelper

Parameters:

planKey -

includeDisabled - indicate whether disabled agents should be included in checking

Returns:

planHasExecutableAgents

@Transactional
public boolean planHasExecutableAgents(@NotNull
                                                      PlanResultKey planResultKey)

Checks if a Job can be built on any active agent. This implementation utilises information already available in ExecutionStatus if it exists.

Specified by:

planHasExecutableAgents in interface ExecutableAgentsHelper

Parameters:

planResultKey -

Returns:

getExecutableBuildables

@NotNull
public Collection<ImmutableBuildable> getExecutableBuildables(@NotNull
                                                                       ExecutableAgentsHelper.ExecutableQuery executableQuery)

Description copied from interface: ExecutableAgentsHelper

Collection of buildables for which this agent can execute. Checks capabilities and agent assignments

Specified by:

getExecutableBuildables in interface ExecutableAgentsHelper

getExecutableEnvironments

@NotNull
public Collection<Environment> getExecutableEnvironments(@NotNull
                                                                  ExecutableAgentsHelper.ExecutableQuery executableQuery)

Specified by:

getExecutableEnvironments in interface ExecutableAgentsHelper

Returns:

collection of environments that can be executed using given set of capabilities/assignments