ブランチベースのキャッシュからキーベースのキャッシュへの移行
As of May 2025, Bitrise is starting to deprecate its branch-based caching in favor of the more efficient and flexible key-based caching system.
2025年5月現在、Bitriseはより効率的で柔軟性の高いものを優先して、ブランチベースのキャッシュを廃止し始めています。 キーベースのキャッシュシステム。
非推奨プロセス中に、ブランチベースのキャッシュ（マッチングキーベースのキャッシュ）に最大15GBのキャッシュアーカイブサイズ制限が導入される予定です。15 GB を超えるキャッシュアーカイブを保存すると失敗し、キャッシュステップはスキップされます
圧縮率の高いキーバリューキャッシュに移行し、関連するファイルのみをキャッシュするようにしてください（下記のガイドを参照）。
ビルドでより小さなキャッシュアーカイブを使用している場合は、ブランチベースのキャッシュステップは引き続き機能しますが、キーベースのキャッシュを移行すると、ほとんどすべてのケースでキャッシュパフォーマンスが向上するため、それでもキーベースのキャッシュを移行することをお勧めします。
このガイドは、プロジェクトをキーベースのキャッシュインフラストラクチャに移行するのに役立ちます。
キャッシュシステム間の相違点
一般に、キーベースのキャッシュは、ブランチベースのキャッシュよりも効率的ではるかに強力です。この表では、2 つのキャッシュ方法を機能セットに基づいて比較しています
|
特徴 |
ブランチベースのキャッシュ |
キーベースのキャッシュ |
|---|---|---|
|
キャッシュスコープ |
ブランチごとに 1 つのキャッシュ |
キーで識別される複数のキャッシュ |
|
ビルド間でのキャッシュ共有 |
同じブランチとスタックに限定 |
ワークフロー、ブランチ、スタック間で共有可能 |
|
使用手順 |
|
|
|
有効期限 |
ブランチでの新規ビルドなしで 7 日間 |
前回使用から 7 日間 |
|
フォールバックメカニズム |
フォールバックとして使用されるデフォルトのブランチキャッシュ |
複数のフォールバックキーを設定できます |
|
最大キャッシュアーカイブサイズ |
制限なし (移行が開始されるまで) |
15 ギガバイト |
|
キャッシュアーカイブへのファイル/パスの追加 |
手動またはキャッシュをサポートする他のBitriseステップで設定 |
手動または専用のキャッシュ手順で設定 |
|
ファイルを無視する |
|
個別の無視リストなし |
|
パフォーマンス/スピード |
遅い (gzip アーカイブが大きく、ストレージバックエンドが遅い) |
より速く (最先端) スタンダード 圧縮と高速ストレージ (バックエンド) |
|
依存関係マネージャー専用のキャッシュステップ |
ご利用いただけません |
ご利用可能 ほとんどの依存関係管理者 |
ブランチベースのキャッシュの置き換え手順
キーベースのキャッシュを使用するには 2 つの方法があります。1 つはジェネリックを使用する方法です。 キャッシュを復元 と [キャッシュを保存] ステップ、または特定の依存関係マネージャー用の専用キャッシュステップ経由依存関係マネージャーがサポートされていない場合や、特別な設定が必要な場合を除き、専用のステップを使用することを強くお勧めします
専用のキャッシュステップを使用する
専用キャッシュ特定の依存関係マネージャーのステップ依存関係をキャッシュします。
たとえば、ビルドで Gradle を実行する場合、専用のステップで Gradle の依存関係をキャッシュできます。専用のステップは通常、これ以上設定する必要はありません。ワークフローに追加するだけです
専用ステップの全リスト
以下の手順は、専用のキーベースのキャッシュステップを使用する場合の例にすぎません。この例ではGradleを使用していますが、専用のステップがいくつかあります。ステップの詳細なリストについては、以下を参照してください 依存関係マネージャーの専用キャッシュ手順.
-
を交換してください キャッシュ:プル ステップウィズ Gradle キャッシュを復元する ワークフローのステップ。このステップでは Gradle キャッシュがダウンロードされます
-
を交換してください キャッシュ:プッシュ ステップウィズ Gradle キャッシュを保存する ステップ 3。このステップは Gradle キャッシュを更新します
すべてのキーベースのキャッシュステップは同様の命名規則に従います。復元ステップはキャッシュをダウンロードし、保存ステップはキャッシュを更新します。キーベースのセットアップで少なくとも 2 回ビルドを実行したら、からキャッシュアーカイブを検索してダウンロードできます プロジェクト設定 ページ: ビルド外のキーベースのキャッシュ アーカイブの管理。
一般的なキーベースのキャッシュ手順を使用する
専用のキャッシュステップで目的の結果が得られない場合は、ジェネリックの使用を検討してください キャッシュを復元 と [キャッシュを保存] 手順。これらのステップは、ニーズに完全に合うように設定できます。次のことができます。
一般的なステップでレシピをキャッシュする
一般的なステップを利用したキーベースのキャッシュレシピをご覧ください。 高度なキーベースのキャッシュレシピ。