TeamCity 2020.2 ヘルプ

空きディスク容量

空きディスク容量 ビルド機能を使用すると、TeamCity エージェントによって管理されているファイル(他のビルドのチェックアウトディレクトリおよびさまざまなキャッシュ)を削除することにより、ビルド前にエージェントの特定の空きディスク容量を 確保できます。
機能が構成されていない場合、ビルドのデフォルトの空き容量は 3GB です。

ディスクスペースの分析と解放

ビルドの前および各ビルドの準備段階の前に、エージェントは 3 つの場所(エージェントのシステム、エージェントの一時ディレクトリ、およびビルドチェックアウトディレクトリ)で現在利用可能な空きディスク容量を確認します。すべての場所は、同じ指定要件を満たす必要があります。失敗条件が指定されている場合、いずれかの場所が要件を満たさないと、ビルドは失敗します。

その量が必要量より少ない場合、エージェントは先に進む前に他のビルドのデータを削除しようとします。

消去されたデータには以下が含まれます。

  • 削除マークが付けられたチェックアウトディレクトリ

  • 他のビルドのチェックアウトディレクトリの内容を、最近使用された順序とは逆の順序

  • 以前にダウンロードされたアーティファクトのキャッシュ (TeamCity アーティファクト依存関係を介してエージェントにダウンロードされたもの)

  • ローカル Docker キャッシュの清掃

  • ローカル NuGet パッケージキャッシュの清掃

ディスク容量を解放している間にチェックアウトディレクトリが削除されないようにする必要がある場合は、system.teamcity.build.checkoutDir.expireHours プロパティを never に設定します。詳しくはビルドチェックアウトディレクトリを参照してください。

空きディスク容量の設定

Free disk space build 機能を使用して、デフォルトの 3 GB の必要ディスク容量を変更できます。以下の設定を構成します。

設定

説明

必要空き容量

ここでカスタム空きディスク容量の値を指定できます(バイト単位、または kb、mb、gb、tb のいずれかの接尾辞を使用)。

十分なディスク容量を解放できない場合はビルドに失敗します

対応するビルド失敗条件を追加するためにボックスをチェックして下さい。

空きディスク容量の値を設定する他の方法

互換性の理由から、空きディスク容量の値は以下のプロパティで指定できます。ただし、TeamCity の将来のバージョンではプロパティが削除される可能性があるため、Free disk space build 機能を使用することをお勧めします。

プロパティを定義できます。

  • グローバルに構築エージェント用 (エージェントの buildAgent.properties ファイル内)

  • システムプロパティを指定して、特定のビルド構成に対応します。

必要な空き容量の値は、次のプロパティで定義されています。

  • ビルドチェックアウトディレクトリの system.teamcity.agent.ensure.free.space

  • エージェントの temp ディレクトリの場合は system.teamcity.agent.ensure.free.temp.space

teamcity.agent.ensure.free.temp.space が定義されていない場合は、teamcity.agent.ensure.free.space property の値が使用されます。

これらのプロパティの値は、ビルドを開始する前に確保する必要のある空きディスク容量を指定します。値は、数値の後に kb、mb、gb、kib、mib、または gib サフィックスが続く必要があります。バイトにはサフィックスを使用しないでください。
例: system.teamcity.agent.ensure.free.space = 5gb

アーティファクトキャッシュの構成

TeamCity ビルドエージェントは、公開およびダウンロードされたビルドアーティファクトのキャッシュを維持して、同じエージェントへのネットワーク転送を削減します。キャッシュは < エージェントホームを構築する > \ system.artifacts_cache ディレクトリに保存され、空きディスク容量の構築機能が正しく構成されていれば自動的にクリーンアップされます。

アーティファクトのキャッシュが望ましくない場合(たとえば、アーティファクトが大きく、TeamCity 内で使用されていない場合、アーティファクトのキャッシュディレクトリがビルドチェックアウトディレクトリと同じディスク上にない場合、またはビルドで空きディスク領域が定義されていない場合)ビルド機能であり、デフォルトの 3Gb ではビルドには不十分です)、teamcity.agent.filecache.publishing.disabled=true 構成パラメーターをプロジェクトまたはプロジェクトのビルド構成の 1 つに追加することにより、エージェントでのアーティファクトのキャッシュをオフにできます。ただし、エージェントは、アーティファクトの依存関係としてダウンロードされたアーティファクトをキャッシュします。

関連ページ:

クリーンアップ

TeamCity のクリーンアップ機能により、古いビルドデータや不要なビルドデータを自動的に削除できます。サーバーのクリーンアップ構成は管理 | サーバー管理 | クリーンアップ設定で使用可能です。クリーンアップスケジュールの設定が可能で、一般的なクリーンアップ情報が表示されます。特定のプロジェクトに関連するクリーンアップルールは、プロジェクト設定 | クリーンアップ規則で構成されます。これらのルールは、どのデータをクリーンアップし、何を保存するかを定義します。これらは、プロジェクトまたはビルド...

TeamCity データディレクトリ

TeamCity データディレクトリは、TeamCity サーバーが構成設定、ビルド結果、現在の操作ファイルを保存するために使用するファイルシステム上のディレクトリです。ディレクトリはすべての構成設定の主記憶域であり、TeamCity のインストールに不可欠なデータを保持しています。ビルド履歴、ユーザーとそのデータ、その他のいくつかのデータは、データベースに保存されます。ディレクトリおよびデータベースに格納されているデータの説明については、バックアップに関する注意を参照してください。このドキュメ...

TeamCity と Docker の統合

TeamCity には、バンドルされたプラグインとして実装された Docker サポートが付属しています。エージェントコンテナー内で Docker を実行する方法、および TeamCity エージェント Docker イメージに関するその他の情報を読む方法については、Docker Hub のドキュメントを参照してください。要件:統合にはビルドエージェントに Docker をインストールする必要があります。Docker Compose ビルドランナーを使用するには、Docker Compose もインスト...

Golang

Golang ビルド機能により、TeamCity で Go のテスト結果をリアルタイムでレポートおよび履歴に記録できます。ビルドを実行する前に、Go コンパイラーがエージェントにインストールされていることを確認してください。TeamCity で Go テストレポートを有効にするには、次の 2 つの方法のいずれかを使用して、フラグを付けて実行します。このフラグをコマンド行ビルドランナーのスクリプトに追加します。ビルド構成にパラメーターを追加します。フラグを設定するために、必ず 1 つの方法だけを使...