TeamCity Kotlin DSL

TeamCity Kotlin DSL/jetbrains.buildServer.configs.kotlin/Triggers

Triggers

class Triggers : Validatable

Collection of build triggers in build configuration or template.

See also triggers().

Example. VCS trigger which triggers builds only in the default branch

See also Vcs Trigger

triggers {
    vcs {
        branchFilter = "+:<default>"
    }
}

Example. Schedule trigger executing once per day at 9AM

See also Schedule Trigger

triggers {
    schedule {
        schedulingPolicy = daily {
            hour = 9
        }
        triggerBuild = always()
        withPendingChangesOnly = false
    }
}

Example. Retry build

Retries a failed build with the same settings and the same revisions. See also Retry build trigger

triggers {
    retryBuild {
        attempts = 2
        retryWithTheSameRevisions = true

        enforceCleanCheckout = true
        enforceCleanCheckoutForDependencies = true
        buildParams {
            param("param1", "value1")
            param("param2", "%build.number%")
        }
    }
}

Constructors

Functions

fun trigger(trigger: Trigger)

Adds the specified trigger

fun trigger(init: Trigger.() -> Unit): Trigger

Adds a trigger initialized with the specified init block

open override fun validate(consumer: ErrorConsumer)

Validates this object and reports found errors to the provided consumer

Extensions

branchRemoteRun

fun Triggers.branchRemoteRun(init: BranchRemoteRunTrigger.() -> Unit = {})

Adds a Branch Remote Run Trigger which triggers a new personal build each time TeamCity detects changes in particular branches

fun Triggers.copy(): Triggers

Copies the receiver triggers

fun Triggers.copyTo(target: Triggers): Triggers

Copies the receiver triggers to the specified target

finishBuildTrigger

fun Triggers.finishBuildTrigger(init: FinishBuildTrigger.() -> Unit): FinishBuildTrigger

Adds Finish Build Trigger to build configuration or template

fun Triggers.mavenArtifact(init: MavenArtifactDependencyTrigger.() -> Unit): MavenArtifactDependencyTrigger

Adds a trigger. running builds when there is a modification of the maven dependency content.

fun Triggers.mavenSnapshot(init: MavenSnapshotDependencyTrigger.() -> Unit): MavenSnapshotDependencyTrigger

Adds a trigger running builds when there is a modification of the snapshot dependency content in the remote repository.

nuGetDependency

fun Triggers.nuGetDependency(init: NuGetDependency.() -> Unit): NuGetDependency

Adds The NuGet Dependency Trigger

perforceShelveTrigger

fun Triggers.perforceShelveTrigger(init: PerforceShelveTrigger.() -> Unit): PerforceShelveTrigger

Adds Perforce Build Trigger to build configuration or template

fun Triggers.retryBuild(init: RetryBuildTrigger.() -> Unit): RetryBuildTrigger

Adds Retry Build Trigger

fun Triggers.schedule(init: ScheduleTrigger.() -> Unit): ScheduleTrigger

Adds Schedule Build Trigger to build configuration or template

fun Triggers.vcs(init: VcsTrigger.() -> Unit): VcsTrigger

Adds VCS trigger to the build configuration or template