com.atlassian.bamboo.plan

Interface ExecutableAgentsHelper

All Known Implementing Classes:

ExecutableAgentsHelperImpl

@Internal
public interface ExecutableAgentsHelper

Utility class to determine which agents can build a Plan

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ExecutableAgentsHelper.ExecutableQuery
static class	ExecutableAgentsHelper.ExecutorQuery

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 defined agent.
boolean	planHasExecutableAgents(PlanResultKey planResultKey) Checks if a Buildable 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.

Method Detail

planHasExecutableAgents

boolean planHasExecutableAgents(@NotNull
                                PlanKey planKey,
                                boolean includeDisabled)

Checks if a Buildable can be built on any defined agent.

Parameters:

planKey -

includeDisabled - indicate whether disabled agents should be included in checking

Returns:

Throws:

IllegalArgumentException - if planKey is not a Buildable key

planHasExecutableAgents

boolean planHasExecutableAgents(@NotNull
                                PlanResultKey planResultKey)

Checks if a Buildable can be built on any active agent.

Parameters:

planResultKey -

Returns:

Throws:

IllegalArgumentException - if planResultKey is not a key of running Job

getExecutableImages

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

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

Returns:

getExecutableAgents

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

canExecute

boolean canExecute(@NotNull
                   BuildAgent buildAgent,
                   @NotNull
                   CommonContext context,
                   @NotNull
                   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.

getExecutableAgentsMatrix

ExecutableAgentsMatrix getExecutableAgentsMatrix(@NotNull
                                                 ExecutableAgentsHelper.ExecutorQuery executorQuery)

getExecutableBuildables

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

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

getExecutableEnvironments

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

Returns:

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

isAgentEligibleForReceivingJobs

boolean isAgentEligibleForReceivingJobs(long agentId)

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

Returns:

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

Since:

5.10

resendStopAgentMessageIfRequired

void resendStopAgentMessageIfRequired(long agentId)

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