TeamCity Kotlin DSL 2025.11/jetbrains.buildServer.configs.kotlin.pipelines/Job

Job

Deprecated

Pipelines DSL is in development and should not be used. Breaking changes are expected.

Represents a job within a TeamCity pipeline.

A job is a unit of work in a pipeline that performs a specific task, such as building, testing, or deploying. Jobs can have dependencies on other jobs, allowing for complex workflows.

The id and name are mandatory properties for a valid job (id can be omitted if it matches the class name).

Job settings are grouped into blocks:

steps() - configures the steps for the job
params() - configures job parameters
outputParam() - defines job output parameters
dependency() - defines job dependencies
filePublication() - configures file publications
repository() - configures repositories for the job

Example. Basic job with build steps

job("build") {
  name = "Build Application"

  steps {
    gradle {
      tasks = "clean build"
      buildFile = "build.gradle"
    }
  }
}

Example. Job with dependencies and parameters

job("deploy") {
  name = "Deploy Application"

  params {
    param("env.DEPLOY_ENV", "production")
  }

  steps {
    script {
      scriptContent = "deploy.sh"
    }
  }

  dependency("build")
  dependency("test")
}

Constructors

Job

constructor(init: Job.() -> Unit)

Creates a job and initializes it with the specified init block.

constructor()

Types

Dependency

class Dependency(val job: String, val files: List<String>? = null)

Represents a dependency on another job.

FilePublication

class FilePublication(val path: String, val publishArtifact: Boolean = false, val shareWithJobs: Boolean = true)

Represents a file publication configuration.

Repository

class Repository(val root: IdOwner, val enabled: Boolean = true, val path: String? = null, val branch: String? = null)

Represents a repository used by the job.

Properties

allowReuse

var allowReuse: Boolean?

Allow reuse

dependencies

val dependencies: MutableList<Job.Dependency>

Job dependencies

enableDependencyCacheOptimization

var enableDependencyCacheOptimization: Boolean?

Enable dependency cache optimization

filesPublication

val filesPublication: MutableList<Job.FilePublication>

Job file publications

var id: String

integrations

val integrations: MutableList<JobIntegration>

Job integrations

name

var name: String

Job name

outputParams

val outputParams: OutputParameters

Job output parameters

parallelism

var parallelism: Int?

Job parallelism determines parallelism level for this job

params

val params: ParametrizedWithType

Job parameters

repositories

val repositories: MutableList<Job.Repository>

Job repositories

steps

val steps: PipelineSteps

Functions

create

open fun create(): Job

Creates an instance of this job via reflection using a no argument constructor, used during copying. Throws an error if this class doesn't have a default constructor. Subclasses can override it to create an instance without using a default constructor.

dependency

fun dependency(job: Job)

Adds a dependency on the specified job

fun dependency(jobId: String)

Adds a dependency on a job with the specified id.

fun dependency(job: Job, files: List<String>)

Adds a dependency on the specified job with a list of files

fun dependency(jobId: String, files: List<String>)

Adds a dependency on a job with the specified id and a list of files.

filePublication

fun filePublication(path: String)

Adds a file publication with the specified path.