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

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

constructor()

Types

AwsEnvironment

sealed class AwsEnvironment : CompoundParam<S3Storage.AwsEnvironment>

Credentials

sealed class Credentials : CompoundParam<S3Storage.Credentials>

Properties

accessKey

var accessKey: <Error class: unknown class>

AWS account secret access key

accessKeyID

var accessKeyID: <Error class: unknown class>

AWS account access key ID

awsEnvironment

var awsEnvironment: <Error class: unknown class>

bucketName

var bucketName: <Error class: unknown class>

Bucket name

bucketPrefix

var bucketPrefix: <Error class: unknown class>

Bucket path prefix

cloudFrontDownloadDistribution

var cloudFrontDownloadDistribution: <Error class: unknown class>

Name of CloudFront distribution for downloads

cloudFrontEnabled

var cloudFrontEnabled: <Error class: unknown class>

Whether to use CloudFront for artifact transport

cloudFrontPrivateKey

var cloudFrontPrivateKey: <Error class: unknown class>

Private key that corresponds to chosen public key

cloudFrontPublicKeyId

var cloudFrontPublicKeyId: <Error class: unknown class>

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

cloudFrontUploadDistribution

var cloudFrontUploadDistribution: <Error class: unknown class>

Name of CloudFront distribution for uploads

connectionId

var connectionId: <Error class: unknown class>

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

credentials

var credentials: <Error class: unknown class>

enablePresignedURLUpload

var enablePresignedURLUpload: <Error class: unknown class>

Whether to use Pre-Signed URLs to upload

enableTransferAcceleration

var enableTransferAcceleration: <Error class: unknown class>

Whether to enable Transfer Acceleration

forceVirtualHostAddressing

var forceVirtualHostAddressing: <Error class: unknown class>

Whether to force Virtual Host Addressing

var id: String?

Project feature id, if not specified will be generated

multipartChunksize

var multipartChunksize: <Error class: unknown 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: unknown 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

val params: List<Parameter>

storageName

var storageName: <Error class: unknown class>

Storage name

type

var type: String

Project feature type

useDefaultCredentialProviderChain

var useDefaultCredentialProviderChain: <Error class: unknown class>

Use default credential provider chain

verifyIntegrityAfterUpload

var verifyIntegrityAfterUpload: <Error class: unknown class>

Whether to verify integrity of artifacts after upload

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: unknown class><Parametrized, <Error class: unknown class><Parametrized, T?>>

clear

fun clear()

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): <Error class: unknown class><Parametrized, <Error class: unknown 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: unknown class><Parametrized, <Error class: unknown class><Parametrized, T?>>

enumParameter

fun <E : Enum<E>> enumParameter(customName: String? = null, mapping: Map<E, String?>? = null): <Error class: unknown class><Parametrized, <Error class: unknown class><Parametrized, T?>>

findRawParam