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: String?

AWS account secret access key

accessKeyID

var accessKeyID: String?

AWS account access key ID

awsEnvironment

var awsEnvironment: S3Storage.AwsEnvironment?

bucketName

var bucketName: String?

Bucket name

bucketPrefix

var bucketPrefix: String?

Bucket path prefix

cloudFrontDownloadDistribution

var cloudFrontDownloadDistribution: String?

Name of CloudFront distribution for downloads

cloudFrontEnabled

var cloudFrontEnabled: Boolean?

Whether to use CloudFront for artifact transport

cloudFrontPrivateKey

var cloudFrontPrivateKey: String?

Private key that corresponds to chosen public key

cloudFrontPublicKeyId

var cloudFrontPublicKeyId: String?

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

cloudFrontUploadDistribution

var cloudFrontUploadDistribution: String?

Name of CloudFront distribution for uploads

connectionId

var connectionId: String?

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

credentials

var credentials: S3Storage.Credentials?

enablePresignedURLUpload

var enablePresignedURLUpload: Boolean?

Whether to use Pre-Signed URLs to upload

enableTransferAcceleration

var enableTransferAcceleration: Boolean?

Whether to enable Transfer Acceleration

forceVirtualHostAddressing

var forceVirtualHostAddressing: Boolean?

Whether to force Virtual Host Addressing

var id: String?

Project feature id, if not specified will be generated

multipartChunksize

var multipartChunksize: String?

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: String?

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: String?

Storage name

type

var type: String

Project feature type

useDefaultCredentialProviderChain

var useDefaultCredentialProviderChain: Boolean?

Use default credential provider chain

verifyIntegrityAfterUpload

var verifyIntegrityAfterUpload: Boolean?

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"): DelegateProvider<Boolean?>

clear

fun clear()

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): DelegateProvider<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