プロジェクト設定

編集モードに入ると、TeamCity プロジェクトでは、カテゴリ別にグループ化された設定のサイドバーが表示されます。

これらの設定の一部は、権限が不十分なユーザーはアクセスできない可能性があることに注意してください。

一般

このセクションでは、プロジェクトの公開説明や名前などの基本的なプロジェクト設定と、子サブプロジェクト、ビルド構成、パイプラインを作成するボタンを示します。

テンプレート関連の設定の詳細については、プロジェクトのデフォルトテンプレートの定義およびテンプレートから継承した設定の強制適用のセクションを参照してください。

VCS ルート

このセクションには、プロジェクト構成のいずれかに関連付けられているかどうかに関係なく、このプロジェクトが所有するすべての VCS ルートが一覧表示されます。

パラメーター

パラメータータブでは、このプロジェクトとそのサブプロジェクトが所有するすべての構成で使用できる名前と値のペアを作成できます。

関連記事: ビルドパラメーターの構成 | 入力パラメーターと出力パラメーター

レシピ

レシピは、TeamCity に同梱されていないカスタム構成のビルドステップです。プロジェクト管理者は、以下の手順でレシピを追加できます。

通常のビルドステップからレシピを抽出します。
TeamCity 開発者またはコミュニティが作成したレシピを JetBrains Marketplace からダウンロードします。

このセクションでは、2 番目のオプションが使用可能かどうかを制御できます。

関連記事: レシピの操作について

バージョン対応設定

このセクションでは、コードとしての構成を設定できます: すべてのプロジェクト構成とビルド構成を Kotlin DSL または XML 形式でリモートリポジトリに保存します。

接続

TeamCity 接続は、3rd-party サービス (VCS ホスティング、クラウドホスティングプロバイダー、イメージレジストリなど) のリソースにアクセスするために必要な設定を保存するエンティティです。このセクションでは、このプロジェクトが所有するすべてのサブプロジェクトとビルド構成で利用可能な接続を作成できます。

Maven 設定

このタブでは、個々の Maven ビルドステップで使用できる Maven 設定をアップロードできます。

関連記事: Maven サーバー側設定

課題トラッカー

課題トラッカーとの統合により、TeamCity は新しいコード変更を表示するときに、対応する課題トラッカーのチケットへのリンクを表示できます。 Jira、Bugzilla、YouTrack、GitHub、GitLab、Bitbucket (クラウド、サーバー、データセンター)、Azure DevOps Server (旧称 TFS) はすぐにサポートされます。

関連記事: TeamCity と課題トラッカーの統合

クラウドプロファイル

このセクションでは、オンデマンドで起動し、アイドル時に自動的に停止するクラウドホスト型ビルドエージェントを構成できます。これらのエージェントは、現在のワークロードに基づいて TeamCity ビルドサーバーをスケーリングするのに役立ちます。

ここでは、TeamCity ビルドキューの独立したオーケストレーターとして機能する Kubernetes Executor も設定できます。

アーティファクトストレージ

アーティファクトストレージセクションでは、ビルドによって生成されたアーティファクト用の外部ストレージ (S3 バケットなど) を構成できます。

関連記事: アーティファクトストレージの構成 | アーティファクト移行ツール

SSL / HTTPS 証明書

SSL / HTTPS 証明書タブでは、HTTPS/SSL 接続を確立するときに TeamCity が信頼できると見なす証明書をアップロードできます。

関連記事: SSL 証明書のアップロード

VCS 認証トークン

このタブでは、既存のアクセストークンを追跡し、設定済みの OAuth 接続を利用して新しいアクセストークンを発行できます。これらのトークンを使用して、3rd-party サービスへのアクセスが必要なオブジェクトの認証設定を行います: VCS ルート、コミットステータスパブリッシャー、プルリクエストなど。

関連記事: 更新可能なアクセストークンを管理する

信頼されていないビルド

ビルド構成に VCS トリガーを追加すると、新しいコミットを処理するビルドを自動的に実行できます。ただし、構成が公開リポジトリをターゲットとしていて、プルリクエスト機能が設定されている場合、このセットアップはセキュリティリスクになる可能性があります: TeamCity が外部ユーザーからの悪意のある変更を処理するビルドを自動的に開始できるためです。

このセクションでは、どのプルリクエストを自動的に処理しても安全か、どのプルリクエストが指定されたチームメンバーからの手動承認を必要とするかを制御するための詳細な条件を定義できます。

関連記事: 信頼されていないビルド

プロジェクトの分離

TeamCity ビルド構成では、他の構成とやり取りするために 2 種類の依存関係を使用できます：

チェーン依存関係の構成 — 複数の構成をビルドチェーン内でリンクし、ダウンストリームビルドがアップストリームビルドの完了を待機するようにします。
チェーンでデータを渡す — ある構成が別の構成によって生成されたアーティファクトを使用できるようにします。

これらの依存関係はアップストリーム構成で設定されるため、他の TeamCity プロジェクトの管理者が対象の構成に依存関係を追加できます。プロジェクトに、外部プロジェクトによってトリガーされたり、外部プロジェクトにアーティファクトを提供したりすべきではない機密性の高い設定が含まれている場合は、プロジェクトの分離設定を使用してアクセスを制限してください。

関連記事: セキュアなチェーン依存関係

SSH 鍵

このセクションでは、秘密鍵をアップロード（または新規生成）できます。これらの鍵により、ビルド構成は SSH プロトコルを使用してリポジトリをチェックアウトできるようになります。

レポートタブ

レポートツールが HTML フォーマットのレポートを生成する場合、カスタムタブで TeamCity を拡張し、サードパーティのレポートツールが提供する情報を表示できます。わ。

関連記事: サードパーティレポートをビルド結果に含める

使用箇所レポート

このタブはデフォルトでは非表示で、特定の TeamCity オブジェクトに依存するエンティティを確認すると表示されます。このタブは、オブジェクトがどこで使用されているかを確認し、編集または削除した場合に CI ワークフローのどの部分が影響を受ける可能性があるかを把握できます。

VCS ルート — ルートの設定ページと VCS ルートテーブル内に使用箇所を表示リンクが表示されます。このリンクをクリックすると、このルートが関連付けられているすべてのビルド構成が表示されます。
テンプレート — テンプレート設定の使用箇所タブをクリックすると、このテンプレートに基づくすべての構成と、このテンプレートをデフォルトとして使用するすべてのプロジェクトが表示されます。
ビルド構成 — 構成設定の「使用箇所」タブをクリックすると、この構成に依存するすべての構成が表示されます。依存する構成とは、この構成にスナップショットやアーティファクトの依存関係を持つ構成です。

クリーンアップルール

TeamCity は定期的にサーバー全体のクリーンアップを実行して、古いデータを除去します: 古いビルド、そのアーティファクト、ビルドキャッシングなど。このスケジュールされたアクティビティは、管理 | クリーンアップ設定ページで設定します。クリーンアップルールセクションでは、グローバル設定をオーバーライドするプロジェクトごとのルールを設定できます。

関連記事: TeamCity データクリーンアップ

共有リソース

共有リソース機能を使用すると、テストデータベースや接続数が制限されたサーバーなど、CI サーバーの外部リソースを使用して、同時に実行されるビルドを制限できます。

NuGet フィード

NuGet パッケージを限定された対象者 (たとえば社内で使用する場合) に公開したい場合は、TeamCity を NuGet フィードとして使用できます。 TeamCity プロジェクトに複数の NuGet フィードを設定できます。

組み込みの TeamCity NuGet フィードは、v1、v2、v3 の API バージョンをサポートしています。

関連記事: TeamCity を NuGet フィードとして使用する方法

提案

このタブには、アクティブなヘルスレポートの解決を目的とした TeamCity の自動提案が表示されます。