DSL のアップグレード

TeamCity XML 設定フォーマットは通常、メジャーリリースで変更されます。サーバー更新後の最初の起動時に、TeamCity は TeamCity データディレクトリ内の XML 設定ファイルを新しいフォーマットに変換します。設定が Kotlin DSL に保存されている場合、機能を維持するために Kotlin コードを変更する必要がある場合があります。また、Kotlin コードを最新の構成バージョンに更新することもお勧めします。

これらの推奨事項は、サーバー管理 UI の対応するページにサーバーヘルスレポートとして表示されます。

TeamCity 設定フォーマットの変更

DSL に関しては、TeamCity 設定の変更には次の種類があります。

自動で実行できる変更

この種類の設定変更では Kotlin DSL を変更する必要はありません。DSL から設定が再生成されるたびに、サーバーによって変更が自動で適用されるためです。
ただし、パフォーマンスへの影響を減らし、Kotlin スクリプトを UI に表示される設定に近づけるために、DSL を新しい configs バージョンに更新することをお勧めします。

TeamCity 設定の多くの変更はこのカテゴリに分類されます。たとえば、ビルドステップを実装するプラグインによってパラメーター名が変更される場合があります。
以前の TeamCity バージョンの DSL は古い名前のパラメーターを生成しますが、TeamCity は DSL 実行後に古いパラメーター名を新しい名前に自動で置き換えることができます。

自動で実行できない変更

一部の TeamCity 設定の変更には外部情報が必要であり、自動では実行できません。たとえば、TeamCity 10.0 では、クラウド統合の設定は VCS にコミットされていない専用ファイルに保存されていました。 TeamCity 2017.1 では、これらの設定はプロジェクトレベルに移動されました。 TeamCity は外部データなしでこのような設定の変換を自動で実行できないため、DSL コードを手動で更新する必要があります。

DSL コード内のバージョン

構成バージョン

これは settings.kts で指定されたバージョンで、次のようになります。

version = "2025.11"

TeamCity はこのバージョンを使用して DSL 実行後に変換を実行し、結果として得られる XML 構成ファイルを、適用先の現在の TeamCity バージョンに合わせて最新の状態にします。たとえば、DSL スクリプトは TeamCity 2017.2 によって生成され、バージョンが 2017.2 に設定されている場合があります。サーバーをバージョン 2022.04 にアップグレードすると、TeamCity は DSL を実行し、追加の変換を適用して、最新バージョンで想定されるフォーマットに従って設定を変更します。

Kotlin DSL API バージョン

2022.04 より前に TeamCity によって生成された DSL コードでは、DSL API バージョンがパッケージ名にエンコードされています。例: jetbrains.buildServer.configs.kotlin.v2019_2。そこにある v2019_2 部分は、この DSL API が導入された TeamCity バージョンに対応しています。

DSL API に重大な互換性のない変更があった場合、新しい DSL API バージョンが導入されます。ただし、TeamCity 2019.2 以降は互換性のない変更はありませんでした。そのため、その後のいくつかの TeamCity バージョンでも、新しく生成された DSL コードに同じ v2019_2 パッケージ名が使用されていました。 TeamCity 2022.04 以降では互換性のない変更がないため、DSL API バージョンは冗長であると見なされ、このバージョンを含まないパッケージへの切り替えを実行することをお勧めします。

アップグレード後にバージョン付き設定を有効にする

バージョン付き設定が Kotlin フォーマットで保存されている場合、TeamCity サーバーを新しいバージョンにアップグレードすると、DSL コードが機能し続けるように自動で更新するコンバーターが使用されます。

ただし、TeamCity は、これらの設定を XML フォーマットで保存しているプロジェクトのバージョン付き設定を無効にする場合があります。この動作は、サーバーのアップグレードによって設定 XML ファイルに変更が生じる場合に発生し、TeamCity サーバーの非本番バージョンへアップグレードする際に望ましくない構成更新を防ぐように設計されています。

新しい TeamCity バージョンが安定しており、XML ファイルの更新を続行したい場合は、対応するヘルスレポートアクションをクリックします。 TeamCity は更新された XML 構成ファイルを VCS にコミットします。このコミットには、バージョン付き設定が無効になっている間に TeamCity UI 経由で行われたすべてのプロジェクト構成の更新も含まれます。

Kotlin DSL アップグレード手順

通常、サーバーのアップグレード後、Kotlin DSL スクリプトはすぐに変更する必要はなく、新しい TeamCity バージョンでも同じ結果を生成するはずです。ただし、最新の構成バージョンを使用するように Kotlin DSL スクリプトを更新することをお勧めします。

Kotlin DSL スクリプトがリポジトリで変更され、これらの変更が失われない場合は、手動アップグレードをお勧めします。

手動での DSL スクリプトのアップグレード: configs バージョンを変更

settings.kts には、いわゆる configs バージョンが含まれています。

version = "2025.11"

このバージョンは、TeamCity サーバーの現在のバージョンに変更する必要があります。たとえば、TeamCity サーバーが 2025.11 にアップグレードされた場合、 2025.11 を settings.kts で指定する必要があります。

ただし、その前に、DSL スクリプトの最新の変更を適用した後に TeamCity サーバーによって生成されたヘルスレポートをまず確認してください。これらのヘルスレポートには、構成バージョンを安全に変更する前に DSL にどのような変更を加える必要があるかが記述されています。

次のようなメッセージが表示された場合:

 Please change the configs version to "%product-version%" in projects:
 <the list of projects>

その場合、DSL に追加の変更は不要で、config の バージョン を 2025.11 に変更できます。それ以外の場合、次のメッセージが表示されます。

DSL scripts should be updated to produce settings for version %product-version%:
change DSL for build configurations:
<affected build configurations>
to update DSL, do the following:
<description of what should be changed>

   

これらの提案を確認し、DSL スクリプトに適用する必要があります。これらの提案がすべて適用された後にのみ、構成バージョンを変更できます。

DSL を 2025.11.x から 2026.1.x に更新

バージョン 2026.1 では、Amazon ウェブサービスと連携するすべての TeamCity プラグインが AWS SDK v2 をサポートするように更新されました。この変更は既存の連携に影響を与えず、大規模な手動更新も必要ありません。

注目すべきアップデートの一つは、アクセス制御リスト（ACL）名が、以前の PublicRead や BucketOwnerFullControl に代わり、 パブリック読み取りアクセス権限付きで公開されます。 や bucket-owner-full-control といった対応する AWS 値と一致するようになったことです。これらの値は通常、アクセスポリシーを変更できる追加の storage.s3.acl パラメーターで使用されます。

DSL を 2025.07.x から 2025.11.x に更新

マトリックスビルド用の 成果物を分離します。 は ビルドごとに成果物をグループ化します。 に名前が変更されました。詳細は YouTrack チケット（TW-84334(英語) ）を参照してください。

DSL を 2025.03.x から 2025.07.x に更新

潜在的な破壊的な変更はありません。

DSL を 2024.12.x から 2025.03.x に更新

Docker サポート機能の名前が Docker レジストリ接続に変更されたため、Kotlin DSL 内の対応するエンティティの名前も変更されました。

// 2024.12 and older
features {
        dockerSupport {
            cleanupPushedImages = true
            loginToRegistry = on {
                dockerRegistryId = "PROJECT_EXT_5"
            }
        }
    }

// 2025.03 and newer
features {
        dockerRegistryConnections {
            cleanupPushedImages = true
            loginToRegistry = on {
                dockerRegistryId = "PROJECT_EXT_5"
            }
        }
    }

  

古い構文を使用した既存の構成は引き続き機能し、ビルド機能の設定を変更した場合にのみ自動的に更新されます。この変更を反映するには、既存の構成ファイルを手動で更新することをお勧めします。

DSL を 2023.11.x から 2024.12.x に更新

バンドルされている Kotlin バージョンは 2.0.21 に更新されました。言語バージョンは 1.9 のままです。今後のリリースでは、K2 コンパイラーへの移行とともに言語バージョンを上げる予定です。この変更がカスタム Kotlin コードに影響するかどうかは、 K2 移行ガイド(英語)を参照してください。

DSL を 2022.05.x から 2023.11.x に更新する

バンドルされた Kotlin バージョンは 1.8.22 に更新されました。
セキュリティ上の理由から、既存の AWS 接続は、これらの接続を所有する TeamCity プロジェクトでのみ使用できるようになりました。子サブプロジェクトは、親プロジェクトの接続にアクセスできません。サブプロジェクトが親プロジェクトの AWS 接続を使用できるようにするには、 allowInSubProjects = true パラメーターをこの接続の設定ブロックに追加します。

DSL を 2022.10.x から 2023.05.x に更新する

バンドルされた Kotlin バージョンは 1.7.10 に更新されました。

DSL を 2022.04.x から 2022.10.x に更新する

Bitbucket サーバー / データセンターリポジトリをターゲットとするビルド構成のプルリクエストビルド機能は、公式にサポートされていないプルリクエストブランチを追跡しなくなりました (代わりにソースブランチを監視します)。以前の (非推奨の) 動作に手動で切り替えるには、 usePullRequestBranches = true パラメーターをプルリクエスト機能に追加します。詳細については、こちらの TeamCity Kotlin DSL ドキュメント記事を参照してください: PullRequests。

DSL を 2021.2.x から 2022.04.x に更新する

バンドルされた Kotlin バージョンは 1.6.21 に更新されました。
パッケージ名にバージョンがない新しい DSLAPI アーティファクトが導入されました。これらの DSLAPI アーティファクトに切り替える方法を以下に示します。

DSL API パッケージ名からバージョンを削除する

TeamCity 2022.04 以降では、DSL コードをよりシンプルに見せ、IntelliJ IDEA でのコード補完候補を改善するために、DSL コード内のインポートからバージョン部分を削除することをお勧めします。

例: インポート品:

import jetbrains.buildServer.configs.kotlin.v2019_2.*
import jetbrains.buildServer.configs.kotlin.v2019_2.projectFeatures.*

次のように変更できます:

import jetbrains.buildServer.configs.kotlin.*
import jetbrains.buildServer.configs.kotlin.projectFeatures.*

インポートされたパッケージ名から DSLAPI バージョンを削除するには、次の手順を実行する必要があります。

pom.xml ファイルの <dependencies/> セクションを更新します
ArtifactId configs-dsl-kotlin を configs-dsl-kotlin-latest に変更し、 configs-dsl-kotlin-plugins を configs-dsl-kotlin-plugins-latest に変更する必要があります
最終的に、 <dependencies/> セクションは次のようになります。

<dependencies>
    <dependency>
        <groupId>org.jetbrains.teamcity</groupId>
        <artifactId>configs-dsl-kotlin-latest</artifactId>
        <version>${teamcity.dsl.version}</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>org.jetbrains.teamcity</groupId>
        <artifactId>configs-dsl-kotlin-plugins-latest</artifactId>
        <version>1.0-SNAPSHOT</version>
        <type>pom</type>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-stdlib-jdk8</artifactId>
        <version>${kotlin.version}</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-script-runtime</artifactId>
        <version>${kotlin.version}</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

   

TeamCity サーバーが起動して実行中であることを確認してください。
id configs-dsl-kotlin-plugins-latest のアーティファクトは TeamCity サーバーによって提供されます。これは、pom.xml の <repositories/> セクションで id teamcity-server として指定されているものと同じ TeamCity サーバーです。 Maven はアーティファクト configs-dsl-kotlin-plugins-latest をダウンロードできるはずなので、このサーバーは稼働している必要があります。
すべての Kotlin ファイルのインポートを変更します。
パッケージ名のバージョン部分は、すべての Kotlin ファイルで削除する必要があります。例:
import jetbrains.buildServer.configs.kotlin.v2019_2.*
次のように置き換える必要があります:
import jetbrains.buildServer.configs.kotlin.*
DSL をコンパイルし、設定を生成します。
pom.xml および Kotlin ファイルに変更を加えた後、 mvn teamcity-configs:generate タスクを実行して、プロジェクトが引き続きコンパイルされることを確認することをお勧めします。エラーがない場合は、これらの変更をバージョン管理された設定リポジトリにチェックインできます。

DSL を 2021.1.x から 2021.2.x に更新する

このリリースでは新しい DSL API パッケージは導入されてしないため、 v2019_2 が最新のもののままです。
バンドルされた Kotlin バージョンは 1.5.31 に更新されました。
型付き DSL は、プロジェクトのさまざまな設定とビルド構成でサポートされるようになりました。改善点の全リストはこちらを参照してください。

DSL を 2020.2.x から 2021.1.x に更新する

このリリースでは新しい DSL API パッケージは導入されてしないため、 v2019_2 が最新のもののままです。
バンドルされた Kotlin バージョンは 1.4.32 に更新されました。
Git VCS ルートの useMirrors パラメーターは非推奨となり、次の値をサポートする checkoutPolicy パラメーターに置き換えられました: AUTO、 USE_MIRRORS、 NO_MIRRORS、 SHALLOW_CLONE。
プロジェクト DSL コード内の Git VCS ルートは、それに応じて更新する必要があります。たとえば、 useMirrors=false は checkoutPolicy=NO_MIRRORS に置き換え、 useMirrors=true は checkoutPolicy=USE_MIRRORS に置き換える必要があります。 Git VCS ルートで useMirrors が指定されていなかった場合は、 checkoutPolicy=USE_MIRRORS を追加する必要があります。
これらのチェックアウトポリシーの詳細はこちらを参照してください。
installToolPackage フィールドの Python ビルドステップのデフォルト値が変更されました。 2021.1 以降、 installToolPackage はデフォルトで 真 です。 Python ビルドステップの現在の動作を維持するには、 installToolPackage = false をビルドステップ設定に追加します。

DSL を 2020.1.x から 2020.2.x に更新する

このリリースでは新しい DSL API パッケージは導入されてしないため、 v2019_2 が最新のもののままです。
バンドルされた Kotlin バージョンは 1.4.21 に更新されました。

DSL を 2019.2.x から 2020.1.x に更新する

このリリースでは新しい DSL API パッケージは導入されてしないため、 v2019_2 が最新のもののままです。
バンドルされた Kotlin バージョンは 1.3.70 に更新されました。

DSL を 2019.1.x から 2019.2.x に更新する

バンドルされた Kotlin バージョンは 1.3.60 に更新されました。
このリリースでは、新しい DSL API パッケージ v2019_2 が導入されています。このパッケージには、クリーンアップルール用の更新された API があり、Kotlin DSL スクリプト内で DSL コンテキストパラメーターの値を取得する機能を提供します。

DSL スクリプト内のプロジェクトレポートタブ定義を更新する

ReportTab プロジェクト機能のパラメーターを変更する必要があります。

revisionRuleName パラメーターの値が lastFinished、 lastSuccessful、 lastPinned に設定されている場合は、 revisionRuleRevision パラメーターを削除する必要があります。
パラメーター revisionRuleName に ビルド番号 値がある場合、 revisionRuleRevision パラメーターの名前を revisionRuleBuildNumber に変更する必要があります。
パラメーター revisionRuleName の値が buildTag の場合、 revisionRuleRevision パラメーターの名前を revisionRuleBuildTag に変更し、パラメーターの値から接尾辞 .tcbuildtag を削除する必要があります。

DslContext.baseDir

TeamCity 2019.2 以降では、DSL スクリプトから .teamcity ディレクトリ下のファイルにアクセスするには、 DslContext.baseDir プロパティを使用します。例:

val dataFile = File(DslContext.baseDir, "data/setup.xml")

TeamCity 2019.2 では、DSL スクリプトの現在の作業ディレクトリが .teamcity ディレクトリであることが保証されなくなったため、これが必要です。

DSL を 2018.2.x から 2019.1.x に更新する

このリリースでは、新しい DSL API バージョン v2019_1 が導入されましたが、バージョン 2018.2.x および 2019.1.x の間で DSL に大きな変更がなかったため、そのパッケージはまだ jetbrains.buildServer.configs.kotlin.v2018_2 です。

Maven ビルドステップを更新する

DSL を生成する Maven ビルドステップを更新する必要があります。 Maven ビルドステップの useOwnLocalRepo パラメーターが 真 に設定されていない場合、次の localRepoScope パラメーターを追加する必要があります。

maven {
   ...
   localRepoScope = MavenBuildStep.RepositoryScope.MAVEN_DEFAULT
}

useOwnLocalRepo が 真 に設定されていた場合は、次のものに置き換える必要があります。

maven {
   ...
   localRepoScope = MavenBuildStep.RepositoryScope.BUILD_CONFIGURATION
}

MSBuild と VS.Solution ビルドステップにバージョンを追加する

MSBuild または VS.Solution ビルドステップのパラメーター toolsVersion が MSBuildStep.MSBuildToolsVersion.V15_0 に設定されている場合、追加の version = MSBuildStep.MSBuildVersion.V15_0 パラメーターを追加する必要があります。

msBuild {
    ...
    toolsVersion = MSBuildStep.MSBuildToolsVersion.V15_0
    version = MSBuildStep.MSBuildVersion.V15_0
}

   

ビルド構成パラメーター buildDefaultBranch は非推奨です

ビルド構成のバージョン管理設定パラメーター buildDefaultBranch は非推奨です。代わりに branchFilter を使用する必要があります。
たとえば、 buildDefaultBranch が 偽 に設定されていた場合は、代わりに次のブランチフィルターを指定する必要があります。

vcs {
   branchFilter = """
      +:*
      -:<default>
   """
}

   

DSL を 2018.1.x から 2018.2.x に更新する

このリリースでは、新しい DSL API バージョン v2018_2 が導入され、そのパッケージは jetbrains.buildServer.configs.kotlin.v2018_2 です。

DSL を 2017.2.x から 2018.1.x に更新する

このリリースでは、新しい DSL API バージョン v2018_1 が導入され、そのパッケージは jetbrains.buildServer.configs.kotlin.v2018_1 です。以前の API バージョンは機能するため、ポータブル DSL スクリプトを使用したくない場合は引き続き使用できます。

Docker パラメーターを更新する

Docker プラグイン構成用に TeamCity 2017.2 で Kotlin DSL を使用していた場合、コードを TeamCity 2018.1 と互換性のあるものにするために、Kotlin 構成スクリプトでいくつかの変更を行う必要がある場合があります。

変更の本質:

ビルドステップ docker ビルドが docker コマンドに変換されました
DockerBuild のパラメーターは、commandType セレクターのサブパラメーターになりました

違いに注意してください:

Docker ビルド 2 Docker コマンドへの移行

# DockerBuild in 2017.2:
dockerBuild {
    name = "name of the build step"
    source = content {
        content = """
            FROM busybox
             
            MAINTAINER KIR <kir@maxkir.com>
        """.trimIndent()
    }
    namesAndTags = "maxkir/maxkir_test"
}
#----------------------------------------
# DockerBuild in 2018.1:
dockerCommand {
    name = "name of the build step"
    commandType = build {
        source = content {
            content = """
                FROM busybox
                 
                MAINTAINER KIR <kir@maxkir.com>
            """.trimIndent()
        }
        namesAndTags = "maxkir/maxkir_test"
    }
}


   

Docker push コマンドのサポート

dockerCommand {
    name = "name of the push step"
    commandType = push {
        namesAndTags = "maxkir/maxkir_test"
    }
}

    

Commit Status Publisher の Gerrit パブリッシャー設定に label プロパティを追加する

TeamCity 2018.1 以降、コミットステータスパブリッシャービルド機能の Gerrit パブリッシャー設定では、ビルドステータスを反映する Gerrit ラベルをカスタマイズできます。つまり、Verified 以外のものを使用できるようになりました。

Kotlin DSL 設定を手動で変更するには、ラベル = "検証済み" ステートメントを次のように追加する必要があります。

features {
    ...
    commitStatusPublisher {
        publisher = gerrit {
            server = "<server>"
            gerritProject = "<project>"
            failureVote = "-1"
            successVote = "+1"
            userName = "<user>"
            uploadedKey = "<key>"
            label = "Verified"  // the statement to be added
        }
     }
    ...
}

   

DSL を 2017.1.x から 2017.2.x に更新する

DSL バージョン

このリリースでは、新しい DSLAPI バージョン v2017_2 が導入されています。以前の API バージョンは機能し、新しい API によって提供される機能(英語)が必要ない場合は、引き続き使用できます。

2017.2 EAP を使用し、UI 経由で DSL 設定の変更をテストしていた場合、一部の API が互換性のない形で変更されているため、アップグレード前に TeamCity によって作成されたすべての UI パッチを適用する必要があります。

TeamCity によって生成された設定の現在のパッケージ名は jetbrains.buildServer.configs.kotlin.v2017_2 です。

新しい API を使用すると、Kotlin DSL プロジェクトの編集可能な管理 UI や DSL ドキュメントなど、多くの新機能を利用(英語)できます。既存のプロジェクトで使用するには、 .kt ファイルを v2017_2 バージョン からパッケージに切り替える必要があります。

このプロジェクトをコンパイルするには、pom.xml も更新する必要があります。最も簡単な方法は、プロジェクトで「Kotlin フォーマットで設定をダウンロードアクションを呼び出して、生成された zip アーカイブから pom.xml をコピーすることです。または、次のようにして pom.xml を自分で更新することもできます。
- teamcity.dsl.version を変更: <teamcity.dsl.version>2017.2</teamcity.dsl.version>
- kotlin のバージョンを変更します: <kotlin.version>1.1.4-3</kotlin.version> に kotlin\-runtime と kotlin\-reflect への依存関係を追加します。

<dependency>
  <groupId>org.jetbrains.kotlin</groupId>
  <artifactId>kotlin-runtime</artifactId>
  <version>${kotlin.version}</version>
  <scope>compile</scope>
</dependency>
<dependency>
  <groupId>org.jetbrains.kotlin</groupId>
  <artifactId>kotlin-reflect</artifactId>
  <version>${kotlin.version}</version>
  <scope>compile</scope>
</dependency>


   

プロジェクトを新しい API に切り替えて変更をチェックインすると、TeamCity がそれらを検出して適用し、その後 Web UI 編集が有効になります。
既存の pom.xml があるリポジトリで新しい DSL API を使用するには、Maven 依存関係のバージョンを 2017.2 に更新する必要があります。

Docker パラメーターを更新する

Docker プラグイン構成用に TeamCity 2017.1 で Kotlin DSL を使用していた場合、コードを TeamCity 2017.2 と互換性のあるものにするために、kotlin 構成スクリプトでいくつかの変更を行う必要がある場合があります。基本的に、TeamCity はこれらの変更を自動で実行する Kotlin 構成スクリプト用のコンバーターを提供しますが、何らかの理由で機能しない場合は、次の変更を手動で行う必要があります。

ビルドランナーステップの名前を Docker ビルド runType から Docker ビルドに変更します
ビルドランナーステップの名前を Docker Compose runType から Docker Compose に変更します
docker-compose.file ビルドパラメーターの名前を dockerCompose.file に変更します

TeamCity 2017.2 以降、Docker プラグインには、 Docker レジストリ接続ビルド機能、コンテナーラッパー、 Docker、 Docker Compose ランナー用の独自の型付き DSL があります。

Docker Compose と Docker ビルド

steps {
    dockerCompose {
        name = "Start services"
        file = "db-tests/scripts/docker-compose.yml"
    }
 
    dockerBuild {
        name = "Docker build step"
        source = path {
            path = "some/context/Dockerfile"
        }
 
        // Case for Dockerfile specified by an URL:
        //source = url {
        //    url = "https://raw.githubusercontent.com/JetBrains/teamcity-docker-minimal-agent/master/ubuntu/Dockerfile"
        //}
 
        // Case for Dockerfile specified by text:
        //source = content {
        //    content = """
        //        FROM busybox
        //        MAINTAINER Kirill Maximov <kir@jetbrains.com>
        //    """.trimIndent()
        //}
 
        contextDir = "some/context"
        namesAndTags = "my:tag"
    }
}


   

Docker ビルド機能

features {
    dockerSupport {
        cleanupPushedImages = true
        loginToRegistry = on {
            dockerRegistryId = "PROJECT_EXT_2"
        }
    }
}


   

コンテナーラッパー付きコマンドラインランナー

script {
    scriptContent = "ls -lR"
    dockerImage = "openjdk:8u121"
    dockerPull = true
    dockerRunParameters = "--rm -v /some/path:/another/path:ro"
}


   

デフォルトプロジェクトテンプレートを更新する

2017.2 EAP3 以降、TeamCity はプロジェクト内のデフォルトテンプレートをサポートしています。この設定は EAP3 と EAP4 では "DefaultTemplate" タイプのプロジェクト機能に保存されていましたが、2017.2 RC 以降、デフォルトテンプレートに対応するためにプロジェクト構成スキーマが変更されました。
デフォルトテンプレートを使用する DSL プロジェクト構成を手動で変換するには、対応するプロジェクト機能を削除し、次のように defaultTemplate プロパティ代入に置き換える必要があります。

2017.2 デフォルトのテンプレートが設定された EAP3 / 4 DSL プロジェクトの設定:

object Project : Project({
    uuid = "2b241ffb-9019-4e60-9a3a-d5475ab1f312"
    extId = "ExampleProject"
    parentId = "_Root"
    name = "Example Project"
    ...
    features {
        ...
        feature {
            id = "PROJECT_EXT_4"
            type = "DefaultTemplate"
            param("template", "ExampleProject_MyDefaultTemplate")
        }
        ...
    }
    ...
})

   

2017.2 デフォルトのテンプレートが設定された DSL プロジェクトの設定:

object Project : Project({
    uuid = "2b241ffb-9019-4e60-9a3a-d5475ab1f312"
    extId = "ExampleProject"
    parentId = "_Root"
    name = "Example Project"
    defaultTemplate = "ExampleProject_MyDefaultTemplate"
    ...
    features {
        ...
    }
    ...
})


   

.NET CLI パラメーターを更新する

2017.2 以降、TeamCity には .NET CLI プラグインがバンドルされていました(現在は .NET ランナーとして再導入されています)。 TeamCity 2017.1.x でプラグインパラメーターに Kotlin DSL を使用していた場合は、コマンドを次のように変更する必要があります。 TeamCity 2017.1.x では:

steps {
    step {
        type = "dotnet"
        param("dotnet-command", "build")
        param("dotnet-paths", "WindowsAzure.sln")
    }
}


   

TeamCity 2017.2 以降、パラメーター付きのビルドステップを明示的に指定できます。

steps {
    dotnetBuild {
        projects = "WindowsAzure.sln"
    }
}


   

共通パラメーター

2017.1	2017.2	コメント
dotnet\- コマンド	dotnet<コマンド>	現在、コマンド名はビルドステップ名を反映します。例: `dotnetRestore`
ドットネット \-args	args
dotnet\-verbosity	logging

dotnet build

2017.1	2017.2	コメント
ドットネットパス	projects
ドットネット \- ビルド \-config	構成
dotnet\-build\-framework	フレームワーク
dotnet\-build\- 出力	outputDir
dotnet\-build\-runtime	ランタイム
dotnet\-build\-no\-deps	-	`--no-dependencies` 引数として追加する必要があります
dotnet\-build\-not\-incremental	-	`--no-incremental` 引数として追加する必要があります

dotnet clean

2017.1	2017.2
ドットネットパス	projects
dotnet\-clean\-config	構成
dotnet\-clean\-framework	フレームワーク
dotnet\-clean\- 出力	outputDir
dotnet\-clean\-runtime	ランタイム

dotnet msbuild

2017.1	2017.2
ドットネットパス	projects
ドットネット \-msbuild\-config	構成
dotnet\-msbuild\- プラットフォーム	platform
dotnet\-msbuild\- ターゲット	targets
dotnet\-msbuild\-runtime	ランタイム

dotnet nuget delete

2017.1	2017.2
dotnet\-nuget\-delete\-id	packageId
dotnet\-nuget\-push\-source/ dotnet\-nuget\-delete\-source	packageSource
セキュア: dotnet\-nuget\-delete\-api\-key	apiKey

2017.1

2017.2

dotnet\-nuget\-delete\-id

packageId

dotnet\-nuget\-push\-source/

dotnet\-nuget\-delete\-source

packageSource

セキュア: dotnet\-nuget\-delete\-api\-key

apiKey

dotnet nuget push

2017.1	2017.2	コメント
ドットネットパス	packages
dotnet\-nuget\-push\-source	packageSource
dotnet\-nuget\-push\-no\-symbols	noSymbols
セキュア: dotnet\-nuget\-push\-api\-key	outputDir
dotnet\-build\-runtime	apiKey
dotnet\-nuget\-push\-no\-buffer	-	`--disable-buffering true` 引数として追加する必要があります

dotnet pack

2017.1	2017.2	コメント
ドットネットパス	projects
ドットネット \- パック \-config	構成
dotnet\-pack\-runtime	ランタイム
dotnet\-pack\-no\-build	skipBuild
dotnet\-pack\- 出力	outputDir
dotnet\-pack\-version\-suffix	versionSuffix
dotnet\-pack\-serviceable	-	`--serviceable` 引数として追加する必要があります

dotnet publish

2017.1	2017.2
ドットネットパス	projects
dotnet\-publish\-config	構成
dotnet\-publish\-framework	フレームワーク
dotnet\-publish\- 出力	outputDir
dotnet\-publish\-runtime	ランタイム
dotnet\-publish\-version\-suffix	versionSuffix

dotnet restore

2017.1	2017.2	コメント
ドットネットパス	projects
ドットネット \- 復元 \-config	configFile
dotnet\-restore\-runtime	ランタイム
dotnet\-restore\- パッケージ	packagesDir
dotnet\-restore\-source	packageSources
dotnet\-restore\-ignore\-failed	-	`--ignore-failed-sources` 引数として追加する必要があります
dotnet\-restore\-no\-cache	-	`--no-cache` 引数として追加する必要があります
dotnet\-restore\-parallel	-	`--disable-parallel` 引数として追加する必要があります
dotnet\-restore\-root\-project	-	`--no-dependencies` 引数として追加する必要があります

dotnet run

2017.1	2017.2
ドットネットパス	projects
ドットネット実行 -config	構成
dotnet\-run\-framework	フレームワーク
ドットネット \-run\-runtime	ランタイム

dotnet test

2017.1	2017.2
ドットネットパス	projects
ドットネット \- テスト \-config	構成
dotnet\-test\-framework	フレームワーク
dotnet\-test\-no\-build	skipBuild
dotnet\-test\- 出力	outputDir
dotnet\-test\-settings\- ファイル	settingsFile
dotnet\-test\-runtime	ランタイム
dotnet\-test\-test\-case\-filter	フィルター

dotnet vstest

2017.1	2017.2	コメント
ドットネットパス	assemblies
dotnet\-vstest\-config\- ファイル	settingsFile
dotnet\-vstest\-framework	フレームワーク
dotnet\-vstest\- プラットフォーム	platform
dotnet\-vstest\-filter\-type	フィルター	名前でテストをフィルターするには `name { names = "..." }` を使用し、テストケースフィルターには `filter { filter = "..." }` を使用します
dotnet\-vstest\-is\-isolation	-	`/InIsolation` 引数として追加する必要があります

DSL を 10.0.x から 2017.1.x に更新する

TeamCity 2017.1 では新しい Kotlin DSL API は導入されず、TeamCity 10.0.x と同じパッケージが使用されます（jetbrains.buildServer.configs.kotlin.v10）。既存の API にいくつかの新しいプロパティが追加されました。スクリプト開発用の最新 API を取得するには、 pom.xml 内の teamcity.dsl.version を、EAP ビルドでは 2017.1-SNAPSHOT に、リリースビルドでは 2017.1 に更新します。

手動の Kotlin DSL スクリプト更新が必要な変更

これらの変更は、TeamCity アップグレード時に「TeamCity アップグレード中に設定ファイルが変更されたため、このプロジェクトではバージョン付き設定が無効になっています」というメッセージで無効化されたプロジェクトで、バージョン付き設定を有効にする前に実行する必要があります。

クラウドプロファイルを変換する

これは、ルートプロジェクト設定に Kotlin DSL を使用していて、クラウドプロファイルがある場合にのみ関係します。
2017.1 では、クラウドプロファイルはサーバーレベルからルートプロジェクトレベルに移動されました。それらは Kotlin DSL で定義されていなかったため、バージョン付き設定を有効にすると、既存のクラウドプロファイルはサーバーから削除されます。そのため、サーバー上のルートプロジェクトで Kotlin DSL の使用を続ける前に、必ずクラウドプロファイル定義を Kotlin DSL のルートプロジェクト設定に追加してください。

クラウドプロファイル情報で設定を更新するには、次を実行します。

ルートプロジェクトで 'Kotlin フォーマットで設定をダウンロード ' アクションを実行し、生成された DSL で zip を保存します。
タイプ CloudIntegration および CloudProfile のプロジェクト機能を .teamcity/_Root/Project.kt ファイルから設定のルートプロジェクト構成にコピーします。
VCS への変更をコミットします。
ルートプロジェクトのバージョン対応設定タブでバージョン設定を有効にします。

エンティティ内の名前

課題 TW-48609 の修正により、設定に名前のないエンティティが含まれている場合、TeamCity は対応する VCS 設定エラーを報告します。エラーを解決するには、そのようなエンティティに名前パラメーターを手動で設定する必要があります。

Kotlin DSL configs バージョンを 10.0 から 2017.1 に更新する

このセクションの変更は、スクリプトの設定バージョンを 10.0 から 2017.1 に変更するときに、Kotlin スクリプトに対して行う必要があります。

dotCover パラメーターを更新する

DotCover で使用されるパラメーターが変更されました。使用している場合は、 dotNetCoverage.tool に dotCover 値があることを確認してください。 dotNetCoverage.dotCover.home.path パラメーターがない場合は、 %teamcity.tool.JetBrains.dotCover.CommandLineTools.bundled% に設定します。結果は次のようになります。

param("dotNetCoverage.tool", "dotcover")
param("dotNetCoverage.dotCover.home.path", "%\teamcity.tool.JetBrains.dotCover.CommandLineTools.bundled%")

カスタムパス（/custom/path など）で DotCover を使用する場合、結果は次のようになります。

param("dotNetCoverage.tool", "dotcover")
param("dotNetCoverage.dotCover.home.path", "/custom/path")

Maven ビルドステップパラメーターを更新する

生のパラメーターなしで型指定された maven DSL を使用する場合、型指定された DSL によって最新の設定が生成されるため、この変更による影響はありません。

param("name", "value") メソッドを使用して Maven ビルドランナー設定を指定している場合は、パラメーターを更新する必要があります。設定を更新する最も簡単な方法は、型付き DSL に切り替えることです。Kotlin フォーマットで設定を生成して、Maven の型付き DSL がどのようなものか確認できます。

param("name", "value") メソッドを引き続き使用する場合は、次の手順を実行します。

mavenSelection パラメーターの名前を maven.path に変更し、古い値を新しい値に変更します。

変更する古い値	新しい値
`mavenSelection:bundledM2`	`%teamcity.tool.maven%`
`mavenSelection:bundledM3_0`	`%teamcity.tool.maven3%`
`mavenSelection:bundledM3_1`	`%teamcity.tool.maven3_1%`
`mavenSelection:bundledM3_2`	`%teamcity.tool.maven3_2%`
`mavenSelection:bundledM3_3`	`%teamcity.tool.maven3_3%`
`mavenSelection:default`	`%teamcity.tool.maven.AUTO%`
`mavenSelection:custom`	`maven.home` パラメーターの値

maven.home パラメーターを削除します。

PowerShell ビルドステップパラメーターを更新する

TeamCity 2017.1 でクロス\-プラットフォーム PowerShell のサポートが追加されました。以前の PowerShell ビルドでは、デスクトップエディションのみが使用され、Windows でのみ実行されていました。

既存のビルドが PowerShell のデスクトップエディションに制限されたままになるようにするには、既存の PowerShell ステップで次のプロパティを設定します。

edition = PowerShellStep.Edition.Desktop

または、生のパラメーターを使用する場合:

param("jetbrains_powershell_edition", "Desktop")

2026 年 9 月 11 日