Package com.atlassian.bamboo.vcs.configuration.legacy

Class DeploymentRepositoryBuildContext

java.lang.Object

com.atlassian.bamboo.vcs.configuration.legacy.DeploymentRepositoryBuildContext

All Implemented Interfaces:

BuildContext, BuildIdentifier, CommonContext, Serializable

public class DeploymentRepositoryBuildContext
extends Object
implements BuildContext

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
DeploymentRepositoryBuildContext(CommonContext commonContext)

Method Summary

Modifier and Type	Method	Description
@NotNull ArtifactContext	getArtifactContext()
@NotNull BambooBandanaContext	getBandanaContext()	BandanaContext of the plan.
@NotNull BuildChanges	getBuildChanges()	Returns the build changes, if any, that represents the changes that triggered this build.
@NotNull BuildDefinition	getBuildDefinition()
@NotNull BuildKey	getBuildKey()
int	getBuildNumber()	The build number being built
@NotNull CurrentBuildResult	getBuildResult()	The information about the results of a build
@NotNull String	getBuildResultKey()	Full build result key (e.g.
@NotNull Map<PlanKey,ChainStorageTag>	getChainStorageTags()
@NotNull Map<Long,String>	getCheckoutLocation()	Map holds final checkout where repository was checked out by VcsCheckoutTask Elements are kept in order of checkout
CurrentResult	getCurrentResult()
String	getDisplayName()	A human friendly description of what is being built.
@NotNull DockerPipelineConfiguration	getDockerPipelineConfiguration()
Long	getEntityGroupId()	Returns id of a group entity belongs to.
long	getEntityId()
Key	getEntityKey()
@NotNull ErrorCollection	getErrorCollection()	Any errors associated with the build
Optional<Long>	getMasterPlanId()
long	getMaximumBuildWarningsCount()
@Nullable MergeResultContext	getMergeResult()	If a build performs merge, this method returns the result.
@Nullable BuildContext	getParentBuildContext()	If this context is for ImmutableJob returns context of owner chain, null otherwise.
@Nullable BuildIdentifier	getParentBuildIdentifier()
Optional<Long>	getPlanDbId()
long	getPlanId()
@NotNull String	getPlanKey()	Full plan key (e.g.
@NotNull String	getPlanName()	The full name of the Plan
@NotNull PlanResultKey	getPlanResultKey()	Gets the PlanResultKey for the current BuildIdentifier
@NotNull String	getProjectName()
@NotNull Set<Long>	getRelevantRepositoryIds()
ResultKey	getResultKey()
@NotNull List<RuntimeTaskDefinition>	getRuntimeTaskDefinitions()	All tasks defined for this build.
@NotNull Iterable<CredentialsData>	getSharedCredentials()
@NotNull String	getShortName()	The short name of the Plan
@NotNull TriggerReason	getTriggerReason()	The reason this build was triggered
@NotNull PlanKey	getTypedPlanKey()	Full plan key (e.g.
@NotNull UUID	getUuid()	Id of the run.
@NotNull VariableContext	getVariableContext()
@NotNull List<PlanRepositoryDefinition>	getVcsRepositories()
@NotNull Map<Long,PlanRepositoryDefinition>	getVcsRepositoryMap()
boolean	isBranch()	Provides information if context refers to the branch of the Chain
boolean	isCustomBuild()	Provides information if context refers to the build that had some variables overwritten
boolean	isExpectingCustomDedicatedAgent()	If this job is expected to be built on a custom dedicated agent
boolean	isOnceOff()	Provides information if context refers to the "once-off" build - a build that have been run with customized revision
boolean	isVerboseLoggingOn()	Controls the amount of logging during the execution.
void	setBuildChanges(BuildChanges buildChanges)
void	setMergeResult(@Nullable MergeResultContext mergeResult)
void	setVariableContext(@NotNull VariableContext variableContext)

Methods inherited from class java.lang.Object

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

Constructor Detail

DeploymentRepositoryBuildContext

public DeploymentRepositoryBuildContext(CommonContext commonContext)

Method Detail

getBuildKey

@NotNull
public @NotNull BuildKey getBuildKey()

Specified by:

getBuildKey in interface CommonContext

getParentBuildContext

@Nullable
public @Nullable BuildContext getParentBuildContext()

Description copied from interface: BuildContext

If this context is for ImmutableJob returns context of owner chain, null otherwise. Note: modifying parent context by job-level actions, such as PreJobAction is not thread safe and is not supported.

Specified by:

getParentBuildContext in interface BuildContext

Returns:

the BuildContext of the parent Plan execution. Should return null if the current BuildContext is for a TopLevelPlan

getBuildDefinition

@NotNull
public @NotNull BuildDefinition getBuildDefinition()

Specified by:

getBuildDefinition in interface BuildContext

Returns:

BuildDefinition associated with Plan this context relates to

getArtifactContext

@NotNull
public @NotNull ArtifactContext getArtifactContext()

Specified by:

getArtifactContext in interface BuildContext

Specified by:

getArtifactContext in interface CommonContext

Returns:

Artifact data associated with Plan

getBuildChanges

@NotNull
public @NotNull BuildChanges getBuildChanges()

Description copied from interface: BuildContext

Returns the build changes, if any, that represents the changes that triggered this build.

Specified by:

getBuildChanges in interface BuildContext

Returns:

Never null. WIll return a build changes object with the appropriate list of changes, the list will be null if no changes were found.

setBuildChanges

public void setBuildChanges(BuildChanges buildChanges)

Specified by:

setBuildChanges in interface BuildContext

getBuildResult

@NotNull
public @NotNull CurrentBuildResult getBuildResult()

Description copied from interface: BuildContext

The information about the results of a build

Specified by:

getBuildResult in interface BuildContext

Returns:

CurrentBuildResult

getRelevantRepositoryIds

@NotNull
public @NotNull Set<Long> getRelevantRepositoryIds()

Specified by:

getRelevantRepositoryIds in interface BuildContext

Returns:

a set of repository id's that are relevant to this particular job, i.e. these jobs do checkout of that repository

getCheckoutLocation

@NotNull
public @NotNull Map<Long,String> getCheckoutLocation()

Description copied from interface: BuildContext

Map holds final checkout where repository was checked out by VcsCheckoutTask Elements are kept in order of checkout

Specified by:

getCheckoutLocation in interface BuildContext

Returns:

map of repositoryId as Long and checkout location as String

isBranch

public boolean isBranch()

Description copied from interface: BuildContext

Provides information if context refers to the branch of the Chain

Specified by:

isBranch in interface BuildContext

Returns:

true if context refers to the chain branch

isOnceOff

public boolean isOnceOff()

Description copied from interface: BuildContext

Provides information if context refers to the "once-off" build - a build that have been run with customized revision

Specified by:

isOnceOff in interface BuildContext

Returns:

true if context refers to the chain branch

isCustomBuild

public boolean isCustomBuild()

Description copied from interface: BuildContext

Provides information if context refers to the build that had some variables overwritten

Specified by:

isCustomBuild in interface BuildContext

Returns:

true if context refers to the build with overwritten variables

isVerboseLoggingOn

public boolean isVerboseLoggingOn()

Description copied from interface: CommonContext

Controls the amount of logging during the execution. Some of the logging is only output in verbose mode.

Specified by:

isVerboseLoggingOn in interface CommonContext

Returns:

true if verbose logging is enabled.

getEntityId

public long getEntityId()

Specified by:

getEntityId in interface CommonContext

getEntityKey

public Key getEntityKey()

Specified by:

getEntityKey in interface CommonContext

getResultKey

public ResultKey getResultKey()

Specified by:

getResultKey in interface CommonContext

getDisplayName

public String getDisplayName()

Description copied from interface: CommonContext

A human friendly description of what is being built.

Specified by:

getDisplayName in interface CommonContext

Returns:

getCurrentResult

public CurrentResult getCurrentResult()

Specified by:

getCurrentResult in interface CommonContext

getErrorCollection

@NotNull
public @NotNull ErrorCollection getErrorCollection()

Description copied from interface: CommonContext

Any errors associated with the build

Specified by:

getErrorCollection in interface CommonContext

getRuntimeTaskDefinitions

@NotNull
public @NotNull List<RuntimeTaskDefinition> getRuntimeTaskDefinitions()

Description copied from interface: CommonContext

All tasks defined for this build. Contains both regular tasks and finalising tasks.

Specified by:

getRuntimeTaskDefinitions in interface CommonContext

Returns:

A List of RuntimeTaskDefinitions

getVariableContext

@NotNull
public @NotNull VariableContext getVariableContext()

Specified by:

getVariableContext in interface CommonContext

getTriggerReason

@NotNull
public @NotNull TriggerReason getTriggerReason()

Description copied from interface: CommonContext

The reason this build was triggered

Specified by:

getTriggerReason in interface CommonContext

Returns:

triggerReason

getBandanaContext

@NotNull
public @NotNull BambooBandanaContext getBandanaContext()

Description copied from interface: BuildContext

BandanaContext of the plan.

Specified by:

getBandanaContext in interface BuildContext

Returns:

BandanaContext of the plan

getChainStorageTags

@NotNull
public @NotNull Map<PlanKey,ChainStorageTag> getChainStorageTags()

Specified by:

getChainStorageTags in interface CommonContext

getSharedCredentials

@NotNull
public @NotNull Iterable<CredentialsData> getSharedCredentials()

Specified by:

getSharedCredentials in interface CommonContext

getParentBuildIdentifier

@Nullable
public @Nullable BuildIdentifier getParentBuildIdentifier()

Specified by:

getParentBuildIdentifier in interface BuildIdentifier

Returns:

the BuildContext of the parent Plan execution. Should return null if the current BuildContext is for a Chain

getPlanId

public long getPlanId()

Specified by:

getPlanId in interface BuildIdentifier

Returns:

Database id of the plan.

getPlanDbId

public Optional<Long> getPlanDbId()

Specified by:

getPlanDbId in interface BuildIdentifier

Returns:

Id of the plan or empty if N/A.

getPlanKey

@NotNull
public @NotNull String getPlanKey()

Description copied from interface: BuildIdentifier

Full plan key (e.g. BAM-MAIN)

Specified by:

getPlanKey in interface BuildIdentifier

Returns:

Key for the plan BAM-MAIN

getTypedPlanKey

@NotNull
public @NotNull PlanKey getTypedPlanKey()

Description copied from interface: BuildIdentifier

Full plan key (e.g. BAM-MAIN)

Specified by:

getTypedPlanKey in interface BuildIdentifier

Returns:

Key for the plan BAM-MAIN

getPlanName

@NotNull
public @NotNull String getPlanName()

Description copied from interface: BuildIdentifier

The full name of the Plan

Specified by:

getPlanName in interface BuildIdentifier

Returns:

DescriptionProvider.getName()

getShortName

@NotNull
public @NotNull String getShortName()

Description copied from interface: BuildIdentifier

The short name of the Plan

Specified by:

getShortName in interface BuildIdentifier

Returns:

PlanIdentifier.getBuildName()

getBuildNumber

public int getBuildNumber()

Description copied from interface: BuildIdentifier

The build number being built

Specified by:

getBuildNumber in interface BuildIdentifier

Returns:

int

getBuildResultKey

@NotNull
public @NotNull String getBuildResultKey()

Description copied from interface: BuildIdentifier

Full build result key (e.g. BAM-MAIN-100)

Specified by:

getBuildResultKey in interface BuildIdentifier

Returns:

Key for build result

getPlanResultKey

@NotNull
public @NotNull PlanResultKey getPlanResultKey()

Description copied from interface: BuildIdentifier

Gets the PlanResultKey for the current BuildIdentifier

Specified by:

getPlanResultKey in interface BuildIdentifier

Returns:

planResultKey

getProjectName

@NotNull
public @NotNull String getProjectName()

Specified by:

getProjectName in interface BuildIdentifier

setVariableContext

public void setVariableContext(@NotNull
                               @NotNull VariableContext variableContext)

Specified by:

setVariableContext in interface BuildContext

getVcsRepositoryMap

@NotNull
public @NotNull Map<Long,PlanRepositoryDefinition> getVcsRepositoryMap()

Specified by:

getVcsRepositoryMap in interface CommonContext

getVcsRepositories

@NotNull
public @NotNull List<PlanRepositoryDefinition> getVcsRepositories()

Specified by:

getVcsRepositories in interface CommonContext

getEntityGroupId

public Long getEntityGroupId()

Description copied from interface: CommonContext

Returns id of a group entity belongs to. E.g. returns deployment project's id if entity is a deployment environment.

Specified by:

getEntityGroupId in interface CommonContext

Returns:

id of entity group or null if not applicable.

getMaximumBuildWarningsCount

public long getMaximumBuildWarningsCount()

Specified by:

getMaximumBuildWarningsCount in interface BuildContext

getDockerPipelineConfiguration

@NotNull
public @NotNull DockerPipelineConfiguration getDockerPipelineConfiguration()

Specified by:

getDockerPipelineConfiguration in interface CommonContext

getMasterPlanId

public Optional<Long> getMasterPlanId()

Specified by:

getMasterPlanId in interface BuildIdentifier

Returns:

id of the master plan or empty if plan has no master.

getMergeResult

@Nullable
public @Nullable MergeResultContext getMergeResult()

Description copied from interface: BuildContext

If a build performs merge, this method returns the result.

Specified by:

getMergeResult in interface BuildContext

setMergeResult

public void setMergeResult(@Nullable
                           @Nullable MergeResultContext mergeResult)

Specified by:

setMergeResult in interface BuildContext

getUuid

@NotNull
public @NotNull UUID getUuid()

Description copied from interface: BuildIdentifier

Id of the run. Allows to tell apart instances of build if a job is restarted.

Specified by:

getUuid in interface BuildIdentifier

isExpectingCustomDedicatedAgent

public boolean isExpectingCustomDedicatedAgent()

Description copied from interface: CommonContext

If this job is expected to be built on a custom dedicated agent

Specified by:

isExpectingCustomDedicatedAgent in interface CommonContext