ビルド構成テンプレート

ビルド構成テンプレートを作成する

ビルド構成テンプレートを手動で作成することも、既存の構成から抽出することもできます。

プロジェクト用のデフォルトテンプレートの定義

デフォルトのテンプレートを使用すると、このプロジェクトとそのサブプロジェクト内のすべてのビルド構成に影響を与えることができます。

デフォルトテンプレートドロップダウンメニューからテンプレートを選択することにより、プロジェクト管理の一般設定ページを使用して、プロジェクトのすべてのビルド構成をデフォルトのテンプレートに関連付けることができます。このオプションは、プロジェクトまたはその親で少なくとも 1 つのテンプレートが定義されている場合に使用できます。新しいビルド構成はすべて、デフォルトのテンプレート設定を継承します。

既存の構成の設定は保持されます。

定義されている場合、他のデフォルトテンプレートがサブプロジェクトで定義されていない限り、デフォルトテンプレートはこのプロジェクトのすべてのビルド構成とサブプロジェクトに影響します。デフォルトのテンプレートを使えば、すべてのプロジェクトのビルド設定を簡単に変更できます。

• 特定のビルド機能をプロジェクトのすべてのビルド構成に追加します

• すべてのビルド構成を特定のチェックアウトモードに切り替えます

• デフォルトの障害状態を提供する

ビルド構成をテンプレートに関連付ける

• テンプレートに基づいて新しいビルド構成を作成できます。

• テンプレートには、既存のビルド構成をいくつでも関連付けることができます。画面の右上隅にあるアクションボタンからテンプレートに添付オプションを使用できます。

既存のビルド構成をテンプレートに関連付けると、ビルド構成はテンプレートで定義されているすべての設定を継承し、競合がある場合は、テンプレートの設定がビルド構成の設定よりも優先されます (依存関係、パラメーター、要件を除く)。テンプレートから継承した設定は上書きできます。

テンプレートが現在のプロジェクトまたはその親のいずれかに属している場合にのみ、ビルド構成をテンプレートに関連付けることができます。少なくとも 1 つの関連するビルド構成を持つテンプレートは削除できません。最初に関連するビルド構成をデタッチする必要があります。

ビルド構成を複数のテンプレートに関連付けることも可能です。

テンプレートからビルド構成をデタッチする

ビルド設定ページのアクションメニューで使用可能なテンプレートから切り離すオプションを使用してテンプレートからビルド構成を切り離すと、テンプレートのすべての設定がビルド構成にコピーされ、編集できるようになります。
ビルド構成が複数のテンプレートにアタッチされている場合、テンプレートから切り離すオプションは使用できなくなるため注意してください。代わりにテンプレートを管理するを使用してください。

テンプレートから継承した設定の再定義

テンプレートに関連付けられたビルド構成は、そのすべての設定を継承します (UI で継承済みとしてマークされます)。継承された設定は関連付けられたビルド構成から削除できませんが、継承されたビルドステップ、トリガー、ビルド機能、失敗条件、アーティファクトの依存関係、エージェント要件は、そのビルド構成内で無効にすることができます。

テンプレートの設定を変更すると、このテンプレートに関連付けられているすべての構成に影響しますが、関連付けられているビルド構成のほとんどの設定を再定義することは可能です。

ほぼすべてのビルド構成設定 (ビルドステップ、パラメーター、ビルドオプションなど) を再定義できます。唯一の例外は、再定義できないスナップショット依存関係とチェックアウトルールです。

変更された設定は黄色の境界線でハイライトされ、リセットボタンが変更された設定の右側に表示され、テンプレートの元の設定への変更を元に戻すことができます。

ビルド構成で継承されたパラメーターを再定義すると、継承された名前と新しい値で保存されます。その後、テンプレート内でこのパラメーターの名前を変更すると、ビルド構成内で元の名前と再定義された値を持つパラメーターと、テンプレートから継承された名前を変更したパラメーターの 2 つのパラメーターになります。

テンプレートに前後のステップを含める機能

場合によっては、テンプレートに共通のビルドステップを定義して、このステップがすべてのビルド構成ステップの前または後に実行されるようにする必要があります。
特定のテンプレートに対して、このようなステップを定義し、ビルド構成ステップに対する配置を定義することができます。すべてのビルド構成ステップは、ビルド手順を並べ替えるダイアログでプレースホルダーとして表されます。テンプレートステップは、このプレースホルダーの前または後に配置できます。

必要に応じて、テンプレートベースのビルド構成でビルド手順の順序をカスタマイズできます。

• TeamCity Web UI を使用すると、テンプレートステップに関してビルド構成ステップの配置を変更できます。

• バージョン設定を使用すると、テンプレートのステップに対するビルド構成ステップの配置を変更できるだけでなく、テンプレート自体のステップの順序を変更することもできます。

テンプレートから継承した設定を強制する

プロジェクト内のすべてのビルド構成にいくつかの設定を適用して、他のユーザーが再定義できないようにする場合、TeamCity は、プロジェクト階層内のすべてのビルド構成にこの機能を提供します。たとえば、強制設定を使用すると、エージェント側のチェックアウトをどこにでも設定したり、すべてのビルド構成に厳密な実行タイムアウトを設定したりすることができます。現在、ビルド機能、オプション、パラメーターを適用することが可能です。ビルド手順とビルド要件も適用できます。

プロジェクト階層にいくつかの設定を適用するには、これらの設定でテンプレートを作成します。その後、システム管理者はこのテンプレートをプロジェクトの強制設定のテンプレートとして設定できます。

強制設定のテンプレートは、すべての設定がプロジェクト階層のビルド構成に継承されるため、デフォルトのテンプレートに似ています。違いは、これらの継承された設定を無効にしたり上書きしたりできないことです。

プロジェクトを特定の強制設定のテンプレートに関連付けるには、システム管理者のロールが必要です。テンプレート自体は、テンプレートが定義されているプロジェクトを管理できるプロジェクト管理者が編集できます。

実機能定のテンプレートがプロジェクトで指定されており、サブプロジェクトで実機能定として別のテンプレートが割り当てられている場合、サブプロジェクトのテンプレートの優先度が高くなります。