RBE DOCS

/

Core Runtime

RBE managed system runtimes

LIVE
BRANCH · MAIN
doc/rbe-sys-runtimes.md
SOURCE ↗

RBE-managed language tools are addressed by identity rather than by ambient executable path.

Current/target identities used by package build and REL script execution:

IdentityPurposeDefault script extensions
rbe.sys.nodejsNode.js runtime.js, .mjs, .cjs
rbe.sys.bunjsBun runtime.ts, .mts, .cts
rbe.sys.pythonCPython runtime.py
rbe.sys.pypyPyPy runtimeexplicit Python/JIT selection
rbe.sys.rustRust authoring/compiler toolchainexplicit Rust build/script selection

Managed runtimes live under a versioned, host-specific cache:

text
.cache/rbe/sys/<runtime>/<version>/<host>/

The cache entry must be backed by a registry/runtime manifest that binds at least:

  • runtime identity;
  • version;
  • host triple/platform;
  • HTTPS artifact URL;
  • SHA-256;
  • size limit;
  • archive kind;
  • admitted executable/entrypoint.

RPX/install-runtime owns resolution, download/resume, verification, extraction and promotion. REL and package code do not choose executable paths and do not fall back to PATH.

PyPy

PyPy is first-class but not the implicit replacement for CPython. Long-running pure-Python workloads may benefit from the JIT, while startup-heavy or C-extension-heavy workloads may not. Callers select it explicitly through script.runPyPy(...) or a future runtime option.

Production hydration

A production build may prehydrate required runtimes into its deployment artifact/cache. A trusted runtime path may lazily hydrate a missing runtime when policy allows it. Both paths use the same RPX/install-runtime resolver and verifier so custom registries/mirrors do not create a second security model.

CANONICAL DOCUMENTATION

This page follows the RBE main/doc tree and is refreshed by the Kastrick documentation bridge.

main · 5 min revalidate