空きディスク容量

使い方

ビルド前および各ビルド準備段階 (ソースの更新) の前に、エージェントは現在使用可能な空きディスク容量を 3 つの場所で確認します。

• エージェントのシステム

• エージェントの一時ディレクトリ

• ビルドチェックアウトディレクトリ

これらの場所はすべて、指定された同じ要件を満たす必要があります。失敗条件が指定されている場合、いずれかの場所が要件を満たさない場合、ビルドは失敗します。

ディスク容量が必要量より少ない場合、エージェントは続行する前に他のビルドの古いデータを削除しようとします。

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

• 削除対象としてマークされたチェックアウトディレクトリ

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

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

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

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

ディスク領域を解放しているときにチェックアウトディレクトリが削除されないようにする必要がある場合は、system.teamcity.build.checkoutDir.expireHours プロパティを never に設定します。

設定

空きディスク容量構築機能を使用すると、必要なディスク容量のデフォルトの 3 GB を変更できます。以下の設定を構成します。

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

互換性を確保するために、以下のプロパティを使用して空きディスク容量の値を指定できます。ただし、これらのプロパティは将来の TeamCity バージョンで削除される可能性があるため、空きディスク領域のビルド機能を使用することをお勧めします。

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

• グローバルに構築エージェント用 (エージェントの 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 プロパティの値が使用されます。

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

TeamCity が空きディスク容量の値を選択する方法は次のとおりです。

1. エージェントで定義されているか、プロジェクトまたはビルド構成レベルでオーバーライドされている system.teamcity.agent.ensure.free.space を使用します。

2. （1）が定義されていない場合は、エージェントで定義されているか、プロジェクトまたはビルド構成レベルでオーバーライドされている teamcity.agent.ensure.free.space を使用します。

3. （1-2）が定義されていない場合は、ビルド機能で定義されているカスタム値を使用してください。

4. カスタム値が定義されていない場合は、デフォルト値の 3GB を使用します。

アーティファクトキャッシュの無効化

TeamCity ビルドエージェントは、公開およびダウンロードされたビルドアーティファクトのキャッシュを維持して、同じエージェントへのネットワーク転送を減らします。キャッシュは <Build Agent Home>\system\.artifacts_cache ディレクトリに保存され、空きディスク領域の構築機能が正しく構成されていれば自動的に削除されます。アーティファクトの依存関係をダウンロードしている間、キャッシュを格納するための十分なスペースがない場合、TeamCity は自動的にキャッシュを無効にします。

アーティファクトのキャッシュが不要な場合は、プロジェクトまたはそのビルド構成の 1 つに teamcity.agent.filecache.publishing.disabled=true 構成パラメーターを追加することでオフにすることができます。アーティファクトが大きく、TeamCity 内で使用されていない場合、またはアーティファクトキャッシュディレクトリがビルドチェックアウトディレクトリと同じディスク上にない場合に役立ちます。ただし、キャッシュを保存するのに十分なスペースがある場合、エージェントはアーティファクトの依存関係としてダウンロードされたアーティファクトを引き続きキャッシュします。