Skip to main content

ビルドでのキャッシュの使用

概要

キャッシュには、2つの専用のBitriseステップを使用できます。Bitrise.ioキャッシュプルを使用してキャッシュを利用し、ビルドでそのコンテンツを使用します。Bitrise.ioキャッシュプッシュを使用して、ビルドの情報をキャッシュに保存します。

ブランチベースのキャッシュ vs キーベースのキャッシュ

このガイドは、従来のブランチ ベースのキャッシュに関するものです。キーベースのキャッシュについては、詳細ガイドをご覧ください。 キーベースのキャッシュ.

専用のキーベースのキャッシュ手順については、こちらをご覧ください。 依存関係マネージャーの専用キャッシュ手順.

ビルドでキャッシュを使用する基本はシンプルで、ワークフローに応じてすぐに使用できます。2つの専用ステップを使用するだけです。

  1. 追加します Bitrise.ioキャッシュ:プルステップ キャッシュが必要になる直前。

    たとえば、iOSアプリの場合、 Bitrise.ioキャッシュ:プル 間のステップ Gitクローンリポジトリ および依存関係インストーラーの手順( CocoaPodsインストールを実行します または カルタゴ 手順)。あなたは置くべきではありません Bitrise.ioキャッシュ:プル の前のステップ Gitクローンリポジトリ ステップ。

    キャッシュの有効期限を作成する

    特定のブランチに関連するビルドキャッシュは、7日後に期限切れになります。つまり、自動的に削除されます。ただし、その間にそのブランチに新しいビルドがない場合に限ります。これは、特定のブランチで1週間以上頻繁にビルドを行う場合、キャッシュが削除されないことを意味します。その特定のブランチで7日を超えてビルドを開始しない場合、関連するキャッシュが削除され、次のビルドは最初のビルドと同じように実行されます。

  2. 追加します Bitrise.ioキャッシュ:プッシュ ワークフローの最後のステップとしてのステップ。

単純なユースケースの場合、それだけです。あなたがしなければならないのはそれだけです。これらのステップは、独自のキャッシュ機能を備えたステップと一緒にすぐに機能します。ただし、詳細を確認して独自のキャッシュ構成を作成したい場合は、このまま読み進めてください。

プルリクエストビルド

デフォルトでは、プルリクエストによってトリガーされるビルドを実行すると、 Bitrise.ioキャッシュ:プッシュ ステップは機能しません。この場合、プルリクエストビルドはビルドキャッシュを読み取ることはできますが、更新することはできません。

これは変更しないことを強くお勧めします。セキュリティの観点から、ベストプラクティスは、プルリクエストビルドが他のBitriseビルドに影響を与える可能性のあるものを変更しないようにすることです。

どうしても変更する必要がある場合は、 run_if アプリの表現 bitrise.yml ファイル。についてもっと読む run_if 式: ステップを条件付きで有効または無効にする

ビルドキャッシュの構成/ガイドの例は、 ビルドキャッシュディスカッションページ

ビルドキャッシュにファイルとフォルダーを含める

前述のように、で指定されたすべてのファイルとフォルダ Bitrise.ioキャッシュ:プッシュ ステップの キャッシュパス ステップが特定のフォルダーとファイルを無視するように構成されていない限り、入力はキャッシュされます。ほとんどの場合、この入力を変更する必要はありません。独自のキャッシュ機能が組み込まれているステップを使用する場合、特定のユースケースがない限り、ファイルやフォルダーの指定について心配する必要はありません。

ステップにキャッシュ機能があるかどうかを確認するには、その入力を確認してください。キャッシュをオンまたはオフにする入力がない場合、問題のステップには独自のキャッシュ機能がありません。

独自のキャッシュ機能を持たないステップのファイルを含めるには:

  1. ワークフローで、 Bitrise.ioキャッシュ:プッシュ ステップ。

  2. を見つける キャッシュパス 入力。

  3. キャッシュに含めるファイルとフォルダーの1つまたは複数のパスを追加します。絶対パス、またはリポジトリのルートからの相対パスのいずれかを使用できます。

ファイルと依存関係を無視する

あなたはまた言うことができます Bitrise.ioキャッシュ:プッシュ 特定のコンテンツを明確に無視する手順。無視するということは、次の2つのいずれかを意味します。

  • ファイルまたはフォルダーの変更はチェックされません。指定されたパスが以前のキャッシュアーカイブに含まれている場合、以前と同じ内容で新しいパスに含まれます。

  • ファイルまたはフォルダは完全に除外されます。つまり、変更に関係なく、キャッシュにはまったくアップロードされません。

ファイルまたはフォルダのいずれかに対していずれかのオプションを選択できます。

特定のファイルまたはフォルダーを無視するには:

  1. ワークフローで、 Bitrise.ioキャッシュ:プッシュ ステップ。

  2. を見つける 変更チェックからパスを無視する 入力。

  3. 無視するファイルとフォルダーの1つまたは複数のパスを追加します。絶対パス、またはリポジトリのルートからの相対パスのいずれかを使用できます。

    • 特定のパスをキャッシュアーカイブから完全に除外する場合は、パスの前に !。例えば、 !my/path/

    • 特定のパスを変更チェックから除外する場合は、プレフィックスなしでパスを追加するだけです。パスが無視されたキャッシュパスアイテム内にあり、パスの前に !、パスはキャッシュアーカイブに含まれますが、変更がないかチェックされません。たとえば、追加した場合 my/path/ 入力に対して、パスディレクトリはアーカイブに含まれますが、変更がないかチェックされません。

    もちろん、パスに特定のパターンを指定することもできます。例えば:

    • パス要素を *a/*/b:これは一致します a/x/b

    • パスの一部を **a/**/b 一致します a/x/y/z/b

    • でディレクトリ全体を無視する /。例えば、 /my/full/path/ パスフォルダ内のすべてを無視します。

パスを無視する

無効なキャッシュアイテムになるパスを無視することはできません。たとえば、 a/path/to/cache キャッシュされるパス、無視することはできません a/path/to、それはすべてのファイルを無視し、変更をチェックしないため、フィンガープリントを生成できませんでした a/path/to/cache。これでステップが失敗することはありません。次の警告が表示されるだけです。 No path to cache, skip caching...

ただし、キャッシュパス内のパスは無視できます。たとえば、パスが a/path/to/cache、無視できます a/path/to/cache/.ignore-me、それが内部の唯一のファイルでない限り a/path/to/cache

ビルドキャッシュのダウンロードまたは削除

キャッシュを生成したすべてのブランチのビルドキャッシュをダウンロードして削除できます。キャッシュのサイズと、特定のキャッシュが最後に使用された時刻を確認できます。

単一のブランチのキャッシュを削除する

単一のブランチに関連するキャッシュのみを削除する場合は、デフォルトのブランチのキャッシュも削除する必要があります。これは、ビルドがキャッシュのないブランチで実行される場合、Bitrise.ioキャッシュ:プルステップ デフォルトのブランチのキャッシュを取得します。

ビルドキャッシュを管理するには:

  1. Bitriseでアプリを開くには、 管理者 アプリチームでの役割

  2. に移動します 設定 タブ。

    project-settings-button.png
  3. 左側で、 ビルド

  4. を見つけるビルドキャッシュの管理セクション。

  5. を選択 ブランチベース (レガシー) キャッシング タブ。

ポップアップウィンドウでキャッシュアーカイブを確認できます。キャッシュアーカイブのいずれか、またはすべてをダウンロードまたは削除できます。