最初のビルドを構成して実行する
TeamCity の用語では、ビルドは 1 つ以上のステップで構成され、特定の CI/CD ジョブを実行するプロセスです。
ここで説明するように TeamCity をインストールして開始すると、最初のビルドを構成して実行する準備が整います。
![最初のビルドを実行する Run your first build](https://resources.jetbrains.com/help/img/teamcity/2024.03/run-first-build.png)
クイックビデオガイドを見るか、以下の完全なチュートリアルを読むことができます。
最初のプロジェクトを作成する
TeamCity でプロジェクトを作成するには、リポジトリ URL から自動的に、特定の VCS への接続から、または手動で作成する方法がいくつかあります。このチュートリアルでは、リポジトリの URL からのデフォルトの最も簡単な方法に焦点を当てます。リポジトリへのパスを指定するだけで済みます。TeamCity はリポジトリをスキャンし、いくつかの設定と潜在的なビルド手順を提案します。
すべての TeamCity インストールには、作成した他のすべてのプロジェクトを含むデフォルトのルートプロジェクトがあります。作成する最初のプロジェクトは、ルートプロジェクトの子として追加されます。最初のプロジェクトを追加するには:
TeamCity UI の右上隅にある管理をクリックし、次にプロジェクトの作成をクリックします。
プロジェクトの作成ページで、リポジトリの URL からをクリックし、プロジェクトのソースリポジトリの URL をリポジトリ URL として貼り付けます。Git、Subversion、Perforce、Azure、Mercurial リポジトリにすることができます。サポートされているすべての URL 形式がここにリストされています。サンプルリポジトリを使用するには、次のように入力します。
https://github.com/mkjetbrains/SimpleMavenSampleリポジトリへのアクセスが制限されている場合は、資格情報も入力してください。
「続行」をクリックし、ウィザードに従います。
TeamCity はリポジトリの種類を識別し、接続をテストし、リポジトリ設定を自動構成し、プロジェクト名とビルド構成名を提案します。「続行」をクリックします。
TeamCity は VCS リポジトリをスキャンし、ビルド手順を自動検出します。適切な手順のチェックボックスをオンにすると、このプロジェクトの最初のビルド構成に追加されます。
おめでとう ! これで、作成したばかりのビルド構成に基づいて最初のビルドを実行する準備が整いました。すぐに実行して、後で設定を微調整できます。
最初のビルドを実行する
TeamCity でビルドを実行するには、ビルドエージェントが必要です。ここで説明するようにインストールされた新しい TeamCity サーバーには、同じコンピューターで実行される 1 つの登録済みビルドエージェントがあります。このエージェントを使用して、サンプルプロジェクトでビルドを実行してみましょう。
ビルド設定ページで、右上隅にある実行をクリックします。
![ビルドを実行する Run a build](https://resources.jetbrains.com/help/img/teamcity/2024.03/RunBuild.png)
TeamCity は常に、最初に利用可能で適切なビルドエージェントにビルドを割り当てます。
ビルド結果ページに自動的にリダイレクトされます。このページでは、ビルドの進行状況を監視し、ビルドの完了時にその結果を確認できます。このページからビルド構成設定にアクセスし、必要に応じて編集することもできます。
ビルド構成設定を調整する
最初に次の設定を構成することをお勧めします。
その他の設定については、この章を参照してください。
アーティファクト
ビルドでインストーラー、WAR ファイル、レポート、ログファイルなどが生成される場合は、ビルドの完了後に TeamCity サーバーに公開することをお勧めします。ビルド設定 | 一般設定でそのようなアーティファクトへのパスを指定できます。ビルドはすでに完了しているため、ビルドエージェントはすでにソースをチェックアウトしています。アーティファクトパスフィールドの横にあるツリーアイコンをクリックして、チェックアウトディレクトリブラウザーを開きます。このツリーからアーティファクトを選択できます。
![アーティファクトパス Artifact paths](https://resources.jetbrains.com/help/img/teamcity/2024.03/artifactPaths.png)
TeamCity はパスをテキストフィールドに配置するため、必要に応じて変更できます。
![アーティファクトパスを変更する Modify the artifact paths](https://resources.jetbrains.com/help/img/teamcity/2024.03/artifactPathsArchive.png)
ビルド構成設定を保存します。これで、ビルドを実行すると、TeamCity は指定されたすべてのレポートをアーカイブに入れて公開します。
ビルド構成ホームページには、実行中のすべてのビルドが一覧表示され、それらのアーティファクトを表示できます。
![公開されたアーティファクト Published artifacts](https://resources.jetbrains.com/help/img/teamcity/2024.03/artifactsPublished.png)
ビルド結果ページからアーティファクトを表示およびダウンロードすることもできます。
![ビルド結果のアーティファクト Artifacts in build results](https://resources.jetbrains.com/help/img/teamcity/2024.03/artifactsPublishedResults.png)
詳細については、こちらを参照してください。
自動ビルドトリガー
リポジトリの変更時に自動的にビルドをトリガーすることは、CI にとって不可欠です。TeamCity は、リポジトリ URL からプロジェクト / ビルド構成を作成するときに VCS トリガーを自動的に追加します。ビルド構成設定 | トリガーページで手動で追加することもできます。
![トリガーを追加 Add a trigger](https://resources.jetbrains.com/help/img/teamcity/2024.03/addTrigger.png)
ビルド番号の形式
TeamCity の各ビルドには、文字列識別子であるビルド番号があります。これは、ビルド設定 | 一般設定で定義されたパターンに従って構成されています ( 詳細オプションを表示をクリックして表示します)。デフォルト値のままにすると、ビルド番号の形式は TeamCity によって維持されます。数値は、新しいビルドが開始されるたびに次の整数値に解決されます。または、ここで説明されているようにパターンをカスタマイズできます。
取り除く
TeamCity で特定の CI/CD ジョブを構成するには:
ソースリポジトリからプロジェクトを作成し、そのメイン設定を調整します。
このプロジェクト内にビルド構成を作成します。
ビルド構成設定で、ビルドの段階を表すビルドステップを追加します。
他の構成設定をセットアップします。例: 便利なビルド機能と自動トリガーを追加します。
その後、作成した構成に基づいてビルドを手動で実行するか、トリガーが構成されている場合は自動的にトリガーされるまで待つことができます。
関連ページ:
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/dk-stepID.png)
ビルドステップの設定
TeamCity プロジェクト内にビルド構成が含まれている場合は、ビルドステップを構成できます。ビルドステップ (「ジョブ」とも呼ばれる) は、ビルドランナーによって実行されるタスクです。1 つのビルド構成には、連続して実行される複数のステップを含めることができます。ビルドステップは、ビルド設定ページのビルドステップセクションで構成されます。このページでは次のことができます。新しいステップを手動で追加します。ソース VCS リポジトリをスキャンすることによるステップの自動検出。ステップをコピーし...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/dk-agentpriority.png)
ビルドエージェント
TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。TeamCity サーバーとは別にインストールおよび構成されます。エージェントは、サーバーと同じコンピューターまたは別のマシンにインストールできます(サーバーのパフォーマンス上の理由から、後者が推奨されるセットアップです)。エージェントは、TeamCity サーバーと同じオペレーティングシステム(OS)または別の OS を実行できます。TeamCity ビル...
![](https://pleiades.io/icons/teamcity.png)
エージェント要件
エージェント要件は、ビルド構成を特定のビルドエージェントで実行できるかどうかを定義する特別な条件です。エージェントプールによるグループ化とともに、ビルドをエージェントに配布する方法を柔軟に制御できます。特定のビルド構成の明示的なエージェント要件を作成するには、ビルド設定 | エージェント要件に移動し、新しい要件を追加するをクリックします。各要件は、特定のパラメーターの条件付きルールを表します。パラメーター名または値を入力している間、TeamCity は関連する提案を表示します。要件を一時的に無効...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/create-build-configuration-button.png)
ビルド構成の作成と編集
このセクションには、TeamCity UI を介してビルド構成を作成および構成する方法に関する記事が含まれています。ビルド構成は、ビルドを開始し、UI でビルドのシーケンスをグループ化するために使用される設定のコレクションです。ビルド構成の例としては、ディストリビューション、統合テスト、リリースディストリビューションの準備、「夜間」ビルドなどがあります。ビルド構成はプロジェクトに属し、ビルドを含みます。ビルド構成の詳細はホームページで確認し、設定ページで設定を変更できます。一連のビルドごとに個別...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/addRule.png)
VCS トリガーの設定
VCS トリガーは、TeamCity が構成済みの VCS ルートの新しい変更を検出するたびに新しいビルドを自動的に開始し、保留中の変更の変更を表示します。複数の VCS トリガーをビルド構成に追加できます。ビルド構成に保留中の変更があると、デフォルト設定の新しい VCS トリガーがビルドをトリガーします。構成されている場合、VCS コミットフックを尊重する VCS ルートの変更間隔のチェックに従って、バージョン管理が変更についてポーリングされます。チェックアウトルールに一致した変更のみが保留中と...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/configure-agent-port.png)
クイックセットアップガイド
この記事では、最も一般的なオペレーティングシステムについて、同じマシン上での TeamCity サーバーと 1 つのビルドエージェントの評価セットアップについて説明します。評価のために TeamCity をインストールする方法の一般的なアイデアを得るには、このビデオチュートリアルを見るか、以下の完全なガイドを読むことができます。実稼働セットアップ用に TeamCity をインストールするには、このセクションをお読みください。TeamCity をダウンロード:TeamCity の無料の Prof...