ビルドでキーベースのキャッシュを使用する

キャッシュ エントリは、最後の使用から 7 日間保持されます。ワークフローで 7 日間連続して使用されない場合、それらは自動的に削除されます。

キャッシュ ストレージの許容量が不足すると、アプリの LRU (Least Recent Used) キャッシュ エントリは、作成された新しいキャッシュ エントリに置き換えられます。 LRU は、新しいデータ用のスペースを確保するために、使用頻度が最も低いデータを削除するキャッシュ置換アルゴリズムです。これは、置換されたキャッシュ エントリがワークフローで必要な場合、キャッシュ ヒット率が低下する可能性があることを意味する場合があります。にアップグレードすることをお勧めします より高い計画 ワークフローで必要となる可能性のあるキャッシュ エントリを失わないように、より多くのストレージを取得します。

キャッシュ アーカイブが作成されると、 アプリの設定 ページ： ビルド外のキーベースのキャッシュ アーカイブの管理.

どちらのキーベースのキャッシング ステップも、ステップ入力でのテンプレート要素の使用をサポートしています。ステップは実行時にキー テンプレートを評価し、使用される最終的なキャッシュ キーは、ビルド環境またはリポジトリ内の特定のファイルに応じて変わる可能性があります。

- save-cache@1:
    inputs:
    - key: npm-cache-{{ checksum "package-lock.json" }}
    - paths: node_modules

- save-cache@1:
    inputs:
    - key: gradle-cache-{{ checksum "**/*.gradle*" "gradle.properties" }}
    - paths: AndroidApp

- save-cache@1:
    inputs:
    - key: npm-cache-{{ getenv "BITRISE_BUILD_NUMBER" }}
    - paths: node_modules

で複数のキーを定義することができます。 キャッシュキー キーベースのキャッシング手順の入力。 1 行に 1 つのキーをリストすることで、追加のキーを指定できます。リストは優先順位に従っているため、Step は最初に指定した最初のキーに一致するものを見つけようとします。そのキーにキャッシュが保存されていない場合は、2 番目のキーに一致するものを見つけようとします (したがって、の上）。

inputs:
  key: |
    key-1
    key-2
    key-3

複数のキーを一覧表示するだけでなく、各キーを保存されたキャッシュ キーのプレフィックスとして使用しても、一致するキャッシュ アーカイブを取得できます。たとえば、キー my-cache- キーで保存された既存のアーカイブと一致できます my-cache-a6a102ff.最初のキーがチェックサム キーと完全に一致するようにキーを構成し、より一般的なプレフィックス キーをフォールバックとして使用することをお勧めします。

inputs:
  key: |
    npm-cache-{{ checksum "package-lock.json" }}
    npm-cache-

ビルドを実行するたびにキャッシュ アーカイブを更新したくない場合があります。キャッシュをスキップすると、次のことが可能になります。

キャッシュされたコンテンツがビルド中にまったく変更されなかった場合、 キャッシュを保存 ステップは、キャッシュの圧縮とアップロードを自動的にスキップできます。これを機能させるには、キャッシュのコンテンツが変更されるたびに変更される一意のキャッシュ キーがキャッシュ アーカイブにあることを確認する必要があります。実際には、これには チェックサム付きの動的キー キャッシュされたコンテンツを記述するファイル。チェックサムは、ファイルの内容に基づいて計算されます。ファイルが変更されていない場合は、チェックサムも変更されません。

この機能を利用できるようにステップを構成することを強くお勧めします。以下の手順に従うか、スキップして YAML の例.

すべてが正しく構成されている場合、2 つのキャッシュ ステップのキーが一致すると、キャッシュ アーカイブは更新されません。

workflows:    
  caching:      
    steps:      
    - restore-cache@1:          
        inputs:          
        - key: gradle-cache-{{ checksum "**/*.gradle*" "gradle.properties" }}      
    - save-cache@1:          
        inputs:          
        - key: gradle-cache-{{ checksum "**/*.gradle*" "gradle.properties" }}          
        - is_key_unique: 'true'