ビルド構成の作成と編集。

利用可能なオプション

ビルド構成は、VCS に保存されているプロジェクトをビルド、テスト、デプロイする構成と、リモートリポジトリを必要としない構成 (たとえば、データの下へロードと処理にサードパーティの REST API を使用する構成) の 2 つの主要なタイプのいずれかになります。

リモートリポジトリをチェックする構成は、TeamCity 接続または VCS ルートを使用して作成できます。

利用可能なすべてのオプションは、 ビルドをセットアップする。 ページの対応するドロップ下へに表示されます。

TeamCity 接続を使用する

TeamCity 接続 は、VCS ホスティング、クラウドデータストレージ、Docker レジストリ、シークレット保管庫などの外部リソースにアクセスするために必要なすべての情報を保存します。 接続の使用は、ソースをビルドする最も便利な方法です: 一度構成しておけば、新しいビルド構成やパイプラインを追加するときに、必要なリポジトリをリストから選択するだけです。

上の図は、既存の接続のリストを示しています: GitLab 接続、GitHub 接続、いくつかの Azure 接続などです。 ビルド構成の親に含まれるどのプロジェクトにも VCS 接続がない場合、ここでの唯一のオプションは 新しいリポジトリを接続 メニュー項目から新しい接続を作成することです。

リポジトリ URL を使用する

このオプションを使用すると、Git、Subversion、Mercurial、TFS、Perforce リポジトリ（ディポ）URL を使用して、構成を一括でビルドできます。 任意の URL タイプを使用できます。

• 通常のリポジトリの Web リンク: https://github.com/Johndoe/my-sample-app

• HTTPS クローン URL: https://github.com/Johndoe/my-sample-app.git

• SSH クローン URL: git@github.com:Johndoe/my-sample-app.git

リモートリポジトリの構築を開始するには、以下の手順に従います。

VCS ルートを使用する

リモートリポジトリに保存されたソースを処理するすべてのビルド構成は、 VCS ルート オブジェクトを利用して処理されます。 このオブジェクトには、単一のリポジトリへのアクセスに必要な接続設定に加え、監視対象のブランチのリスト、自動ポーリング間隔、サブモジュールのチェックアウトポリシーといった詳細設定が保存されます。

必要なリポジトリをビルド、テスト、デプロイするビルド構成またはパイプラインがすでに存在する場合は、その構成 / パイプラインの VCS ルートを再利用できます。 これを行うには、次のいずれかの方法を使用します。

• 新しい構成を作成します - ビルドをセットアップする。 ページで 既存のルートから オプションを選択します。

• 既存の構成を編集する - ビルド構成設定 | バージョン管理 に移動し、 VCS ルートを接続 をクリックします。

  

既存の VCS ルートを再利用すると、必要な認証とブランチ設定のセット上へにかかる時間を節約でき、重複したルートの作成を回避できます。

リポジトリなしの構成

この構成タイプは実行時にリモートリポジトリをチェックアウトしません。 たとえば、そのステップは事前定義されたスクリプトを実行し、HTTP リクエストを送信するだけです。

新しい「アンバウンド」を作成できます: 2 つの方法で構成できます。

• ビルドをセットアップする。 ページで、 リポジトリなし を選択します。

• クラシック UI で、 新しいビルド構成 ページを開き、 手動で タイルをクリックします。

VCS ルートは VCS プロバイダへの接続とリポジトリのチェックアウトを制御します。 そのため、VCS ルートをデタッチすることで、ビルド構成をアンバウンドにすることができます。 逆に、リポジトリのない構成に VCS ルートをアタッチすると、リモートソースをチェックアウトできるようになります。 どちらの操作も、ビルド構成設定の バージョン管理 セクションで実行できます。

複数のリポジトリを使用する構成

設定によって、どのリポジトリをチェックアウトするか、また、関連付けられた VCS ルートを通じてどのブランチを追跡するかが決まります。 設定には、ルートを 0 個から複数個まで、任意の数だけ設定できます。

通常、構成は単一のリポジトリを使用するため、VCS ルートも 1 つになります。 完全に独立したプロジェクトをビルドする必要がある場合は、個別の構成を作成し、必要に応じて ビルドチェーンでリンクするのが最適です。 ただし、複数のリポジトリが関連している場合 (コア製品とそのプラグインなど)、複数の VCS ルートを同じ構成にアタッチして、まとめてビルドできます。 これを行うには、この記事で説明されているいずれかの方法を使用して構成を作成し、その設定の バージョン管理 セクションに移動します。 ここで、必要なリポジトリを対象とする VCS ルートをさらに作成できます。

以下の Kotlin DSL スニペットは、2 つのルートが接続された構成を示しています。

すべての VCS ルートは、同じ チェックアウトディレクトリにソースを下へロードします。 ファイルの競合を回避し、フォルダーを整理するためには、 ルートチェックアウトルールを使用して、各リポジトリのソースを別々のサブディレクトリに下へロードするのが最適です。 例: 上記のスニペットは、デフォルトのチェックアウトディレクトリ内の「MavenRepo」フォルダーと「GradleRepo」フォルダーにソースを配置します。

例: 接続ベースの構成を作成する

この例では、GitHub への接続を追加し、それを使用して新しいビルド構成を作成します。

TeamCity は GitHub 認証メソッドとして、OAuth 2.0 と GitHub アプリをサポートしています。 どちらの認証方式もカスタマイズは最小限で、設定は 1 分もかかりません。 両方の接続タイプとその他の VCS プロバイダー接続の詳細については、こちらの記事を参照してください: 接続の構成。

接続ベースの構成は二通りの方法で作成できます: プロジェクト設定で接続を作成して ビルドをセットアップする。 ページで選択するか、この単一ページですべて行います。 以下のタブは、両方のアプローチを示しています。

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

テンプレート化されたビルド構成は、テンプレート設定ページから作成する方法と、通常の構成を作成して使用するテンプレートを選択する方法の 2 つの方法で作成できます。

オプション 1:

1. プロジェクト設定を開き、 一般設定タブに移動します。

2. ビルド構成テンプレート セクションまで下にスクロールし、必要なテンプレートをクリックします。

3. 右上隅の アクション メニューを呼び出し、 このテンプレートからビルド構成を作成… をクリックします。

4. 新しい構成に必要な設定を指定します。 手動で 以外のタイルはクリックしないでください。クリックすると、選択したテンプレートが使用されない新しい構成が作成されます。

オプション #2:

1. プロジェクト設定を開き、 一般設定タブに移動します。

2. ビルド構成 セクションの ビルド構成を作成 をクリックします。

3. 手動で タイルをクリックし、 テンプレートに基づく ドロップ下へメニューから必要なテンプレートを選択します。 このメニューは、このプロジェクトまたはその親プロジェクトのいずれかに少なくとも 1 つのビルド構成テンプレートがある場合に使用できます。

   

オプション #2 は、 ビルド構成テンプレート セクションが別の (サブ) プロジェクトによって所有されているため、必要なテンプレートが表示されない場合に役立ちます。