ビルド構成の作成と編集

利用可能なオプション

ビルド構成は、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 は、OAuth 2.0 と GitHub アプリ(英語)の 2 つの GitHub 認証方式をサポートしています。どちらの認証方式もカスタマイズは最小限で、設定は 1 分もかかりません。両方の接続タイプとその他の VCS プロバイダー接続の詳細については、こちらの記事を参照してください: 接続を構成。

接続ベースの構成を作成するには、2 つの方法があります。プロジェクト設定で接続を作成し、ビルドを設定するページで選択する方法と、この 1 つのページからすべてを行う方法です。以下のタブは、両方のアプローチを示しています。

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

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

オプション 1:

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

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

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

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

オプション #2:

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

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

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

   

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