ビルド構成の作成と編集
このページでは、TeamCity Web UIを使用したビルド構成の作成について詳しく説明しています。他のオプションには、REST APIおよびKotlin言語に基づくDSLでのTeamCityプロジェクト構成の使用が含まれます。
ビルド構成を作成するには、プロジェクトの一般設定を開き、ビルド構成セクションのビルド構成を作成するをクリックします。
TeamCityはプロジェクトのために新しいビルド設定を作成するいくつかの方法を提供します：
新しいビルド構成を作成できます
- 手動
- リポジトリのURLを指す
GitHubリポジトリを指す
Bitbucketリポジトリを指す
ビルド構成テンプレートを作成するをクリックし、テンプレートに基づいてビルド構成を次に作成します。
ビルド構成を作成したら、次のことができます。
手動で新しいビルド構成を作成する
管理>プロジェクトページで、リストから希望のプロジェクトを選択します。（または、プロジェクトポップアップを使用してプロジェクトを開き、右側のプロジェクト設定の編集リンクをクリックします）。プロジェクト設定ページが開きます。
「プロジェクト設定」ページの「ビルド構成」セクションで、「ビルド構成を作成する」をクリックします。
Create Build Configurationダイアログで、ビルド構成の名前、ID、および（オプションで）説明を指定し、作成をクリックします。
- 他の設定の作成に進みます。
- VCSルートの作成/編集、およびVCS固有の設定の指定
ビルド・ステップページで、自動検出によって検出されたビルドステップを構成します。ドロップダウンリストから目的のビルドランナーを選択して、手動で作成します。保存をクリックします。1つのビルド構成内に必要な数のビルドステップを追加できます。これらは順番に実行されることに注意してください。最終的に、ビルドはマージステータスを取得し、出力は同じビルドログに記録されます。いくつかのステップが失敗した場合、残りのステップは、ステップ実行ポリシーに応じて実行されます。
さらに、ビルドトリガーオプション、依存関係、プロパティと変数、およびエージェントの要件を構成します。
URLから新しいビルド構成を作成する
VCS URLを使用してビルド構成を作成できます。
管理>プロジェクトページで、リストから希望のプロジェクトを選択します。（または、プロジェクトポップアップを使用してプロジェクトを開き、右側のプロジェクト設定の編集リンクをクリックします）。プロジェクト設定ページが開きます。
「プロジェクト設定」ページの「ビルド構成」セクションで、「URLからビルド構成を作成する」をクリックします。
Create Build Configurationダイアログで、VCSリポジトリのURLを指定し、認証が必要な場合はVCSの認証情報を指定します。作成をクリックしてください。
TeamCityはビルド設定名を提案し、残りの設定を自動的に行います。
それはVCSリポジトリの種類を決定し、VCSルートを作成します。
TeamCityは、ビルドステップAnt、NAnt、Gradle、Maven、MSBuild、Visual Studioソリューションファイル、PowerShell、Xcodeプロジェクトファイル、Rake、およびIntelliJ IDEAプロジェクトの自動検出を試みます。見つからない場合は、[ビルドステップを手動で構成する]（http://Configuringビルドステップ）する必要があります。
次に、TeamCity UIは、ビルドトリガー、失敗条件、およびビルド機能を作成するためのプロンプトを備えた提案アイコンを表示します。ビルド構成設定に応じて、追加の構成オプションが提案される場合があります。
ビルド構成を作成したら、ビルドを実行したり設定を調整したりできます。
GitHub.comリポジトリを指す新しいビルド構成を作成する
- ビルド構成を作成するボタンをクリックしてGitHub.comリポジトリを指していますを選択します。
GitHub接続が設定されていない場合は、接続ページにリダイレクトされます。ここで説明されているように接続を設定してから、以下のステップに従ってください。
GitHub接続が設定されている場合は、以下の手順に従ってください。
GitHubからビルド構成を作成するページで、リポジトリを選択します。TeamCityはリポジトリ接続を確認します。接続が確認されると、新しいページが開きます。
TeamCityはプロジェクトとビルド構成名を表示します。必要に応じて、名前を変更して 続行 をクリックします。
TeamCityはVCSビルドトリガーを追加し、ビルドステップAnt、NAnt、Gradle、Maven、MSBuild、Visual Studioソリューションファイル、PowerShell、Xcodeプロジェクトファイル、Rake、およびIntelliJ IDEAプロジェクトを自動検出しようとします。自動検出ビルドステップ ページで、ビルド構成で使用するステップを選択します。選択を使用をクリックします。ステップが見つからない場合は、ビルドステップを手動で構成する必要があります。
プロジェクトとビルド構成が構成されました。実行をクリックしてビルドを開始します。ビルド構成設定に応じて、TeamCityはいくつかの追加構成オプションを提案することができます。推奨設定
を確認し、必要な設定を行います。
Bitbucketクラウドを指す新しいビルド構成を作成する
ビルド構成を作成するボタンをクリックしてBitbucketクラウドリポジトリを指すを選択します。
Bitbucket接続が設定されていない場合は、接続ページにリダイレクトされます。ここで説明されているように接続を設定してから、以下のステップに従ってください。
Bitbucket接続が設定されている場合は、以下の手順に従ってください。
Bitbucketクラウドからビルド構成を作成ページで、リポジトリを選択します。TeamCityはリポジトリ接続を確認します。接続が確認されると、新しいページが開きます。
TeamCityはプロジェクトとビルド構成名を表示します。必要に応じて、名前を変更して 続行 をクリックします。
TeamCityはVCSビルドトリガーを追加し、ビルドステップの自動検出を試みます：Ant、NAnt、Gradle、Maven、MSBuild、Visual Studioソリューションファイル、PowerShell、Xcodeプロジェクトファイル、Rake、およびIntelliJ IDEAプロジェクト。
自動検出ビルドステップ ページで、ビルド構成で使用するステップを選択します。選択を使用をクリックします。ステップが見つからない場合は、ビルドステップを手動で構成する必要があります。プロジェクトとビルド構成が構成されました。実行をクリックしてビルドを開始します。ビルド構成設定に応じて、TeamCityはいくつかの追加構成オプションを提案することができます。推奨設定
を確認し、必要な設定を行います。
ビルド構成テンプレートを作成する
新しいビルド構成テンプレートを作成することは、新しい構成を作成することと似ています。
管理 | プロジェクトページで、リストから希望のプロジェクトを選択します。（または、プロジェクトポップアップを使用してプロジェクトを開き、右側のプロジェクト設定の編集リンクをクリックします）。プロジェクト設定ページが開きます。
プロジェクト設定ページの構成テンプレートの構築セクションで、テンプレートの作成ボタンをクリックし、一般設定 VCS設定およびビルドステップの構成に進みます。
あるいは、既存のビルド構成からビルド構成テンプレートを作成することもできます。
既存のビルド構成設定ページを開き、画面の右上隅にあるアクションをクリックして、抽出テンプレートオプションを選択します。
必要な設定を指定して作成をクリックします。
テンプレートからビルド構成を作成する
テンプレートに基づいてビルド構成を作成するには
管理 | プロジェクトページで、リストから希望のプロジェクトを選択します。（または、プロジェクトポップアップを使用してプロジェクトを開き、右側のプロジェクト設定の編集リンクをクリックします）。プロジェクト設定ページが開きます。
「プロジェクト設定」ページの「構成テンプレートの構築」セクションで、目的のテンプレートを見つけてその名前をクリックするか、または「編集」を使用します。
画面の右上隅にあるアクションをクリックして、ビルド構成を作成するを選択します。
新しい設定に必要な設定を指定します。
あるいは、次のようにテンプレートに基づいてビルド構成を作成することもできます。
管理 | プロジェクトページで、リストから希望のプロジェクトを選択します。（または、プロジェクトポップアップを使用してプロジェクトを開き、右側のプロジェクト設定の編集リンクをクリックします）。プロジェクト設定ページが開きます。
「プロジェクト設定」ページの「ビルド構成」セクションで、「ビルド構成を作成する」をクリックします。
構成設定ページで、テンプレートに基づくドロップダウンを使用して、ビルド構成用のテンプレートを選択します。
ビルド構成を並べ替える
デフォルトでアルファベット順にリストされているプロジェクト概要ページでプロジェクトのすべてのビルド構成を見ることができます。管理者はデフォルトの順序をカスタマイズできます。
設定の構成
ビルド構成の設定については、次のページで説明しています。
REST APIを介して作成されたビルド構成では、TeamCity Web UIを介した編集が無効になることに注意してください。
ビルド構成設定のアクション
ビルド構成を編集するときにアクションメニューを使用
関連ページ：
REST API
TeamCityは、外部アプリケーションを統合し、TeamCityサーバーとのスクリプト相互作用を作成するためのREST APIを提供します。このページは3つのメインセクションで構成されています。一般情報は、REST API認証の原理、リクエストの構造、サポートされるHTTPメソッドについて説明して...
バージョン管理でのプロジェクト設定の保存
概要：TeamCityを使用すると、プロジェクト設定とバージョン管理リポジトリを双方向で同期できます。サポートされているVCSは、Git、Mercurial、Perforce、Subversion、およびAzure DevOps Server（以前のTFS）です。XML形式およびKotlin言語で設...
ビルド構成
ビルド構成は、ビルドを開始し、UI内でビルドの順序をグループ化するために使用される設定の集まりです。ビルド構成の例は、ディストリビューション、統合テスト、リリースディストリビューションの準備、「毎晩」ビルドです。ビルド構成はプロジェクトに属し、ビルドを含みます。ホームページでビルド設定の詳細を調べた...
TeamCityとVCSホスティングサービスの統合
GitHub、GitHub Enterprise、Bitbucketクラウド、GitLab.com、またはGitLab CE / EEに組織アカウントがある場合は、TeamCityをこれらのソースコードホスティングサービスに接続すると、組織のユーザーが新しいプロジェクト、GitまたはMercuria...
ビルド構成テンプレート
概要：構成テンプレートを作成するを使用すると、ビルド構成設定の重複を排除できます。いくつかの類似の（必ずしも同一ではない）ビルド構成を持ち、各構成を編集せずに共通の設定を1か所で変更できるようにする場合は、それらの設定でビルド構成テンプレートを作成します。テンプレート設定の変更は、このテンプレートに...
メタランナーを使う
meta-runnerでは、ビルド構成からビルドステップ、要件、およびパラメーターを抽出し、それらからビルドランナーを作成できます。このビルドランナーは、他のビルド構成またはテンプレートのビルドステップで、他のビルドランナーとして使用できます。メタランナーを使用すると、次のことができます。既存のラン...