メインコンテンツまでスキップ

ブランチベースのキャッシュからキーベースのキャッシュへの移行

ブランチベースキャッシュはレガシーテクノロジーであり、Bitriseは非推奨としています。より効率的で柔軟なキーベースキャッシュを使用してください。

ビルドで使用するキャッシュアーカイブが15 GB未満の場合、ブランチベースキャッシュStepsは引き続き動作しますが、ほとんどの場合でキャッシュのパフォーマンスが向上するため、キーベースキャッシュへの移行を推奨します。

このガイドでは、プロジェクトをキーベースキャッシュインフラストラクチャに移行する方法を説明します。

キャッシュシステムの違いClick to copy link​

キーベースキャッシュは、一般的にブランチベースキャッシュよりも効率的で、はるかに強力です。次の表では、両方のキャッシュ方式を機能セットに基づいて比較します。

機能ブランチベースキャッシュキーベースキャッシュ
キャッシュのスコープブランチごとに1つのキャッシュキーで識別される複数のキャッシュ
ビルド間でのキャッシュ共有同じブランチおよびスタックに限定Workflows、ブランチ、スタック間で共有可能
使用するStepsCache:Pull と Cache:Push- 汎用のRestore CacheとSave CacheSteps - 6つの依存関係マネージャー向けの専用キャッシュステップ
Expirationブランチで新しいビルドがない状態が7日間続いた場合最後の使用から7日間
フォールバックの仕組みフォールバックとしてDefault branchキャッシュを使用複数のフォールバックキーを設定可能
キャッシュアーカイブの最大サイズ制限なし(移行が発表されるまで)15 GB
キャッシュアーカイブへのファイル/パスの追加手動で設定するか、キャッシュに対応するその他のBitrise stepsで設定手動で設定するか、専用キャッシュSteps経由で設定
ファイルの除外Ignore pathsパラメーター個別の除外リストなし
パフォーマンス/速度低速(gzipアーカイブが大きく、ストレージバックエンドが遅い)高速(最先端のzstd圧縮と高速なストレージバックエンド)
依存関係マネージャー向けの専用キャッシュSteps利用不可ほとんどの依存関係マネージャーで利用可能

ブランチベースキャッシュStepsの置き換えClick to copy link​

キーベースキャッシュを使用する方法は2つあります。汎用のRestore CacheとSave CacheStepsを使用する方法、または特定の依存関係マネージャー向けの専用キャッシュStepsを使用する方法です。依存関係マネージャーがサポートされていない場合や特別な設定が必要な場合を除き、専用のStepsを使用することを強くお勧めします。

専用キャッシュStepsの使用Click to copy link​

専用キャッシュStepsは、特定の依存関係マネージャーの依存関係をキャッシュします。

たとえば、ビルドでGradleを実行する場合、専用のStepsを使用してGradleの依存関係をキャッシュできます。専用のStepsは通常、追加の設定を必要とせず、Workflowに追加するだけです。

専用のStepsの全一覧

以下の手順は、専用のキーベースキャッシュStepsを使用する場合の一例にすぎません。この例ではGradleを使用していますが、専用のStepsは複数用意されています。Stepsの詳細な一覧については、依存関係マネージャー向けの専用キャッシュStepsを参照してください。

  1. Workflow内のCache:PullStepをRestore Gradle CacheStepに置き換えます。このStepはGradleのキャッシュをダウンロードします。
  2. Cache:PushStepをSave Gradle CacheStepに置き換えます。このStepはGradleのキャッシュを更新します。

すべてのキーベースキャッシュStepsは同様の命名規則に従っています。Restore Stepsはキャッシュをダウンロードし、Save Stepsはキャッシュを更新します。キーベースの設定で少なくとも2回ビルドを実行すると、Project settingsページからキャッシュアーカイブを見つけてダウンロードできます。キーベースキャッシュアーカイブへのアクセス。

汎用のキーベースキャッシュStepsの使用Click to copy link​

専用キャッシュStepsで望ましい結果が得られない場合は、汎用のRestore CacheとSave CacheStepsの使用を検討してください。これらのStepsは、ニーズに合わせて自由に設定できます。次のようなことが可能です。

汎用のStepsを使用したキャッシュのレシピ

汎用のStepsを利用したキーベースキャッシュのレシピをご確認ください。高度なキーベースキャッシュのレシピ。