Skip to content

Add Bazel RBE integration guide (DI-574)#237

Draft
celanthe wants to merge 3 commits into
mainfrom
add/bazel-rbe-integration-di574
Draft

Add Bazel RBE integration guide (DI-574)#237
celanthe wants to merge 3 commits into
mainfrom
add/bazel-rbe-integration-di574

Conversation

@celanthe

@celanthe celanthe commented Jun 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • New page: orka/orka-devops-integrations/bazel-rbe.mdx
  • Covers Orka as the macOS worker layer for Bazel Remote Build Execution
  • Two paths: open-source buildfarm (recommended) and BuildBuddy (for teams already using it)
  • Includes multi-worker setup, GitHub Actions automation, LaunchDaemon auto-start, and persistent cache

Status

Draft — pending:

  • Live cluster test to verify the buildfarm setup actually works end-to-end (in progress)
  • Caleb/Jason review of BuildBuddy section framing before publish
  • SME review (Heath Barkdull) on the buildfarm config accuracy

Research

  • MPD-81: Research spike (competitive positioning, value props)
  • One-pager: Tinder pricing comparison (bare metal Option 3 priced higher than Orka Option 1), BuildBuddy snapshot story is Linux-only (confirmed via their own blog), copy-paste framing for "Orka is just VM/image/node" positioning
  • Research dump
  • Additional research

WIP: needs Heath sync and further refinement before the doc can be finalized.

Refs

Closes DI-574 (once verified and reviewed)

🤖 Generated with Claude Code

New customer-facing page covering Orka as the macOS worker layer in a
Bazel Remote Build Execution setup. Covers two paths: open-source
buildfarm (recommended) and BuildBuddy (for teams already using it).
Includes multi-worker deployment, GitHub Actions workflow automation,
LaunchDaemon auto-start pattern, and persistent cache setup.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
macstadiuminc 🟢 Ready View Preview Jun 5, 2026, 8:50 PM

- Expand bare-metal re-imaging explanation (DEP, Xcode, hours not seconds)
- Rename Image versioning to Pinned build environments with Xcode drift framing
- Add isolation bullet explaining cross-project contamination risk
- Tighten worker pool scaling bullet
- Source: competitive research from MPD-81

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@celanthe celanthe self-assigned this Jun 16, 2026
@celanthe celanthe added the documentation Improvements or additions to documentation label Jun 16, 2026
@celanthe celanthe requested a review from jasoncdavis0 June 16, 2026 20:10
Switch server and worker startup from `bazelisk run` (rebuilds from source
on every restart) to pre-built JARs run with `java -jar`, matching the
verified approach in the quickstart. Also replace config.minimal.yml
references with flat YAML configs — the !include-based examples format
does not work at runtime.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant