最初のビルドを構成して実行する

最初のプロジェクトを作成する

TeamCity では、リポジトリ URL から自動作成、VCS 接続から作成、手動で作成など、複数の方法でプロジェクトを作成できます。このチュートリアルでは、最も簡単な方法であるリポジトリ URL からプロジェクトを作成する方法に焦点を当てます。リポジトリパスを入力するだけで、TeamCity がリポジトリをスキャンし、ビルドステップを検出して設定を提案します。

TeamCity のインストールには、デフォルトのルートプロジェクトが含まれており、このプロジェクトには他のすべてのプロジェクトが含まれています。最初のプロジェクトはこのルートの子として追加されます。作成するには、以下の手順に従ってください。

1. プロジェクトタブを開き、「+」をクリックします。

   

2. プロジェクト名と説明（任意）を入力します。自動生成されたプロジェクト ID はそのままにしておきます。

   

3. TeamCity プロジェクト自体はビルドを実行せず、ビルド構成とパイプラインのコンテナーとして機能します。プロジェクトは、関連するビルドの整理、権限の管理、接続やビルドパラメーターなどのリソースの共有にのみ役立ちます。

   プロジェクトの詳細を保存すると、TeamCity はビルドを設定するページを開きます。ここでビルド構成またはパイプラインの作成を選択できます。このチュートリアルでは、クラシックビルド構成を選択してください。

   

4. ドロップダウンメニューから、新しいリポジトリを接続する | 任意の Git URL を選択します。

   プロジェクトを追加すると、他の作成オプションにアクセスできるようになります。例: 既存の VCS ルートから作成したり、認証された VCS 接続を介してリポジトリを選択したりします。

5. リポジトリの URL を貼り付けてください。TeamCity は Git、Subversion、Perforce、Azure、Mercurial をサポートしています（サポートされているすべての URL 形式はこちらに記載されています）。サンプルプロジェクトでは、以下を使用します。

   https://github.com/JetBrains/Maven-Configuration-TeamCity-Samples

   これはパブリックリポジトリなので、HTTPS | 匿名認証を選択できます。プライベートリポジトリの場合、または書き込みアクセスが必要な場合（ビルドステータスの投稿など）は、別の認証方法を選択してください。詳細はビルド構成の作成と編集を参照してください。

   

6. 「続行」をクリックすると、TeamCity はリポジトリを検索し、そのブランチをチェックして、デフォルトのものを選択するように促します。また、新しいコミットに対して自動ビルドトリガーを有効にすることもできます。

7. 作成をクリックして初期設定を完了します。これで、子ビルド構成を持つプロジェクトが作成され、ビルド構成の設定を確認できるようになりました。右上の設定ボタンを使用して、「編集」（構成の変更）モードと「表示」（ビルド履歴の確認）モードを切り替えます。

   ビルド構成はすぐに実行できます。このビルドを委譲された TeamCity エージェントがソースを取得しますが、まだビルドステップが存在しないため、ビルドはすぐに終了します。では、これらのステップをいくつか追加してみましょう。

8. 構成設定で、ビルドステップタブを開きます。ここで、トリガーされたときに実行されるアクションを定義します。

   ビルドステップの自動検出をクリックして、TeamCity でリポジトリをスキャンします。サンプルプロジェクトでは、2 つの Maven ステップが提案されます。ch-simple/pom.xml ファイルに対して clean test を実行するステップを選択し、選択を使用をクリックします。

おめでとうございます ! 最初の TeamCity プロジェクトとビルド構成を作成しました。ビルドを実行し、必要に応じて構成設定を調整してください。

最初のビルドを実行する

TeamCity でビルドを実行するには、ビルドエージェントが必要です。ここで説明されているようにインストールされた新しい TeamCity サーバーには、同じコンピューターで実行される 1 つの登録済みビルドエージェントがあります。このエージェントを使用して、サンプルプロジェクトでビルドを実行してみましょう。

ビルド設定ページで、右上隅にある実行をクリックします。

TeamCity は常に、最初に利用可能で適切なビルドエージェントにビルドを割り当てます。

ビルド結果ページに自動的にリダイレクトされます。このページでは、ビルドの進行状況を監視し、ビルドの完了時にその結果を確認できます。このページからビルド構成設定にアクセスし、必要に応じて編集することもできます。

ビルド構成設定を調整する

最初に次の設定を構成することをお勧めします。

• アーティファクトを構築するためのパス

• 自動トリガー

• ビルド番号のカスタムパターン

その他の設定については、この章を参照してください。

アーティファクト

ビルドによってインストーラー、WAR ファイル、レポート、ログファイルなどが生成される場合は、ビルドの完了後に TeamCity サーバーに公開することをお勧めします。このようなアーティファクトへのパスは、ビルド設定 | 一般設定で指定できます。ビルドがすでに完了しているため、ビルドエージェントはすでにソースをチェックアウトしています。アーティファクトパスフィールドの横にあるツリーアイコンをクリックして、チェックアウトディレクトリブラウザーを開きます。このツリーからアーティファクトを選択できます。

TeamCity はパスをテキストフィールドに配置するため、必要に応じて変更できます。

ビルド構成設定を保存します。これで、ビルドを実行すると、TeamCity は指定されたすべてのレポートをアーカイブに入れて公開します。

ビルド構成ホームページには、実行中のすべてのビルドが一覧表示され、それらのアーティファクトを表示できます。

ビルド結果ページからアーティファクトを表示およびダウンロードすることもできます。

詳細については、こちらを参照してください。

自動ビルドトリガー

リポジトリの変更時に自動的にビルドをトリガーすることは、CI にとって不可欠です。TeamCity は、リポジトリ URL からプロジェクト / ビルド構成を作成するときに VCS トリガーを自動的に追加します。ビルド構成設定 | トリガーページで手動で追加することもできます。

取り除く

TeamCity で特定の CI/CD ジョブを構成するには:

1. ソースリポジトリからプロジェクトを作成し、そのメイン設定を調整します。

2. このプロジェクト内にビルド構成を作成します。

3. ビルド構成設定で、ビルドの段階を表すビルドステップを追加します。

4. 他の構成設定をセットアップします。例: 便利なビルド機能と自動トリガーを追加します。

その後、作成した構成に基づいてビルドを手動で実行するか、トリガーが構成されている場合は自動的にトリガーされるまで待つことができます。