TeamCity Kotlin DSL/jetbrains.buildServer.configs.kotlin.projectFeatures/S3Storage

S3Storage

fun ProjectFeatures.s3Storage(init: S3Storage.() -> Unit): S3Storage

Amazon S3 Artifact Storage

Example. Adds new storage that allows TeamCity to store build artifacts in S3

project {
    // Other Project settings ...
    features {
        // Other Project Features ...
        s3Storage {
          id = "S3_STORAGE_ID"
          storageName = "Storage Name"

          bucketName = "Bucket_Name"
          bucketPrefix = "path/prefix"

          forceVirtualHostAddressing = true
          enableTransferAcceleration = false
          multipartThreshold = "8MB"
          multipartChunksize = "8MB"

          // AWS S3 storage requires configured Credentials
          connectionId = "AWS Connection ID"
        }
Content copied to clipboard
    }
}

Example. Adds new storage that allows TeamCity to store build artifacts in S3 and upload/download them using CloudFront

project {
    // Other Project settings ...
    features {
        // Other Project Features ...
        s3Storage {
          id = "S3_STORAGE_ID"
          storageName = "Storage Name"
          bucketName = "Bucket_Name"
          bucketPrefix = "path/prefix"
          forceVirtualHostAddressing = true
          multipartThreshold = "6MB"
          multipartChunksize = "8MB"
          connectionId = "AWS Connection ID"

          //CloudFront configuration
          cloudFrontEnabled = true
          cloudFrontUploadDistribution = "ID of CloudFront Distribution used for uploads"
          cloudFrontDownloadDistribution = "ID of CloudFront Distribution used for downloads"
          cloudFrontPublicKeyId = "ID of CloudFront public key"
          cloudFrontPrivateKey = "credentialsJSON:CloudFront-private-key-link"
        }
Content copied to clipboard
    }
}

Example. Adds new storage that allows TeamCity to store build artifacts in S3 and upload/download them with Transfer Acceleration

project {
    // Other Project settings ...
    features {
        // Other Project Features ...
        s3Storage {
          id = "S3_STORAGE_ID"
          storageName = "Storage Name"
          bucketName = "Bucket_Name"
          connectionId = "AWS Connection ID"

          // must be set to true to enable Transfer Acceleration
          forceVirtualHostAddressing = true
          enableTransferAcceleration = true
        }
Content copied to clipboard
    }
}

Example. S3 Storage. Disable integrity verification

project {
    // Other Project settings ...
    features {
        // Other Project Features ...
        s3Storage {
          id = "S3_STORAGE_ID"
          storageName = "Storage Name"
          bucketName = "Bucket_Name"
          connectionId = "AWS Connection ID"

          verifyIntegrityAfterUpload = false
        }
Content copied to clipboard
    }
}

Example. AWSEnvironment. Selects default environment with specific AWS region

awsEnvironment = default {
  awsRegionName = ""
}

Example. AWSEnvironment. Selects custom environment with specific region

awsEnvironment = custom {
  endpoint = "URL of custom endpoint"
  awsRegionName = "region"
}

Constructors

S3Storage

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

S3Storage

fun S3Storage()

Types

AwsEnvironment

sealed class AwsEnvironment : CompoundParam<S3Storage.AwsEnvironment>

Credentials

sealed class Credentials : CompoundParam<S3Storage.Credentials>

Functions

accessKeys

fun accessKeys(): S3Storage.Credentials.AccessKeys

Use pre-configured AWS account access keys

booleanParameter

fun booleanParameter( customName: String? = null, trueValue: String? = "true", falseValue: String? = "false"): <ERROR CLASS><Parametrized, <ERROR CLASS><Parametrized, T?>>

clear

fun clear()

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): <ERROR CLASS><Parametrized, <ERROR CLASS><Parametrized, T?>>

copyParamsTo

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

Copies parameters of this object to the specified target

create

open fun create(): ProjectFeature

Creates an instance of this project feature 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.

custom

fun custom(init: S3Storage.AwsEnvironment.Custom.() -> Unit = {}): S3Storage.AwsEnvironment.Custom

default

fun default(init: S3Storage.AwsEnvironment.Default.() -> Unit = {}): S3Storage.AwsEnvironment.Default

doubleParameter

fun doubleParameter(customName: String? = null): <ERROR CLASS><Parametrized, <ERROR CLASS><Parametrized, T?>>

enumParameter

fun <E : Enum<E>> enumParameter(customName: String? = null, mapping: Map<E, String?>? = null): <ERROR CLASS><Parametrized, <ERROR CLASS><Parametrized, T?>>

findRawParam

fun findRawParam(paramName: String): Parameter?

hasParam

fun hasParam(paramName: String): Boolean

intParameter

fun intParameter(customName: String? = null): <ERROR CLASS><Parametrized, <ERROR CLASS><Parametrized, T?>>

param

fun param(name: String, value: String)

Adds parameter with specified name and value

removeRawParam

fun removeRawParam(paramName: String)

stringParameter

open fun stringParameter(customName: String? = null): <ERROR CLASS><Parametrized, <ERROR CLASS><Parametrized, T?>>

temporary

fun temporary(init: S3Storage.Credentials.Temporary.() -> Unit = {}): S3Storage.Credentials.Temporary

Get temporary access keys via AWS STS

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

accessKey

var accessKey: <ERROR CLASS>

AWS account secret access key

accessKeyID

var accessKeyID: <ERROR CLASS>

AWS account access key ID

awsEnvironment

var awsEnvironment: <ERROR CLASS>

bucketName

var bucketName: <ERROR CLASS>

Bucket name

bucketPrefix

var bucketPrefix: <ERROR CLASS>

Bucket path prefix

cloudFrontDownloadDistribution

var cloudFrontDownloadDistribution: <ERROR CLASS>

Name of CloudFront distribution for downloads

cloudFrontEnabled

var cloudFrontEnabled: <ERROR CLASS>

Whether to use CloudFront for artifact transport

cloudFrontPrivateKey

var cloudFrontPrivateKey: <ERROR CLASS>

Private key that corresponds to chosen public key

cloudFrontPublicKeyId

var cloudFrontPublicKeyId: <ERROR CLASS>

Id of Public Key in CloudFront that has access to selected distribution

cloudFrontUploadDistribution

var cloudFrontUploadDistribution: <ERROR CLASS>

Name of CloudFront distribution for uploads

connectionId

var connectionId: <ERROR CLASS>

The ID of configured AWS Connection to access the AWS S3. @see AwsConnection

credentials

var credentials: <ERROR CLASS>

enablePresignedURLUpload

var enablePresignedURLUpload: <ERROR CLASS>

Whether to use Pre-Signed URLs to upload

enableTransferAcceleration

var enableTransferAcceleration: <ERROR CLASS>

Whether to enable Transfer Acceleration

forceVirtualHostAddressing

var forceVirtualHostAddressing: <ERROR CLASS>

Whether to force Virtual Host Addressing

var id: String? = null

Project feature id, if not specified will be generated

multipartChunksize

var multipartChunksize: <ERROR CLASS>

Specify the maximum allowed part size. Minimum value is 5MB. Allowed suffixes: KB, MB, GB, TB. Leave empty to use the default value.

multipartThreshold

var multipartThreshold: <ERROR CLASS>

Initiates multipart upload for files larger than the specified value. Minimum value is 5MB. Allowed suffixes: KB, MB, GB, TB. Leave empty to use the default value.

params