キャッシング

すべてのBitriseビルドは、クリーンな仮想マシンで実行されます。つまり、通常、キャッシュを使用せずに、依存関係のインストールなど、すべてを仮想マシン上で最初から実行する必要があります。

キャッシュを使用すると、インストールされている依存関係やビルド中に生成されたファイルなど、選択したファイルやディレクトリの内容を保持できます。そして、それは非常に簡単です。ワークフローで2つのステップを使用する必要があります。

  • NS Bitrise.ioキャッシュ:プッシュ ステップは、コンテンツをビルドキャッシュに保存します。

  • NS Bitrise.ioキャッシュ:プル ステップは、次にビルドを実行するときにキャッシュをプルします。

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

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

キャッシュは単一のアーカイブファイルとして保存されます。キャッシュされたパスの内容が何らかの方法で変更されると、ファイル全体が更新されます。ビルドを実行するリポジトリのすべてのブランチには、独自のキャッシュアーカイブがあります。キャッシュを生成されたスタックとは別のスタックで使用しようとすると、キャッシュは使用されないことに注意してください。

デフォルトのブランチキャッシュがフォールバックとして使用されます

ブランチにまだキャッシュが保存されていない場合は、デフォルトのブランチのキャッシュが使用されます。キャッシュは、パブリックBitriseアプリのPRビルドでは使用できません。

で指定されたすべてのフォルダとファイル Bitrise.ioキャッシュ:プッシュ ステップが特定のフォルダーとファイルを無視するように構成されていない限り、ステップのキャッシュパス入力はキャッシュされます。ほとんどの場合、この入力の値を変更する必要はありません。独自のキャッシュ機能を持たないステップによって生成されたファイルをキャッシュする場合にのみ、ここに何かを追加する必要があります。独自のキャッシュ機能を備えたステップのいくつかの例:

  • iOS用のXcodeアーカイブとエクスポート

  • Androidビルド

  • Gradleランナー

  • Cocoapodsインストールを実行します

  • Homebrewインストール

ビルド中にキャッシュにアクセスする方法については、チェックアウトしてください ビルドでのキャッシュの使用

キャッシングに関するテクニカルノート

キャッシュの構築機能は、次の2つの部分に分かれています。

  • ビルドキャッシュAPI。

  • ステップ。

Build CacheAPIはシンプルなAPIです。リソース(ビルドキャッシュアーカイブ)への必要なアクセス権があることを確認し、安全な(期限付きで期限切れの)ダウンロードおよびアップロードURLを提供します。ファイルは処理されません。

ステップは、キャッシュを比較し、キャッシュアーカイブを作成するロジックを実行する責任があります。これは、独自のステップを記述し、独自の比較および圧縮ロジックを実装できることを意味します。唯一の要件は、ステップがBuild CacheAPIを使用してダウンロードおよびアップロードURLを取得する必要があることです。キャッシュファイルの形式や内容に制限はありません。

専用ガイドで独自のステップの開発について詳しく読む: 新しいステップの開発

キャッシュが利用できない可能性があります

キャッシュにアクセスできない場合でもビルドが失敗しないようにコードを作成することをお勧めします。また、キャッシュはインターネット経由でダウンロードされることにも注意してください。通常のダウンロード場所で信頼性の問題がある場合は、リソースまたは依存関係をBitrise Build Cacheに保存すると役立つ場合がありますが、必ずしも時間を節約できるとは限りません。