メインコンテンツまでスキップ

非Bitrise CI環境でのBuild Cache for Gradleの設定

Bitrise Build Cache では、Bitrise CI を使用する必要はありません。他の CI/CD サービスを使用しながら、キャッシュを活用して Gradle ビルド時間を短縮できます。

そのためには、ビルド中に Bitrise Build Cache CLI をダウンロードするよう CI 環境を設定し、続いて CLI を実行して Bitrise Build Cache を有効にします。

手動で手順を進める代わりに、AIコーディングエージェントを使用してセットアップすることもできます。Getting started with AI を参照してください。

GitHub Actions の使用

GitHub Actions のワークフロー例を掲載した専用ガイドがあります。Configuring the Build Cache for Gradle in GitHub Actions を参照してください。

トークンの選択Click to copy link​

CI の連携には、workspace API トークンを使用してください。このトークンは個人ではなくworkspaceに属するため、担当者のロールが変わったり退社したりしても、ビルドは引き続き動作します。

Personal Access Tokenも使用できますが、作成したユーザーのロールを引き継ぎ、そのユーザーがworkspaceを離れると動作しなくなります。

ご自身のマシンでは、どちらも必要ありません。CLIがブラウザー経由でサインインし、認証情報をOSキーチェーンに保存します。お使いのビルドツール向けのローカルガイドについては、ローカル開発環境でのセットアップを参照してください。

キャッシュの設定Click to copy link​

  1. workspace API トークン を作成し、その値をコピーします。

    トークンには、少なくとも viewer workspace ロールを付与してください。これは Build Cache にアクセスできる最も低いロールです。

  2. workspace のスラッグを取得します。Workspace settings ページを開き、左側のナビゲーションメニューで General settings を選択します。

  3. CI の設定に、次の Environment Variables を設定します。

    • BITRISE_BUILD_CACHE_AUTH_TOKEN: workspace API トークン。
    • BITRISE_BUILD_CACHE_WORKSPACE_ID: Bitrise workspace スラッグ。

  4. 高速化したいステップの前に、CI の設定へ次のスクリプトを追加します。

    環境

    高速化したい Gradle コマンドと同じ環境でスクリプトを実行してください。たとえば、ビルド全体で複数の Docker コンテナーを使用する場合は、Bitrise Build Cache CLI が、その Gradle コマンドと同じ Docker コンテナーで実行されるようにしてください。

    #!/usr/bin/env bash
    set -euxo pipefail

    # download Bitrise Build Cache CLI
    curl --retry 5 -sSfL 'https://raw.githubusercontent.com/bitrise-io/bitrise-build-cache-cli/main/install/installer.sh' | sh -s -- -b /tmp/bin -d

    # run the CLI to enable Bitrise build cache for Gradle
    /tmp/bin/bitrise-build-cache activate gradle --cache --cache-push

関連情報