パーソナルビルドの実行

直接パッチアップロード

カスタムパッチでビルドソースコードを変更する権限を持つユーザーは、Web UI または REST API を介して、ローカルの変更を含むパッチを TeamCity サーバーに直接アップロードできます。

TeamCity は、統合 diff 形式(英語)のパッチをサポートします。
unidiff ファイルを生成できるツールによって形式が異なるため、すべての unidiff バリエーションのエラーのない処理を保証することはできません。現在、TeamCity は、IntelliJ プラットフォーム IDE および Git によって生成された unidiff ファイルの安定した解析を提供します。
TeamCity は、非バイナリファイルのバイナリ変更をサポートしていません。

パッチを生成するには:

• IntelliJ Platform IDE : コミットログで必要なローカル変更を選択し、コンテキストメニューでパッチの作成をクリックし、パッチを *.diff ファイルとして保存します。

• Git 経由 : git diff commit1..commit2 > path/filename.diff を実行します。
  例: 最後のコミットと test ディレクトリの patch.diff ファイルへの前のコミットとの差分を保存するには、git diff HEAD^ HEAD > ~/test/patch.diff を実行します。Git のドキュメント(英語)の他の例を参照してください。

パッチをアップロードし、Web UI を介してパーソナルビルドを実行するには:

1. カスタムビルドを実行するダイアログを開き、「個人ビルドとして実行」オプションを有効にします。パッチをアップロードボタンが表示されます。

   

2. パッチをアップロードし、ビルド実行をクリックします。
   エージェントはパッチを受信し、ビルドを実行する前にそれを適用します。ビルド後、パッチを元に戻し、チェックアウトディレクトリを後続のビルドで再利用できるようにします。

パッチをアップロードし、REST API を介してパーソナルビルドを実行するには:

1. 次の POST リクエストを送信します。

   curl \ -X POST \ -H "Content-Type: text/text" \ -H "Origin: <host>:<port>" \ --data-binary @patch.diff \ "http://<username>:<password>@<host>:<port>/uploadDiffChanges.html?description=<description-text>&commitType=0"

   応答として、サーバーでこの変更の ID を受け取ります。

2. ビルドノードを記述し、ビルド構成 ID と個人的な変更の ID を記載した XML ファイルを作成します。

   <build personal="true"> <triggered type='idePlugin' details='Unified Diff Patch'/> <triggeringOptions cleanSources="false" rebuildAllDependencies="false" queueAtTop="false"/> <buildType id="<build_configuration_id>"/> <lastChanges> <change id="<change_ID>" personal="true"/> </lastChanges> </build>

3. REST API を介してパーソナルビルドをトリガーするには、作成したファイルを buildQueue エンドポイントに投稿します。

   curl \ -X POST \ -H "Content-Type: application/xml" \ -H "Origin: <host>:<port>" \ --data @node.xml \ "http://<username>:<password>@<host>:<port>/app/rest/buildQueue"

   エージェントはパッチを受け取り、ビルドを実行する前にそれを適用します。ビルド後、パッチが元に戻されるため、チェックアウトディレクトリを後続のビルドで再利用できます。未使用のパッチは、15 分のタイムアウトによって自動的にクリーンアップされます。

パーソナルビルドの推進

非個人的なビルドと同じ方法で個人ビルドをプロモートできます。昇格後、依存ビルドは個人用ビルドとして実行され、同じパッチが使用されます。

パーソナルビルドチェーンのトリガー

個人用ビルドチェーンがトリガーされると、TeamCity はビルドチェーンのすべてのビルドを個人用にし、それらすべてに個人用パッチを適用しようとします。ただし、変更がチェックアウトルールに一致しない場合、TeamCity はパッチを適用しません。例: パッチが src/File.java を変更したが、VCS チェックアウト規則構成で src フォルダーが除外されている場合、パッチは適用されず、エージェント上のソースコードは変更されません。この場合、このビルドは、同じリビジョンをチェックアウトする非個人用ビルドに最適化できます。

Perforce シェルフファイルでビルドを実行する

現在のビルド構成に Perforce VCS ルートがある場合は、保留中の Perforce ファイル(英語)の変更に基づいて個人用ビルドを実行できます。これを行うには、個人用ビルドとして実行オプションを有効にし、保留中の変更リスト ID フィールドにターゲットの変更リスト ID を入力します。