fix(build): unblock Algolia prerendering for CI and macOS local builds (#1170)

* docs: document macOS bazelrc.user setup for production build

CONTRIBUTING.mdの初回ビルド手順に、macOSでpnpm buildを通すための
.bazelrc.userコピー手順をIMPORTANTコールアウトとして追記。
.bazelrc.user.exampleにも同等の日本語コメントを併記して
コントリビューターが英語コメントを読まなくても意図を把握できるようにした。

macOSのBazel sandboxがプレレンダリング中のAlgolia API呼び出しを
ブロックする問題はPR #1137で対処済みだが、CONTRIBUTING.mdに
言及がなく初回コントリビューターが踏むため、文書化する。

* ci: allow network in sandbox for Algolia API during SSR prerender

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 が書き出す）で上書きされる。

Author: lacolaco

.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

.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

.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

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
+> ```
+
 ### 開発用サーバーを使った作業
 
 開発用ローカルサーバーを起動すると、ビルド結果を確認しながら翻訳作業ができます。