インボケーション
インボケーションは、リモートキャッシュにおける重要な概念です。インボケーションとは、コマンドを1回実行することを指します。つまり、特定の目的を達成するために特定のコマンドを実行することです。
インボケーションは、Bitrise Build Cacheまたは分析が有効になっている場合にのみカウントされます。課金の対象となるのは、キャッシュされたインボケーション(キャッシュからデータをダウンロードするインボケーション)のみです。データをダウンロードしないインボケーションは課金されません(無料)。
インボケーションの確認Click to copy link
すべてのインボケーションの詳細は、cache historyで確認できます。
-
Build Cacheを開きます。
-
ビルドツールのタブ(Gradle、Xcode、Bazelのいずれか)を選択します。
-
フィルターを選択します。次の項目でフィルターできます。
- 日付
- Bitrise project
- CI provider
- インボケーションのステータス
- Bitrise Workflow
-
invocation listで、任意のインボケーションの左にある下向き矢印をクリックすると、そのインボケーションの基本情報が表示されます。
- Invocation ID。
- 使用されたCIプロバイダー。
- ビルドのURL。
Bitrise CIを使用している場合は、コマンドが実行されたWorkflowとStepが表示されます。
-
右側の矢印をクリックすると、インボケーションの詳細ページが開きます。
Invocation detailsClick to copy link
invocation detailsページには、次の情報が表示されます。
- コマンド名と、そのインボケーションのイベントデータ(CIプロバイダー、ビルドツール、所要時間、キャッシュヒット率など)。
- クリティカルパス: インボケーション内で、依存関係のあるビルドタスクが最も長く連なったもの。実行されたキャッシュ可能なタスクを修正すると、build cacheのパフォーマンスを改善できます。
- インボケーション中のアップロードとダウンロード。大きなアイテムや多数のアイテムがあると、インボケーションのサイズが増加します。これはキャッシュの効率に影響する場合があります。
詳細ページでは、このインボケーションのメトリクスを、同じコマンドの過去30日間の平均と比較できます。
Bitrise CIを使用している場合は、コマンドカードからプロジェクトのbuild listに移動できます。
インボケーションのメトリクスをさらに確認するには、インサイトを参照してください。
インボケーションの差分の比較Click to copy link
2つのコマンドインボケーションを並べて比較すると、両者の間で何が変わったかをすばやく特定できます。これは、デバッグや障害の根本原因分析に役立ちます。
たとえば、Bitrise Insightsでコマンドの失敗が増加していることがわかったとします。どのコマンドが失敗し始めたかを確認します。build cacheページで、そのコマンドの2つのインボケーションの違いを確認できます。
差分を確認するには、次の手順を実行します。
-
Build Cacheを開きます。
-
ビルドツールのタブ(Gradle、Xcode、Bazelのいずれか)を選択します。
-
必要に応じてフィルターを設定します。
-
Compareをクリックします。
-
比較したいインボケーションの右側にあるチェックボックスをオンにします。
-
Compareをクリックすると、差分が表示されます。
この例では、新しい方のインボケーションの所要時間が、前のインボケーションと比べて2倍になっていることがすぐにわかります。詳細な比較を確認すると、その理由を調べられます。
demo.wait.secondsGradleプロパティが28から56に変更されています。
Invocation detailsページからも比較機能にアクセスできます。ボタンはページの右上にあります。