ビルドキャッシング
「ビルドキャッシュ」機能を使用すると、ビルド構成や ジョブで、ビルド実行中に生成された特定のファイル（ダウンロードされた npm パッケージや Maven ローカルリポジトリアーティファクト(英語)など）を公開できます。 公開されたキャッシュは、公開した構成、または他の構成やジョブによって、後続のビルドで再利用できます。 この手法により、ビルドルーチンが最適化され、高速化されます。
共通情報
キャッシングパブリッシャーとコンシューマー
ビルドキャッシュ機能を 2 つのモードのいずれかで動作するように設定できます。
初期ビルドキャッシュ設定により、この機能は、以前のビルド中に同じ機能によって公開されたキャッシュをダウンロードできます。
あるいは、1 つのビルドキャッシュ機能でキャッシュを公開し、別のビルドキャッシュ (別のビルド構成から) でキャッシュをダウンロードするように設定することもできます。 このモードでは、「パブリッシャー」機能と「コンシューマー」機能を設定して、異なるビルド構成間でキャッシュを交換できます。 キャッシュコンシューマー機能の数に制限はありませんが、キャッシュパブリッシャーと 同じプロジェクト に属している必要があります。
サイズ制限
キャッシュは、 .teamcity.ビルド_キャッシング フォルダーに 非表示のアーティファクトとして公開されます。 公開されたキャッシュを表示するには、 アーティファクトタブ の 隠しアーティファクトを表示 リンクをクリックします。
キャッシュはアーティファクトとして公開されるため、 管理 | グローバル設定ページで設定できる ビルドアーティファクトファイルの最大サイズ 設定の影響を受けます。
操作の順序
ビルド構成がキャッシュをアップロードするように構成されている場合、ビルドステージは次の順序で配置されます。
アーティファクトの依存関係を解決する
ソースをチェックアウトする
ダウンロードキャッシュ
ビルドを開始する
同じビルド構成内でキャッシングを公開して使用する
このセクションでは、ビルド構成で以前のビルドのキャッシュを再利用できるビルドキャッシュ機能をセットアップする方法を説明します。
ビルド機能を追加をビルド構成に追加し、一意の キャッシングお名前を指定します。
この機能でキャッシュの公開と使用の両方を行う必要があるため、 公開 と キャッシングを使用 の両方の設定を有効のままにします。
キャッシュする必要があるファイルとフォルダーへのパスを指定します。 各パスは新しい行から開始する必要があります。 ワイルドカードはサポートされていません。 相対パスはチェックアウトディレクトリに対して解決されます。
例:
npm インストールまたはyarn インストールコマンドによってダウンロードされた NodeJS パッケージをキャッシュするには、このフィールドにノード_モジュール/と入力します。デフォルトでは、新しいビルドは、以前のビルドで公開されたものと同一のキャッシュを公開しません。 各ビルドでキャッシュをアップロードする場合は、 変更された場合のみ公開設定のチェックを外します。
設定を保存します。 ビルド機能 ページの機能の説明には、同じキャッシュを公開および使用することが記載されている必要があります。
ビルドを実行し、キャッシュされたすべてのファイルがビルド結果ページで「.teamcity.build_cache」 隠しアーティファクトとして利用できることを確認します。
前回の実行中に公開されたキャッシュが使用されていることを確認するには、ビルドを再度実行し、ビルドログで対応するメッセージを確認します。
別々のビルド構成間でキャッシングを交換する
このセットアップでは、1 つのビルド構成に追加された「パブリッシャー」ビルドキャッシュ機能がそのキャッシュを公開し、別の構成に追加された「コンシューマー」ビルドキャッシュ機能がこのキャッシュをダウンロードします。 ダウンロードされたキャッシュは、パブリッシャーの 公開ルール パスと一致する同じ場所に配置されます。
同じプロジェクトに属する構成の機能を追加する限り、パブリッシャーとコンシューマーの機能を必要な数だけセットアップできます。
パブリッシャーをセットアップする
ビルド機能を追加をビルド構成に追加し、一意の キャッシングお名前を指定します。
キャッシュする必要があるファイルとフォルダーへのパスを指定します。 各パスは新しい行から開始する必要があります。 ワイルドカードはサポートされていません。 相対パスはチェックアウトディレクトリに対して解決されます。
例:
npm インストールまたはyarn インストールコマンドによってダウンロードされた NodeJS パッケージをキャッシュするには、このフィールドにノード_モジュール/と入力します。デフォルトでは、新しいビルドは、以前のビルドで公開されたものと同一のキャッシュを公開しません。 各ビルドでキャッシュをアップロードする場合は、 変更された場合のみ公開設定のチェックを外します。
キャッシングを使用 チェックボックスをオフにします。
設定を保存します。 ビルド機能 ページの機能の説明には、キャッシュを公開するだけであると記載されている必要があります。
ビルドを実行し、キャッシュされたすべてのファイルがビルド結果ページで「.teamcity.build_cache」 隠しアーティファクトとして利用できることを確認します。
コンシューマーをセットアップする
ビルド機能を追加してビルド構成に追加し、パブリッシャー機能が使用するのと同じ キャッシングお名前 を指定します。
公開 チェックボックスをオフにします。
設定を保存します。 ビルド機能 ページの機能の説明には、キャッシュのみを使用することが記載されている必要があります。
新しいビルドを実行し、ビルドログをチェックして、必要なキャッシュファイルがダウンロードされていることを確認します。
この公開されたキャッシュを必要とするすべてのビルド構成について、上記の手順を繰り返します。