com.atlassian.bamboo.v2.build.agent.capability

Interface CapabilitySetManager

All Superinterfaces:

RemotedCapabilitySetManager

All Known Implementing Classes:

CapabilitySetManagerImpl

public interface CapabilitySetManager
extends RemotedCapabilitySetManager

Method Summary

Modifier and Type	Method and Description
CapabilitySet	createAgentCapabilitySet(LocalAgentDefinition pipelineDefinition) Create an agent scope capability set for local agents
CapabilitySet	createAgentCapabilitySet(RemoteAgentDefinition pipelineDefinition) Create an agent scope capability set for remote agents
List<String>	findUniqueCapabilityKeys() Finds all the distinct capability keys
ReadOnlyCapabilitySet	getCombinedCapabilitySet(CapabilitySet agentCapabilitySet) Gets a combined "effective" capabilitySet given an agent's capabilitySet.
ReadOnlyCapabilitySet	getCombinedCapabilitySet(CapabilitySet agentCapabilitySet, CapabilitySet sharedCapabilitySet) Gets a combined "effective" capabilitySet given an agent's capability set and a shared capability set The agent capabilitySet will override capabilities in the CapabilityScope.SHARED capabilities if there's a precise key match.
ElasticImageConfiguration	getElasticImage(CapabilitySet capabilitySet)
PipelineDefinition	getPipelineDefinition(CapabilitySet capabilitySet)
CapabilitySet	getSharedCapabilitySet(CapabilitySet agentCapabilitySet) Deprecated. since 5.10 use CapabilitySetManagerUtils#getSharedCapabilitySet instead
CapabilitySet	getSharedRemoteCapabilitySet() Gets the remotely shared capabilities
Collection<Capability>	getSystemCapabilities(String type) Collection of Capability which have keys prefixed with system.{type} Used to identify Bamboo system capabilities for Builders / JDKs.
Collection<Capability>	getSystemCapabilitiesByKey(String key) Collection of Capability which have the specified key
Collection<String>	getSystemCapabilityKeys(String type, boolean isElasticEnabled) Returns a list of Capability Keys that match the given type
void	saveCapabilitySet(CapabilitySet capabilitySet) Saves a capability set

Methods inherited from interface com.atlassian.bamboo.v2.build.agent.capability.RemotedCapabilitySetManager

getCombinedCapabilitySet, getSharedLocalCapabilitySet

Method Detail

getSharedRemoteCapabilitySet

CapabilitySet getSharedRemoteCapabilitySet()

Gets the remotely shared capabilities

Returns:

CapabilitySet

getSharedCapabilitySet

@Nullable
 @Deprecated
CapabilitySet getSharedCapabilitySet(@NotNull
                                                            CapabilitySet agentCapabilitySet)

Deprecated. since 5.10 use CapabilitySetManagerUtils#getSharedCapabilitySet instead

Gets the shared capabilities depending on agentCapability type.

Parameters:

agentCapabilitySet -

Returns:

shared capability set, null if neither Local nor Remote capability set passed as parameter

saveCapabilitySet

void saveCapabilitySet(@NotNull
                       CapabilitySet capabilitySet)

Saves a capability set

Parameters:

capabilitySet -

createAgentCapabilitySet

@NotNull
CapabilitySet createAgentCapabilitySet(@NotNull
                                                LocalAgentDefinition pipelineDefinition)

Create an agent scope capability set for local agents

Parameters:

pipelineDefinition -

Returns:

createAgentCapabilitySet

@NotNull
CapabilitySet createAgentCapabilitySet(@NotNull
                                                RemoteAgentDefinition pipelineDefinition)

Create an agent scope capability set for remote agents

Parameters:

pipelineDefinition -

Returns:

getCombinedCapabilitySet

@NotNull
ReadOnlyCapabilitySet getCombinedCapabilitySet(@NotNull
                                                        CapabilitySet agentCapabilitySet)

Gets a combined "effective" capabilitySet given an agent's capabilitySet. Will retrieve the shared capabilitySet for the agent based on the CapabilityScope. The agent capabilitySet will override capabilities in the CapabilityScope.SHARED capabilities if there's a precise key match.

Parameters:

agentCapabilitySet -

Returns:

getCombinedCapabilitySet

ReadOnlyCapabilitySet getCombinedCapabilitySet(@NotNull
                                               CapabilitySet agentCapabilitySet,
                                               @Nullable
                                               CapabilitySet sharedCapabilitySet)

Gets a combined "effective" capabilitySet given an agent's capability set and a shared capability set The agent capabilitySet will override capabilities in the CapabilityScope.SHARED capabilities if there's a precise key match.

getSystemCapabilityKeys

@NotNull
Collection<String> getSystemCapabilityKeys(@NotNull
                                                    String type,
                                                    boolean isElasticEnabled)

Returns a list of Capability Keys that match the given type

Parameters:

type - eg "builder" or "jdk"

Returns:

list of capability keys eg. "system.builder.mvn2.Maven 2"

getSystemCapabilities

@NotNull
Collection<Capability> getSystemCapabilities(@NotNull
                                                      String type)

Collection of Capability which have keys prefixed with system.{type} Used to identify Bamboo system capabilities for Builders / JDKs.

Parameters:

type -

Returns:

getSystemCapabilitiesByKey

@NotNull
Collection<Capability> getSystemCapabilitiesByKey(@NotNull
                                                           String key)

Collection of Capability which have the specified key

Parameters:

key -

Returns:

findUniqueCapabilityKeys

@NotNull
List<String> findUniqueCapabilityKeys()

Finds all the distinct capability keys

Returns:

getPipelineDefinition

@Nullable
PipelineDefinition getPipelineDefinition(@NotNull
                                                   CapabilitySet capabilitySet)

getElasticImage

@Nullable
ElasticImageConfiguration getElasticImage(@NotNull
                                                    CapabilitySet capabilitySet)