Skip to content

docs(orchestrator): built-in load balancing across providers#536

Draft
frostebite wants to merge 3 commits intodocument-provider-pluginsfrom
docs/load-balancing-api
Draft

docs(orchestrator): built-in load balancing across providers#536
frostebite wants to merge 3 commits intodocument-provider-pluginsfrom
docs/load-balancing-api

Conversation

@frostebite
Copy link
Member

@frostebite frostebite commented Mar 5, 2026

Summary

Rewrites the load balancing page to document the built-in load balancing API:

  • Runner availability check — route busy runners to cloud providers automatically
  • Retry on alternate provider — retry failed builds on a different provider
  • Provider init timeout — swap providers when startup is too slow
  • Async mode integration — explains how async mode enables non-blocking load balancing
  • Decision table — when to use built-in vs script-based routing
  • Restructures script-based routing as a secondary option for custom logic

Dependencies

Modified files

  • docs/03-github-orchestrator/07-advanced-topics/07-load-balancing.mdx

Documents the new fallbackProviderStrategy, runnerCheckEnabled,
runnerCheckLabels, and runnerCheckMinAvailable inputs. Adds comparison
table for built-in vs manual fallback approaches.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link

coderabbitai bot commented Mar 5, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2f09b201-3b56-4304-98ed-3326f20c911f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/load-balancing-api

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Reframes page around intelligent provider routing with built-in API.
Adds retry-on-alternate, provider init timeout, async mode integration,
and decision table. Restructures manual scripting as secondary option.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@frostebite frostebite changed the title docs(load-balancing): built-in automatic provider fallback docs(orchestrator): built-in load balancing across providers Mar 5, 2026
…ting examples

Add two new script-based routing patterns: dispatching to an alternate
workflow when self-hosted runners are busy, and using reusable workflows
for shared build config with dynamic provider routing. Updated the
comparison table with the new patterns.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link

github-actions bot commented Mar 5, 2026

Visit the preview URL for this PR (updated for commit 265a194):

https://game-ci-5559f--pr536-docs-load-balancing-ktoa4ys9.web.app

(expires Thu, 12 Mar 2026 10:23:47 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: 1f0574f15f83e11bfc148eae8646486a6d0e078b

@github-actions
Copy link

github-actions bot commented Mar 5, 2026

Cat Gif

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant