TeamCity On-Premises 2026.2 Help

Kotlin スクリプト

Kotlin スクリプトランナーを使用すると、Windows、Linux、macOS で Kotlin(英語) スクリプトを実行できます。

一般的なビルドステップの設定については、 ビルドステップの設定を参照してください。

前提条件

このステップを実行するには、バージョン 1.3.70 以降の Kotlin(英語) コンパイラーを エージェントツールとしてインストールする必要があります。

Kotlin スクリプト設定

設定

説明

Kotlin コンパイラー

コンパイラーのバージョンを選択します: バンドル版またはデフォルトバージョンを使用するか、 ビルドチェックアウトディレクトリを基準としたコンパイラーへのカスタムパスを入力します。

スクリプトタイプ

次のオプションのいずれかを選択してください: ランナー内にカスタムスクリプト本体を直接入力するか、Kotlin スクリプトファイルへのパス (.kts) を指定します。

Kotlin スクリプト

カスタムスクリプト タイプで使用できます。

Kotlin スクリプトのコードを入力します。

スクリプトの機能を外部ライブラリで拡張するために、Maven 依存関係へのアノテーションベースの参照を使用できます。 例:

#!/usr/bin/env kotlin @file:Repository("https://maven.pkg.jetbrains.space/public/p/kotlinx-html/maven") @file:DependsOn("org.jetbrains.kotlinx:kotlinx-html-jvm:0.7.3") import kotlinx.html.*; import kotlinx.html.stream.*; import kotlinx.html.attributes.* val addressee = args.firstOrNull() ?: "World" print(createHTML().html { body { h1 { +"Hello, addressee!" } } }) ...

詳細は Kotlin ヘルプ(英語)を参照してください。

Kotlin スクリプトファイル

スクリプトファイル タイプで使用できます。

スクリプトファイルへのパスを、 ビルドチェックアウトディレクトリを基準にして入力します。

アノテーションベースの参照をサポートするには、提供されたファイルの拡張子が .main.kts である必要があります。

スクリプトパラメーター

コマンドラインのように、スクリプトのパラメーターを入力します。 パラメーター参照がサポートされています。

セキュリティ上の理由から、これらのパラメーターが安全な値を表す場合は、スクリプト内で直接パラメーター参照を使用しないことを強くお勧めします。 代わりに、スクリプトパラメーターを介してそのような値を渡すことができます。 例: トークン値を渡すには、「Password」型の 新しいビルドパラメーターを追加し 、ランナーの スクリプトパラメーターフィールドで参照します。

%access_token%

スクリプト内の引数として呼び出します。

val accessToken = args[0]

このようにして、スクリプト内の任意の場所でトークンの値を再利用できます。

この方法により、これらの値がビルド中にのみエージェントで使用できるようになります。 それ以外の場合、パラメーターがスクリプト内で直接指定されていると、スクリプト自体が保存されている限り、解決された値がエージェントマシンに保存され、データのセキュリティが損なわれる可能性があります。

JDK

スクリプトを実行するには、JDK を選択します。

  • デフォルト: JDK ホームへのパスは、エージェントマシン上の JAVA_HOME 環境変数から、または ビルドエージェント構成ファイル (ビルドエージェント.プロパティ) で指定された env.JAVA_HOME 環境変数 プロパティから読み取られます。 これらの値が指定されていない場合、TeamCity はビルドエージェントプロセス自体の Java Home を使用します。

  • カスタム: エージェントにインストールされている JDK へのパスを入力します。

  • インストールされている 番号によるバージョン で選択します。

JVM コマンドラインパラメーター

追加の JVM コマンドラインパラメーターを使用すると、初期および最大ヒープサイズの設定、追加のログの有効化、必要なバイトコード検証モードの選択などを行うことができます。

標準 (- で始まる、たとえば -verbose:[class|module|gc|jni] または --dry-run) と非標準 (-X で始まる、たとえば -Xmx<サイズ> または -XstartOnFirstThread) の両方の JVM オプションを指定できます。

複数のコマンドラインパラメーターを指定するには、区切り文字としてスペースを使用します。 例:

-verbose:gc -Xdiag -Xcomp -Xmx512m -Xms256m
2026 年 9 月 11 日