ビルド構成の作成と編集
このページでは、TeamCity Web UIを使用したビルド構成の作成について詳しく説明しています。他のオプションには、REST APIおよびKotlin言語に基づくDSLでのTeamCityプロジェクト構成の使用が含まれます。
このページで:
- 手動で新しいビルド構成を作成する
- URLから新しいビルド構成を作成する
- GitHub.comリポジトリを指す新しいビルド構成を作成する
- Bitbucketクラウドを指す新しいビルド構成を作成する
- ビルド構成テンプレートを作成する
- テンプレートからビルド構成を作成する
- ビルド構成を並べ替える
- 設定の構成
- ビルド構成設定のアクション
ビルド構成を作成するには、プロジェクトの一般設定を開き、ビルド構成セクションのビルド構成を作成するをクリックします。
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
一般情報一般的な使用箇所、REST認証、スーパーユーザーアクセス、REST APIのバージョン、URLの構造、ロケーター、サポートされているHTTPメソッド、応答フォーマット完全および部分的な回答、ロギング、CORSのサポート、APIクライアントの推奨事項、TeamCityデータエンティティ要求プロ...

バージョン管理でのプロジェクト設定の保存
このページで:概要、VCSとの設定の同期ビルドに適用する設定の定義、安全な設定の保存トークンの生成、VCSにセキュリティデータを保存することの意味、設定形式、現在のプロジェクト設定をVCSにコミットする、変更の表示、TeamCityアップグレード後のバージョン設定の有効化、よくある質問 (FAQ)、...

TeamCityとVCSホスティングサービスの統合
GitHub、GitHub Enterprise、Bitbucket Cloud、GitLab.com、またはGitLab CE / EEに組織アカウントがある場合は、TeamCityをこれらのソースコードホスティングサービスに接続すると、組織のユーザーが新しいプロジェクト、GitまたはMercur...

ビルド構成テンプレート
概要、ビルド構成テンプレートを作成する、プロジェクト用のデフォルトテンプレートの定義関連設定の変更、ビルド構成をテンプレートに関連付けるビルド構成を複数のテンプレートに関連付ける関連設定の変更、、テンプレートからビルド構成をデタッチする、テンプレートから継承した設定の再定義パラメータ参照を使用する設...

メタランナーを使う
メタランナーを使用すると、ビルド構成からビルドステップ、要件、およびパラメータを抽出し、それらからビルドランナーを作成できます。このビルドランナーは、他のビルド構成またはテンプレートのビルドステップで他のビルドランナーとして使用できます。基本的に、メタランナーはあるビルド構成からの一連のビルドステッ...

Kotlin DSL
XML形式のバージョン管理で設定を保存することに加えて、TeamCityでは(Kotlin言語に基づいて)DSLに設定を保存できます。バージョン管理に保存されたDSLを使用すると、プログラムで設定を定義できます。Kotlinは静的に型指定されるため、IDEで自動補完機能を自動的に受け取り、利用可能な...