TeamCity オンプレミス 2026.1 ヘルプ

プロジェクトの作成と編集

TeamCity では、実際のビルドタスクはビルド構成とパイプラインによって実行されます。ただし、どちらもプロジェクト内に配置する必要があります。

このトピックでは、プロジェクトを作成するさまざまな方法を説明します。

ルートプロジェクトと設定の継承

始める前に、すべての TeamCity サーバーには、ルートプロジェクトと呼ばれる削除不可能な組み込みプロジェクトが含まれていることにご注意ください。すべての新しいプロジェクトはこのプロジェクトの子として作成されますが、ビルド構成やパイプラインを直接ホストすることはできません。

TeamCity では、子プロジェクトは接続やクラウドエージェントプロファイルなど、多くの設定とエンティティを親プロジェクトから継承します。ルートプロジェクトでは、この概念を活用してサーバー全体のリソースを定義できます。たとえば、サーバー上のすべてのプロジェクトからアクセスできるクラウドエージェントを生成する AWS クラウドプロファイルを作成できます。

編集モードで <ルートプロジェクト> パンくずリスト項目をクリックすると、ルートプロジェクト設定に移動できます ...

Navigate to Root project

または、<your_server_URL>/admin/editProject.html?projectId=_Root の URL に直接アクセスしてください。ユーザー権限はプロジェクトベースであるため、設定を編集できるのはルートプロジェクト管理者のみであることにご注意ください。

TeamCity UI で新しいプロジェクトを作成する

新しい TeamCity プロジェクトは、対応するサイドバーボタンを使用して追加できます。プロジェクトメニュー項目の横にある作成ボタンを使用すると、ルートプロジェクトが直接所有するトップレベルプロジェクトを追加できます。

Create new project

既存のプロジェクトのサブプロジェクトを追加するには、そのプロジェクトの横にある同一のボタンをクリックします。

Create new subproject

新規プロジェクトページでは、プロジェクトの名前と (オプションで) 説明を入力するように求められます。

Main create project page

作成をクリックするとプロジェクトが作成され、TeamCity をクリックするとビルドを設定するページが表示されます。このページでは、新しいプロジェクトの子要素を追加できます。

  • ビルド構成 — 同じエージェント上で実行される一連のビルドステップ。様々なビルド機能を含めることができ、ビルドチェーン内の他の構成へのリンクも作成できます。この典型的な TeamCity エンティティは、最も高度な制御機能を備え、高度なシナリオをサポートしますが、新規ユーザーにとっては設定が難しい場合があります。

  • パイプライン — ビルドステップを含むジョブのコレクションです。高度なビジュアルエディターと YAML サポートを備えた直感的な UI を備えています。この新しいエンティティは現在も開発が進められており、ビルド構成のすべての機能を備えているわけではありませんが、使いやすく、シンプルなワークロードや初心者に適しています。

これらのオプションのいずれかを選択するか、ページ右上の「閉じる」をクリックしてください。後者のオプションを選択すると、空の新規プロジェクトが作成されます。このプロジェクトを使用してプロジェクト階層を設定できます。まず最上位プロジェクトを作成し、後でサブプロジェクトを追加できます。ビルド構成やパイプラインは、プロジェクト設定の「一般」タブ、またはナビゲーションサイドバーの「+」アイコンをクリックすることでいつでも追加できます。

Kotlin DSL で新しいプロジェクトを作成する

次の Kotlin コードは、2 つのサブプロジェクトを持つプロジェクトを作成します。

object MyProject: Project({ name = "Main" description = "The main project" subProject { id("AllTests") name = "Subproject for different kinds of tests" } subProject { id("Packages") name = "Subproject for packages" } })

リモートリポジトリに保存されている設定をインポートする TeamCity プロジェクトを作成するには:

  1. 新規プロジェクトページで、プロジェクト DSL をインポート (クラシック UI) をクリックします (上記のイメージを参照)。

  2. 手動タイルを選択して空のプロジェクトを作成し、その名前を入力します。

  3. プロジェクト設定で、バージョン対応設定タブに移動します。

  4. 同期が有効になっていますをチェックし、VCS ルートを作成するをクリックします。

    New settings VCS root

  5. DSL 設定を保存するリモートリポジトリに接続するようにルートを設定します。詳細については、VCS ルートの設定の記事を参照してください。

  6. 適用をクリックします。TeamCity がリポジトリに接続したら、VCS からプロジェクト設定をロードします ... を選択します。

  7. デフォルトでは、TeamCity はプロジェクト設定に双方向同期を使用します。

    • TeamCity UI で行われた編集は、VCS にコミットされます。

    • バージョン設定の変更は UI に反映されます。

    構成ファイルを唯一の編集可能なソースにするには、UI 経由でプロジェクト設定を編集できるようにするチェックボックスをオフにします。

詳細については、次の記事を参照してください。

REST API から新しいプロジェクトを作成する

次のリクエストは、特定の親プロジェクトが所有する新しい空の TeamCity プロジェクトを作成します。

export TEAMCITY_SERVER_URL="<Your TeamCity Server URL>" curl --location $TEAMCITY_SERVER_URL'/app/rest/projects' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <Your TeamCity Access Token>' \ --data '{ "name": "New Project from REST", "parentProject": { "locator": "id:Parent_Project_ID" }

詳細については、次の REST API ドキュメント記事を参照してください: プロジェクトの作成と削除。

プロジェクトの管理

利用可能なすべてのプロジェクトとサブプロジェクトは、プロジェクトページでデフォルトでアルファベット順にリストされて表示されます。管理者はデフォルトの順序をカスタマイズできます。

リストからプロジェクトを選択すると、TeamCity はプロジェクトホームページを表示し、ネストされたビルド構成と最近のビルド結果をプレビューできます。プロジェクトの設定にアクセスするには、右上隅の対応するトグルをクリックして編集モードに切り替えます。

プロジェクトをコピー、移動、削除、アーカイブするには、プロジェクト設定ページの右上隅にあるアクションメニューを使用します。

Project Actions menu

これらのオプションはルートプロジェクトでは使用できません。

プロジェクトをコピーする

プロジェクトアクションメニューを呼び出し、プロジェクトのコピー ... をクリックします。プロジェクト管理者はプロジェクトをコピーしたり、別のプロジェクトに移動したりできます。

コピーでは、元のプロジェクトのすべての設定、サブプロジェクト、ビルド構成、テンプレートが複製されますが、ビルドに関連するデータは保存されません。コピーは、空のビルド履歴と統計なしで作成されます。

プロジェクトを同じ親または別の親にコピーできます。

コピーすると、TeamCity は自動的に新しい名前を割り当て、コピーには ID が割り当てられます。名前と ID を手動で変更することもできます。
プロジェクト関連のユーザー、エージェント、その他の設定をコピーするオプションを選択すると、通知ルールやエージェントの互換性などのすべての設定が、影響を受けるすべてのユーザーとエージェントのコピーされたプロジェクトと元のプロジェクトでまったく同じになります。

ビルド構成のビルド番号をコピーすることもできます。

プロジェクトを移動する

プロジェクトアクションメニューを呼び出し、プロジェクトの移動 ... をクリックします。

プロジェクトを移動すると、TeamCity はすべての設定、サブプロジェクト、ビルド構成 / テンプレート、関連データ、ビルド履歴を保持します。

プロジェクトをアーカイブする

プロジェクトアクションメニューを呼び出し、プロジェクトをアーカイブ ... をクリックします。TeamCity プロジェクトのアーカイブの詳細については、次のヘルプ記事を参照してください: アーカイブプロジェクト。

一括編集 ID

  1. プロジェクトアクションメニューを呼び出し、一括編集 ID をクリックします。

  2. 現在のプロジェクトとビルド構成 ID が表示されます。すべてのサブプロジェクト、VCS ルート、ビルド設定、テンプレートの ID を修正またはリセットできます。再生するをクリックして新しい ID を自動的に取得するか、手動で編集します。

  3. サブミットをクリックします。

一時停止 / アクティブ化トリガー

プロジェクトアクションメニューを呼び出し、一時停止 / 有効化 ... をクリックして、このプロジェクトが所有する複数のビルド構成に対して構成されたトリガーを一時的に無効にします。

プロジェクトをエクスポートする

プロジェクトアクションメニューを呼び出し、プロジェクトをエクスポート ... をクリックしてプロジェクトを別の TeamCity サーバーに移動します。

プロジェクトを削除する

プロジェクトアクションメニューを呼び出し、プロジェクトの削除 ... をクリックします。

プロジェクトを削除すると、TeamCity は .xml 構成ファイルを削除します。削除後、プロジェクトは \< TeamCity データディレクトリ \>/config/_trash/.ProjectID.projectN ディレクトリに移動されます。削除されたプロジェクトのデータベースに保存されているすべてのプロジェクト関連データ (ビルド履歴、アーティファクトなど) が、次のビルド履歴のクリーン上へ中に完全に削除されるまでのタイムアウト (デフォルトでは 5 日間) を設定できます。

TeamCity データディレクトリ /config/_trash/ ディレクトリは自動的には消去されないため、削除されたプロジェクトが必要ない場合は手動で空にすることができます。

2025 年 10 月 19 日
GoogleMail を通知サーバーとして設定する プロジェクト設定

関連ページ：

ビルド構成の作成と編集

ビルド構成とパイプラインは、実際の CI/CD ルーチンを表します。ビルド構成には、一連のビルドステップ（ビルド実行中に実行される基本操作）と、これらのステップの実行に必要な設定が格納されます。これらの設定には以下が含まれます。構成の動作をすばやく変更できるパラメーター。特定の条件が満たされたときに TeamCity が自動的に新しいビルドを開始できるようにするトリガー。構成の機能を拡張する機能を構築します。特定のビルドエージェントで構成ビルドを実行できるようにするエージェント要件。その他。ビル...

パイプラインの作成と編集

パイプラインは、従来のビルド構成やビルドチェーンに代わる、ユーザー中心で簡素化された代替手段であり、TeamCity 2025.07 以降のバージョンで利用可能です。まだ早期アクセス段階であり、潜在的な問題があるため複雑な設定には推奨されませんが、実験的な機能とはみなされておらず、小規模で要求の少ないプロジェクトであれば本番環境で安全に使用できます。パイプラインとビルド構成とチェーン：パイプラインの作成に進む前に、ビルド構成とパイプラインの違い、それぞれをいつ使用するかを理解することが重要です...

接続を構成

TeamCity 接続は、外部サービスへのアクセスに必要な資格情報を保存します。このサードパーティサービスの種類に基づいて、2 つの主要な接続カテゴリがあります。VCS 接続これらの接続は、GitHub、GitLab、Bitbucket クラウドなどの VCS プロバイダーへのアクセスに必要な情報を保存します。これらの接続は、プロジェクト、ビルド構成、パイプラインを最も速く作成する方法を提供します。認証は自動的に処理されるため、リポジトリを選択するだけでビルドステップの設定を開始できます。接続が...

クラウドのホストビルドエージェント

TeamCity とクラウド (IaaS) ソリューションの統合により、TeamCity は TeamCity エージェントをオンデマンドで実行する仮想マシンを提供できるようになります。これにより、TeamCity は現在のワークロードに応じてアクティブなビルドエージェントの数を自動的に調整できます。クラウドエージェントとエグゼキューター：TeamCity は次の 2 種類の統合をサポートしています。通常のクラウドエージェント。この統合タイプでは、ビルドエージェントをホストする環境として、クラ...

Amazon EC2 用の TeamCity のセットアップ

TeamCity Amazon EC2 統合により、TeamCity は、現在のビルドキューのワークロードに応じて、クラウドでホストされているエージェントをオンデマンドで自動的に開始および停止することで、ビルドリソースを自動スケールできます。共通情報：TeamCity では、さまざまなタイプの EC2 統合をセットアップできます。使用する設定とソースに応じて、クラウド AWS ホスト型エージェントは以下で実行できます。同じ Amazon マシンイメージ (AMI) から複製された複数の同一のイ...

プロジェクト管理者ガイド

このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...