ビルドキャッシュ

パブリッシャーとコンシューマーをキャッシュする

ビルドキャッシュ機能を 2 つのモードのいずれかで動作するように設定できます。

• 初期ビルドキャッシュ設定により、この機能は、以前のビルド中に同じ機能によって公開されたキャッシュをダウンロードできます。

• あるいは、1 つのビルドキャッシュ機能でキャッシュを公開し、別のビルドキャッシュ (別のビルド構成から) でキャッシュをダウンロードするように設定することもできます。このモードでは、「パブリッシャー」機能と「コンシューマー」機能を設定して、異なるビルド構成間でキャッシュを交換できます。キャッシュコンシューマー機能の数に制限はありませんが、キャッシュパブリッシャーと同じプロジェクトに属している必要があります。

サイズ制限

キャッシュは、.teamcity.build_cache フォルダーに非表示のアーティファクトとして公開されます。公開されたキャッシュを表示するには、アーティファクトタブの隠されたアーティファクトを表示するリンクをクリックします。

キャッシュはアーティファクトとして公開されるため、管理 | グローバル設定ページで設定できるビルドアーティファクトファイルの最大サイズ設定の影響を受けます。

操作の順序

ビルド構成がキャッシュをアップロードするように構成されている場合、ビルドステージは次の順序で配置されます。

1. アーティファクトの依存関係を解決する

2. ダウンロードキャッシュ

3. ソースをチェックアウトする

4. ビルドを開始する

パブリッシャーの設定

1. ビルド機能を追加するをビルド構成に追加し、一意のキャッシュ名を指定します。

2. キャッシュする必要があるファイルとフォルダーへのパスを指定します。各パスは新しい行から開始する必要があります。ワイルドカードはサポートされていません。相対パスはチェックアウトディレクトリに対して解決されます。
   

   例: npm install または yarn install コマンドによってダウンロードされた NodeJS パッケージをキャッシュするには、このフィールドに node_modules/ と入力します。

3. デフォルトでは、新しいビルドは、以前のビルドで公開されたものと同一のキャッシュを公開しません。各ビルドでキャッシュをアップロードする場合は、変更された場合のみ公開設定のチェックを外します。

4. キャッシュを使用チェックボックスをオフにします。

5. 設定を保存します。機能を構築するページの機能の説明には、キャッシュを公開するだけであると記載されている必要があります。

   

6. ビルドを実行し、キャッシュされたすべてのファイルがビルド結果ページで「.teamcity.build_cache」隠しアーティファクトとして利用できることを確認します。

コンシューマーの設定

1. ビルド機能を追加するをビルド構成に追加し、パブリッシャー機能が使用するのと同じキャッシュ名を指定します。

2. 公開チェックボックスをオフにします。

3. 設定を保存します。機能を構築するページの機能の説明には、キャッシュのみを使用することが記載されている必要があります。

   

4. 新しいビルドを実行し、ビルドログをチェックして、必要なキャッシュファイルがダウンロードされていることを確認します。

5. この公開されたキャッシュを必要とするすべてのビルド構成について、上記の手順を繰り返します。