TeamCity 2020.2 ヘルプ

ビルド構成

A build configuration is a collection of settings used to start a build and group the sequence of the builds in the UI. Examples of build configurations are distribution, integration tests, prepare release distribution, "nightly" build.

ビルド構成はプロジェクトに属し、ビルドを含みます。ホームページでビルド設定の詳細を調べたり、編集ページで設定を変更したりできます

一連のビルドごとに個別のビルド構成を作成することをお勧めします(つまり、専用の環境で特定のタスクを実行します)。これにより、新しい問題の検出 / 失敗したテスト、最初に失敗した / テストステータスが修正された、自動的に削除された調査などの機能が適切に機能します。

ビルド構成の増加に取り組むために、ビルド構成テンプレートとプロジェクトレベルのパラメーターを使用できます

このビデオチュートリアルは、TeamCity でビルド構成を使用する方法を示し、いくつかの追加のヒントを提供します。

ビルド設定

ビルド構成設定は次のとおりです。

ビルド構成タイプ

TeamCity には、以下のビルド構成タイプがあります。

  • ソースコードに適用するアクションとルールを定義する定期的なビルド構成。上記のすべての設定が適用されます

  • デプロイビルド構成。他のビルドのアーティファクトを何らかの環境にデプロイします

  • スナップショット依存関係によって結合された他のいくつかのビルドからの結果を集約して 1 か所に表示するコンポジットビルド構成

ビルド構成状態

A build configuration is characterized by its state visible in the UI which can be paused or active. By default, when created all configurations are active and can be paused manually as described below or automatically if the project is archived.

If a build configuration is paused, its automatic build triggers are disabled until the configuration is activated. Still, you can start a build of a paused configuration manually or automatically as a part of a ビルドチェーン . Besides, information on paused build configurations is not displayed on the 変更 page.

プロジェクトのすべてまたは選択したビルド構成を手動で一時停止することは可能です。

単一ビルド構成の一時停止 / 有効化

ビルド設定またはホームページ:

  • Open the アクション menu, click 一時停止 , and enter your comment in the Pause dialog (optional).
    To remove the builds of the paused build configuration from the build queue, check the Cancel already queued builds box. Click 一時停止 to confirm.

  • 一時停止したビルド構成をアクティブにするには、アクションメニューでアクティブにするを選択します。

プロジェクトのいくつかのビルド構成を一時停止 / アクティブ化する

プロジェクトのいくつかのビルド構成を一時停止するには:

  1. プロジェクト設定ページで、アクションメニューを開き、一時停止 / アクティブ化をクリックします。

  2. 開いたダイアログで、プロジェクトの横にあるボックスを選択して、すべてのビルド構成を一時停止するか、構成のボックスを選択的にオンにします。チェックされたビルド構成は一時停止されます。

  3. オプションのコメントを追加します。

  4. To remove all the builds of the paused configurations from the build queue, check the Cancel already queued builds if build configuration is paused box.

  5. 適用をクリックします。

プロジェクトのいくつかのビルド構成をアクティブにするには:

  1. プロジェクト設定ページで、アクションメニューを開き、一時停止 / アクティブ化をクリックします。

  2. 開いたダイアログで、プロジェクトの隣のボックスをクリアして、すべてのビルド構成をアクティブにするか、構成のボックスを選択的にクリアします。選択されていないビルド構成がアクティブになります。

  3. オプションのコメントを追加します。

  4. 適用をクリックします。

ビルド構成ステータス

一般に、ビルド構成の状況は、最後に終了したビルドの状況を反映しています。

パーソナルビルドはビルド構成の状況には影響しません。

詳細が折りたたまれている場合は、プロジェクトページ(すべてのプロジェクト)またはプロジェクトホームページ(特定のプロジェクト)ですべてのビルド構成のステータスを表示できます。

構成ステータスアイコンをビルドします。

アイコン

説明

Successful.png

デフォルトブランチの最後のビルドは正常に実行されました。

Failed.png

デフォルトのブランチでエラーが発生した最後のビルド、または現在実行中のビルドの 1 つが失敗しています。最後に完了したビルドが成功した場合でも、現在実行中のビルドと失敗したビルドが少なくとも 1 つあると、ビルド構成のステータスは " 失敗 " に変わります。

investigate.gif

誰かが問題の調査を開始したか、すでに問題を解決したことを示します。(ビルド障害の調査とミュートを参照)

no icon

この構成の完成したビルドはありませんでした。状況は不明です。プロジェクト内のどのビルド構成もビルドを完了していない場合は、NoBuildsProject.pngがプロジェクト名の横に表示されます。

BCPaused.png

ビルド構成は一時停止されています。ビルドはそれに対して引き起こされません。ステータスの横にあるリンクをクリックして、一時停止したユーザーを表示し、必要に応じて設定を有効にします。

一連のビルド構成の状況表示

状況を TeamCity または外部に表示したいビルド構成を除外することができます。

TeamCity で選択したビルド構成のステータスを表示するには

  • プロジェクトページで表示可能なプロジェクトを構成し、これらのプロジェクトのみに属するビルド構成のステータスを表示します

  • TeamCity 用のカスタム Java プラグイン(英語)を実装して、ページを TeamCityWeb アプリケーションの一部として使用できるようにします。

一連のビルド構成のステータスを外部(会社の Web サイト、Wiki、Confluence、またはその他の Web ページ)に表示するには、次の方法があります。

関連ページ:

プロジェクト

TeamCity のプロジェクトは、ビルド構成のコレクションです。TeamCity プロジェクトは、ソフトウェアプロジェクト、プロジェクトの特定のバージョン / リリース、またはビルド構成のその他の論理グループに対応できます。プロジェクトには、名前、ID、オプションの説明があります。TeamCity...

ビルド構成の作成と編集

このページでは、TeamCity Web UI を使用したビルド構成の作成について詳しく説明しています。他のオプションには、REST APIおよびKotlin 言語に基づく DSLでの TeamCity プロジェクト構成の使用が含まれます。ビルド構成を作成するには、プロジェクトの一般設定を開き、ビル...

ビルド構成テンプレート

概要 :構成テンプレートを作成するを使用すると、ビルド構成設定の重複を排除できます。複数の類似した(必ずしも同一ではない)ビルド構成があり、各構成を編集する必要なく共通の設定を 1 か所で変更できるようにする場合は、それらの設定を使用してビルド構成テンプレートを作成します。テンプレート設定を変更する...

デプロイビルド構成

TeamCity は、デプロイタイプのビルド構成を提供します。一部の環境へのデプロイを実行するビルド構成は、このタイプでマークできます。これらは通常、結果をデプロイするビルドにスナップショットまたはアーティファクトの依存関係があるビルド構成です。ビルド構成を作成した後、その一般設定を開き、ビルド構成...

ビルドチェーン

ビルドチェーンは、スナップショットの依存関係によって相互接続された一連のビルドです。ビルドチェーンは「パイプライン」と呼ばれることもあります。リビジョンの同期が有効になっているスナップショットの依存関係にリンクされたビルドチェーンの一部は、ソースの同じスナップショットを使用します。一般的なユースケー...

パーソナルビルド

パーソナルビルドは、一般的なビルドシーケンスのビルドアウトであり、通常はバージョン管理にまだコミットされていない変更を使用します。パーソナルビルドは通常、サポートされている IDEの 1 つからリモート実行プロシージャを介して開始されます。以下で説明するように、変更を含むパッチをサーバーに直接アップ...