com.atlassian.bamboo.specs.api.builders.plan

Class Job

java.lang.Object

com.atlassian.bamboo.specs.api.builders.EntityPropertiesBuilder<JobProperties>

com.atlassian.bamboo.specs.api.builders.plan.Job

public class Job
extends EntityPropertiesBuilder<JobProperties>

Represents a Bamboo job. Job is a unit of work within Stage that can be run parallel to other jobs if multiple agents are available. When executing several jobs on single agents, order in which jobs from single stage are executed is not defined.

Constructor Summary

Constructors

Constructor and Description
Job(@NotNull Job copy)
Job(@NotNull String name, @NotNull BambooKey key) Specify job with given name and key.
Job(@NotNull String name, @NotNull String key) Specify job with given name and key.

Method Summary

Modifier and Type	Method and Description
Job	artifacts(Artifact... artifacts) Adds provided Artifacts to the list of artifacts produced by the job.
Job	artifactSubscriptions(ArtifactSubscription... subscriptions) Add artifact subscriptions.
protected JobProperties	build()
Job	cleanWorkingDirectory(boolean cleanWorkingDirectory) Specifies if job should clean working directory after executing.
Job	description(@Nullable String description) Sets the job's description.
Job	dockerConfiguration(@NotNull DockerConfiguration dockerConfiguration) Configure Docker for this job.
Job	enabled(boolean enabled) Enables/disables the job.
Job	finalTasks(Task<?,?>... finalTasks) Adds provided Tasks to the list of the final tasks executed by the job.
@NotNull BambooKey	getKey() Returns job's key, which serves as identifier for this object.
Job	key(@NotNull BambooKey key) Sets the job's key.
Job	key(@NotNull String key) Sets the job's key.
Job	name(@NotNull String name) Sets the job's name.
Job	noPluginConfigurations() Deprecated.
Job	pluginConfigurations(PluginConfiguration<?>... pluginConfigurations) Appends plugin configuration to the plan.
Job	requirements(Requirement... requirements) Adds custom requirements to the job.
Job	tasks(Task<?,?>... tasks) Adds provided Tasks to the list of tasks executed by the job.

Methods inherited from class java.lang.Object

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

Constructor Detail

Job

public Job(@NotNull
           @NotNull Job copy)

Job

public Job(@NotNull
           @NotNull String name,
           @NotNull
           @NotNull String key)
    throws PropertiesValidationException

Specify job with given name and key.

If oid is not specified, key serves as a job identifier. If a job with specified key does not exist, a new one is created. If it does exists it is updated, it can also be moved between stages.

Parameters:

name - job's name

key - job's short key, must be unique within the plan.

Throws:

PropertiesValidationException

Job

public Job(@NotNull
           @NotNull String name,
           @NotNull
           @NotNull BambooKey key)
    throws PropertiesValidationException

Specify job with given name and key.

If oid is not specified, key serves as a job identifier. If a job with specified key does not exist, a new one is creted. If it does exists it is updated, it can also be moved between stages.

Parameters:

name - job's name

key - job's short key, must be unique within the plan.

Throws:

PropertiesValidationException

Method Detail

name

public Job name(@NotNull
                @NotNull String name)
         throws PropertiesValidationException

Sets the job's name.

Throws:

PropertiesValidationException

key

public Job key(@NotNull
               @NotNull String key)
        throws PropertiesValidationException

Sets the job's key.

If oid is not specified, key serves as a job identifier. If a job with specified key does not exist, a new one is created. If it does exists it is updated, it can also be moved between stages.

Parameters:

key - job's short key, must be unique within the plan.

Throws:

PropertiesValidationException

key

public Job key(@NotNull
               @NotNull BambooKey key)
        throws PropertiesValidationException

Sets the job's key.

If oid is not specified, key serves as a job identifier. If a job with specified key does not exist, a new one is created. If it does exists it is updated, in particular it can be moved between stages.

Parameters:

key - job's short key, must be unique within the plan.

Throws:

PropertiesValidationException

description

public Job description(@Nullable
                       @Nullable String description)
                throws PropertiesValidationException

Sets the job's description.

Throws:

PropertiesValidationException

enabled

public Job enabled(boolean enabled)
            throws PropertiesValidationException

Enables/disables the job.

Throws:

PropertiesValidationException

artifacts

public Job artifacts(@NotNull
                     Artifact... artifacts)

Adds provided Artifacts to the list of artifacts produced by the job.

artifactSubscriptions

public Job artifactSubscriptions(@NotNull
                                 ArtifactSubscription... subscriptions)

Add artifact subscriptions. Subscription can only be defined for shared artifacts.

Artifact subscription specify which subsequent jobs rely on this artifact.

tasks

public Job tasks(@NotNull
                 Task<?,?>... tasks)

Adds provided Tasks to the list of tasks executed by the job.

finalTasks

public Job finalTasks(@NotNull
                      Task<?,?>... finalTasks)

Adds provided Tasks to the list of the final tasks executed by the job.

Final tasks for a job are always executed, even if previous tasks in the job failed.

requirements

public Job requirements(Requirement... requirements)

Adds custom requirements to the job.

Requirements control which Bamboo agents are able to execute the job.

cleanWorkingDirectory

public Job cleanWorkingDirectory(boolean cleanWorkingDirectory)

Specifies if job should clean working directory after executing.

pluginConfigurations

public Job pluginConfigurations(@NotNull
                                PluginConfiguration<?>... pluginConfigurations)

Appends plugin configuration to the plan. If the same plugin is specified second time, its configuration is overwritten.

noPluginConfigurations

@Deprecated
public Job noPluginConfigurations()

Deprecated.

Use this method to specify that your job has default plugins configuration.

dockerConfiguration

public Job dockerConfiguration(@NotNull
                               @NotNull DockerConfiguration dockerConfiguration)

Configure Docker for this job.

See Also:

DockerConfiguration

getKey

@NotNull
public @NotNull BambooKey getKey()

Returns job's key, which serves as identifier for this object.

Throws:

IllegalStateException - if key is undefined

build

protected JobProperties build()
                       throws PropertiesValidationException

Specified by:

build in class EntityPropertiesBuilder<JobProperties>

Throws:

PropertiesValidationException