From a18a24a9c268a89b230a026982ed1e6bb47b3b92 Mon Sep 17 00:00:00 2001 From: Suguru Inatomi Date: Sat, 6 Jun 2026 22:52:03 +0900 Subject: [PATCH 1/2] docs: document macOS bazelrc.user setup for production build MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CONTRIBUTING.mdの初回ビルド手順に、macOSでpnpm buildを通すための .bazelrc.userコピー手順をIMPORTANTコールアウトとして追記。 .bazelrc.user.exampleにも同等の日本語コメントを併記して コントリビューターが英語コメントを読まなくても意図を把握できるようにした。 macOSのBazel sandboxがプレレンダリング中のAlgolia API呼び出しを ブロックする問題はPR #1137で対処済みだが、CONTRIBUTING.mdに 言及がなく初回コントリビューターが踏むため、文書化する。 --- .bazelrc.user.example | 6 +++++- CONTRIBUTING.md | 8 ++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/.bazelrc.user.example b/.bazelrc.user.example index 0eed6fd36d..ee41f6854d 100644 --- a/.bazelrc.user.example +++ b/.bazelrc.user.example @@ -1,6 +1,10 @@ # Local development settings for macOS # Copy this file to .bazelrc.user to enable these settings. -# # macOS sandbox blocks network access during prerendering (Algolia API calls). # Use local spawn strategy to allow network access. +# +# macOS向けのローカル開発設定です。 +# このファイルを .bazelrc.user という名前でコピーすると有効になります。 +# macOSのBazel sandboxは、プレレンダリング中のネットワークアクセス（Algolia API呼び出し）を +# ブロックするため、sandboxを使わないlocal spawn strategyに切り替えて回避します。 build --spawn_strategy=local diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d5b51c4c2b..0bcb19df64 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -54,6 +54,14 @@ $ pnpm install $ pnpm build ``` +> [!IMPORTANT] +> macOSでビルドする場合は、`pnpm build` を実行する前に `.bazelrc.user.example` を `.bazelrc.user` という名前でコピーしてください（`.bazelrc.user` は `.gitignore` 対象です）。 +> macOSのBazel sandboxがプレレンダリング中のネットワークアクセス（Algolia API呼び出し）をブロックするため、これがないとビルドが失敗します。 +> +> ``` +> $ cp .bazelrc.user.example .bazelrc.user +> ``` + ### 開発用サーバーを使った作業 開発用ローカルサーバーを起動すると、ビルド結果を確認しながら翻訳作業ができます。 From 0f80939cdff5caf1b9bdf7ea8955c0280c13c7ce Mon Sep 17 00:00:00 2001 From: Suguru Inatomi Date: Sat, 6 Jun 2026 23:20:29 +0900 Subject: [PATCH 2/2] ci: allow network in sandbox for Algolia API during SSR prerender MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit build-ubuntu / adev-preview-build の両 workflow で pnpm run build が Algolia の RetryError で失敗していたため、 setup-bazel の bazelrc ブロックに --sandbox_default_allow_network を追加して sandbox からの egress を許可する。 build/.bazelrc 由来の --nosandbox_default_allow_network は home-tier の bazelrc（setup-bazel が書き出す）で上書きされる。 --- .github/workflows/adev-preview-build.yml | 2 ++ .github/workflows/ci.yml | 2 ++ 2 files changed, 4 insertions(+) diff --git a/.github/workflows/adev-preview-build.yml b/.github/workflows/adev-preview-build.yml index daa1321f33..8f8c2a868c 100644 --- a/.github/workflows/adev-preview-build.yml +++ b/.github/workflows/adev-preview-build.yml @@ -41,6 +41,8 @@ jobs: build --jobs=2 build --discard_analysis_cache build --nokeep_state_after_build + # Allow network access in sandbox for Algolia API calls during SSR prerendering. + build --sandbox_default_allow_network - run: pnpm install --frozen-lockfile - name: Build run: pnpm run build diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index a77c7e5abc..80d5bd59f3 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -45,6 +45,8 @@ jobs: build --jobs=2 build --discard_analysis_cache build --nokeep_state_after_build + # Allow network access in sandbox for Algolia API calls during SSR prerendering. + build --sandbox_default_allow_network - run: pnpm install - name: Build run: pnpm run build