パイプライン Kotlin DSL
TeamCity 2026.1 では、設定を Kotlin DSL 形式で保存しているプロジェクトが所有するパイプラインは、設定を自動的に Kotlin 形式に変換できます。おなじみのビジュアル /YAML 切り替えスイッチには、新たに Kotlin DSL タブが表示されます。

これにより、パイプラインに「ギャップ」のない、完全なプロジェクト DSL を実現できます。
DSL 互換モード
パイプラインを含むプロジェクトでバージョン管理された設定を有効にすると、パイプラインが設定を保存する場所によっては、いくつかの制限が生じます。
プロジェクトのバージョン管理設定を有効にした際に、メインパイプラインリポジトリがサーバー上に YAML を保存していた場合、VCS リポジトリモードに切り替わり、TeamCity UI 経由で部分的に編集可能になります。ビジュアルタブまたは YAML タブで行った編集は自動的に DSL に変換されますが、自動的に保存またはコミットすることはできません。新しい変更に関連する生成された DSL をコピーし、プロジェクトの
.ktsファイルに手動でコミットしてください。コミットするまで、パイプラインの現在の構成がリモートファイルに保存されている構成と一致しないため、パイプラインは実行できません。メインリポジトリがすでに設定ファイルをリモート YAML ファイルとして保存している場合、パイプラインは TeamCity UI を介して完全に編集可能です。ただし、プロジェクトの
.ktsファイルにはこのパイプラインの Kotlin DSL は含まれないため、プロジェクト設定ファイルは不完全なままとなります。
パイプライン DSL エンティティ
パイプライン固有のクラスは、 jetbrains.buildServer.configs.kotlin.pipelines (英語) 名前空間で宣言されます。この名前空間の主要オブジェクトは次のとおりです。
- パイプライン
パイプラインを表します。
DSL ドキュメント: パイプライン (英語)
- ジョブ
作業を表します。
DSL ドキュメント: ジョブ (英語)
- リポジトリ
パイプラインジョブが処理できるリポジトリを表します。パイプライン設定 | リポジトリの各エントリは
PipelineRepositoryEntryインスタンスに対応し、ジョブはJobRepositoryEntryオブジェクトを操作します。DSL ドキュメント: PipelineRepositoryEntry(英語) | JobRepositoryEntry(英語)
- ファイル公開
アーティファクトとして公開するファイル、共有ファイル(下流ジョブと共有するファイル)、またはその両方として公開するファイルを指定します。
DSL ドキュメント: FilePublication(英語)
関連ページ:
Kotlin DSL
TeamCity では、バージョン管理で設定を XML 形式で保存するだけでなく、DSL (Kotlin 言語に基づく) で設定を保存することもできます。バージョン管理に保存された DSL を使用すると、プログラムで設定を定義できます。Kotlin は静的に型指定されるため、IDE で自動補完機能を自動的に受け取ります。これにより、利用可能な API オプションの発見がはるかに簡単になります。TeamCity での Kotlin DSL の使用に関するブログ投稿シリーズと推奨リファクタリングの記...
パイプライン設定
この記事では、パイプライン全体に使用できる、共通のパイプラインの動作を指定する設定について説明します。パイプライン設定の編集:コアパイプライン設定を表示および編集するには、右上隅の設定トグルをクリックし、ビジュアルエディターでジョブを囲むパイプラインキャンバス領域内の任意の場所をクリックします。ビジュアルエディターからコードに切り替えて、マークアップを直接編集することもできます。パラメーター:パラメーターは、生の値を参照に置き換えるために設計された名前と値のペアです。TeamCity はパラ
パイプライン YAML
以下は TeamCity パイプラインの完全な YAML 仕様です。パイプラインは活発に進化しているため、将来のリリースで仕様が変更される可能性があります。{
TeamCity パイプラインロードマップ
パイプラインは、より直感的なビジュアルインターフェースで、お馴染みの TeamCity エクスペリエンスを刷新します。パイプラインはこれまでと同じ信頼性の高いバックエンドを採用していますが、従来のアプローチから意図的に脱却し、コアコンセプトを簡素化し、根本から再設計しました。このアプローチは、取り組みが進展するにつれて成果を上げていくと期待していますが、現状ではパイプラインのカスタマイズ性と機能の選択肢が従来のビルド構成に比べて限られています。次に優先すべき領域を決定するにあたり、皆様からのフィ...