Kotlin スクリプト
Kotlin スクリプトランナーを使用すると、Windows、Linux、macOS で Kotlin(英語) スクリプトを実行できます。
一般的なビルド手順の設定の説明については、ビルドステップの設定を参照してください。
前提条件
このステップを実行するには、バージョン 1.3.70 以降の Kotlin(英語) コンパイラーをエージェントツールとしてインストールする必要があります。
Kotlin スクリプト設定
設定 | 説明 |
|---|---|
Kotlin コンパイラー | コンパイラーのバージョンを選択します。バンドルまたはデフォルトのバージョンを使用するか、ビルドチェックアウトディレクトリを基準にしてコンパイラーへのカスタムパスを入力します。 |
スクリプトタイプ | 2 つのオプションのいずれかを選択します。ランナーのすぐ内側にカスタムスクリプト本体を入力するか、Kotlin スクリプトファイル（ |
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 スクリプトファイル | スクリプトファイルタイプで使用できます。 ビルドチェックアウトディレクトリを基準にした、スクリプトファイルへのパスを入力します。 アノテーションベースの参照をサポートするには、提供されたファイルの拡張子が |
スクリプトパラメーター | コマンドラインのように、スクリプトのパラメーターを入力します。パラメーター参照がサポートされています。 セキュリティ上の理由から、これらのパラメーターが安全な値を表す場合は、スクリプト内で直接パラメーター参照を使用しないことを強くお勧めします。代わりに、スクリプトパラメーターを介してそのような値を渡すことができます。例: トークン値を渡すには、「Password」型の新しいビルドパラメーターを追加し、ランナーのスクリプトパラメーターフィールドで参照します。
スクリプト内の引数として呼び出します。
このようにして、スクリプト内の任意の場所でトークンの値を再利用できます。 この方法により、これらの値がビルド中にのみエージェントで使用できるようになります。それ以外の場合、パラメーターがスクリプト内で直接指定されていると、スクリプト自体が保存されている限り、解決された値がエージェントマシンに保存され、データのセキュリティが損なわれる可能性があります。 |
JDK | スクリプトを実行するには、JDK を選択します。
|
JVM コマンドラインパラメーター | 追加の JVM コマンドラインパラメーターを使用すると、初期および最大ヒープサイズの設定、追加のログの有効化、必要なバイトコード検証モードの選択などを行うことができます。 標準 ( 複数のコマンドラインパラメーターを指定するには、区切り文字としてスペースを使用します。例:
-verbose:gc -Xdiag -Xcomp -Xmx512m -Xms256m
|
関連ページ：
ビルドステップの設定
ビルドステップは、CI/CD ワークフローの最小単位です。ビルドステップは、全体として実行される一連のアクションを定義します。ビルドステップは、ビルド構成とパイプラインジョブに属します。構成とパイプラインのビルドステップ：TeamCity は、.NET、Maven、NAnt、Xcode などの特定のビルドツール用に設計された幅広いビルドステップを提供します。現在、ビルド構成ではすべてのステップが利用可能です。バージョン 2025.07 で導入された
エージェントツールのインストール
TeamCity では、エージェントツールは、エージェントを構築するためのファイルをディストリビューションするためだけに使われるプラグインの一種です。エージェントツールは、ファイルのセットまたはバイナリディストリビューションになります。そのクラスはランタイムにロードされません。TeamCity を使用すると、サーバー上で追加のツールをインストール / 削除し、オンデマンドでエージェントを構築するために配布することができます。ビルドエージェントが多数ある環境では、構成ファイルのディストリビューショ...
アップグレードノート
2025.11.2 から 2025.11.3 への変更：付属ツールのアップデートバンドルされた Git は、サーバーとエージェントの両方の Docker イメージでバージョン 2.53 に更新されました。TeamCity イメージで提供された Docker には、ビルドスクリプトで直接参照したいユーザーのためにリリース間の一貫性を確保するために、999 の固定 GID が付与されるようになりました。2025.11.1 から 2025.11.2 への変更：ユーザーの UID を復元するため、Te...
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は次の 3 種類のパラメーターをサポートします。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...
Maven
Maven ビルドステップでは、ビルドを自動化するために Apache Maven を使用できます。ステップ設定：Maven ステップ設定のリストとそれに対応する UI ラベルは、ビルド構成を構成するかパイプラインを構成するかによって若干異なります。メイン設定ゴール TeamCity で実行させたい Maven ゴールをスペースで区切ってリストします。一部の Maven ゴールはバージョン管理システムを使用できるため、一部の VCS チェックアウトモードゴールと互換性がなくなる可能性があります。このよう...