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

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

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

- 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'