JetBrains Space ヘルプ

リモートビルドキャッシュストレージの構成

Space のファイルリポジトリをプロジェクトのビルドキャッシュストレージとして使用できます。このようなリモートストレージの目的は、チーム全体のビルドアーティファクトの共有キャッシュとして機能することです。これにより、ビルドプロセスが高速化され、さまざまなマシン間での一貫性が高まり、リソースの使用効率が向上します。これは、多くの依存関係がある大規模なプロジェクトに特に役立ちます。

基本的に、Space のファイルリポジトリは、WebDAV プロトコルをサポートする任意のビルドツールで使用できます。ただし、このトピックでは、最も一般的なビルドツールである Gradle および Bazel の手順のみを説明します。

Gradle プロジェクトのリモートビルドキャッシュ

  1. Space にファイルリポジトリを作成します。

  2. ファイルリポジトリページで、入門をクリックします。

  3. ツールで、プロジェクトで使用する Gradle DSL に応じて Gradle ビルドキャッシュ (Groovy) または Gradle ビルドキャッシュ (Kotlin) を選択します。

  4. 読み取りトークンを生成するを展開し、書き込みトークンを選択します。書き込みトークンを生成するをクリックし、ページに表示されているスニペットをクリップボードにコピーします。

  5. プロジェクトで、Gradle DSL に応じて、settings.gradle または settings.gradle.kts ファイルを開きます。

  6. スニペットをファイルに貼り付けます。例:

    buildCache { remote<HttpBuildCache> { url = uri("https://files.pkg.jetbrains.space/mycompany/p/my-project/cache") // better make it a variable and set it to true only for CI builds isPush = true credentials { username = "John.Doe" password = "here-goes-the-generated-token" } } }
    buildCache { remote(HttpBuildCache) { url = 'https://files.pkg.jetbrains.space/mycompany/p/my-project/cache' // better make it a variable and set it to true only for CI builds setPush(true) credentials { username = 'John.Doe' password = 'here-goes-the-generated-token' } } }

    詳細 (英語)

  7. デフォルトでは、Gradle ではビルドキャッシュの使用が無効になっています。リモートキャッシュを使用するには、--build-cache 引数を指定してビルドを実行するか、gradle.properties ファイルに次の行を追加して永続的に有効にする必要があります。

    org.gradle.caching=true

    詳細 (英語)

Bazel プロジェクトのリモートビルドキャッシュ

  1. Space にファイルリポジトリを作成します。

  2. ファイルリポジトリページで、入門をクリックします。

  3. ツールで、Bazel リモートキャッシュを選択します。

  4. 読み取りトークンを生成するを展開し、書き込みトークンを選択します。書き込みトークンを生成するをクリックし、ページに表示されているスニペットをクリップボードにコピーします。

  5. ローカルマシンで .bazelrc(英語) ファイルを開き、リモートキャッシュ設定をそれに追加します。例:

    build --remote_cache=https://files.pkg.jetbrains.space/mycompany/p/my-project/cache build --remote_header=Authorization="Bearer here-goes-the-generated-token"

    これ以降、bazel build コマンドはデフォルトでリモートキャッシュを使用します。ただし、ベストプラクティスは、CI/CD サーバーを使用してキャッシュデータを作成し、リモートストレージにアップロードすることです。これは、ローカル設定の違いによる潜在的な課題を回避できます。開発者マシンは、読み取り専用モードでリモートキャッシュを使用する必要があります。

    bazel build --remote_upload_local_results=false

    Bazel リモートキャッシュの詳細 (英語)

リモート sccache を使用してキャッシュを構築する

sccache は、C/C++、Rust、その他の言語用のキャッシュツールです。リモートキャッシュは、sccache バージョン 0.54 以降でのみサポートされていることに注意してください。詳細 (英語)

  1. Space にファイルリポジトリを作成します。

  2. ファイルリポジトリページで、入門をクリックします。

  3. ツールで、sccache リモートキャッシュを選択します。

  4. 読み取りトークンを生成するを展開し、書き込みトークンを選択します。書き込みトークンを生成するをクリックし、ページに表示されているスニペットをクリップボードにコピーします。

  5. ローカルマシンで、リモートキャッシュ設定を sccache 環境変数として指定します。これを行うには、次を実行します。

    export SCCACHE_WEBDAV_ENDPOINT="https://files.pkg.jetbrains.space/mycompany/p/my-project/cache" export SCCACHE_WEBDAV_TOKEN="here-goes-the-generated-token"

    この後、通常どおりビルドを実行できます (例: cargo build)。ビルドツールはデフォルトでリモートキャッシュを使用します。

ファイルのダウンロード Maven リポジトリ