TeamCity Kotlin DSL/jetbrains.buildServer.configs.kotlin.buildSteps/ExecBuildStep

ExecBuildStep

fun BuildSteps.exec(init: ExecBuildStep.() -> Unit): ExecBuildStep

A build step running the specified executable with given arguments

Example. Runs an executable in the checkout directory.

buildType {
    // Other Build Type settings ...
    steps {
        // Other Build Steps ...
        exec {
            path = "run.sh"
        }
Content copied to clipboard
    }
}

Example. Runs an executable in the specified build working directory with an argument referencing to the configuration parameter. Any of stderr output will be treated as errors.

buildType {
    // Other Build Type settings ...
    steps {
        // Other Build Steps ...
        exec {
            name = "Execute tests"
            workingDir = "tests"
            path = "run_tests.sh"
            arguments = "%product.version%"
            formatStderrAsError = true
        }
Content copied to clipboard
    }
}

Example. Runs an executable in the specified build working directory in the specified Docker container with an argument referencing to the configuration parameter.

buildType {
    // Other Build Type settings ...
    steps {
        // Other Build Steps ...
        exec {
            name = "Execute tests in Docker"

            workingDir = "tests"
            path = "run_tests.sh"
            arguments = "%product.version%"
            formatStderrAsError = true

            dockerImage = "nodejs:lts"
            dockerImagePlatform = ScriptBuildStep.ImagePlatform.Linux
            dockerRunParameters = "--rm --interactive=false"
        }
Content copied to clipboard
    }
}

Constructors

ExecBuildStep

fun ExecBuildStep(init: ExecBuildStep.() -> Unit)

ExecBuildStep

fun ExecBuildStep()

Types

ImagePlatform

enum ImagePlatform : Enum<ExecBuildStep.ImagePlatform>

Docker image platforms

Functions

booleanParameter

fun booleanParameter( customName: String? = null, trueValue: String? = "true", falseValue: String? = "false"): SingleDelegateProvider<Boolean>

clear

fun clear()

clearConditions

fun clearConditions()

Deletes all configured build step conditions

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): CompoundDelegateProvider<T>

conditions

fun conditions(init: BuildStepConditions.() -> Unit = {})

Configures build step conditions

copyParamsTo

fun <T : Parametrized> copyParamsTo(target: T): T

Copies parameters of this object to the specified target

create

open fun create(): BuildStep

Creates an instance of this build step 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.

doubleParameter

fun doubleParameter(customName: String? = null): SingleDelegateProvider<Double>

enumParameter

fun <E : Enum<E>> enumParameter(customName: String? = null, mapping: Map<E, String?>? = null): SingleDelegateProvider<E>

findRawParam

fun findRawParam(paramName: String): Parameter?

hasParam

fun hasParam(paramName: String): Boolean

intParameter

fun intParameter(customName: String? = null): SingleDelegateProvider<Int>

param

fun param(name: String, value: String)

Adds parameter with specified name and value

removeRawParam

fun removeRawParam(paramName: String)

stringParameter

fun stringParameter(customName: String? = null): SingleDelegateProvider<String>

toString

open override fun toString(): String

validate

open override fun validate(consumer: ErrorConsumer)

Validates this object and reports found errors to the provided consumer

Properties

arguments

var arguments: String?

A space-separated arguments list for the executable

conditions

var conditions: BuildStepConditions

Optional collection of build step execution conditions

dockerImage

var dockerImage: String?

Specifies which Docker image to use for running this build step. I.e. the build step will be run inside specified docker image, using 'docker run' wrapper.

dockerImagePlatform

var dockerImagePlatform: ExecBuildStep.ImagePlatform?

Specifies which Docker image platform will be used to run this build step.

dockerPull

var dockerPull: Boolean?

If enabled, "pull image" command will be run before docker run.

dockerRunParameters

var dockerRunParameters: String?

Additional docker run command arguments

enabled

var enabled: Boolean = true

Specifies whether the step is enabled, true by default

executionMode

var executionMode: BuildStep.ExecutionMode

Build step execution mode

formatStderrAsError

var formatStderrAsError: Boolean?

Log stderr output as errors in the build log

var id: String? = null

Optional id of the step. Usually the id is not required, however if a build configuration inherits from a template and wants to override a build step defined there, then both steps should have the same id.

name

var name: String

Build step name

params