2026-03-20 12:08:25 -07:00
|
|
|
# `rusty_v8` Consumer Artifacts
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
This directory wires the `v8` crate to exact-version Bazel inputs.
|
|
|
|
|
Bazel consumer builds use:
|
|
|
|
|
|
|
|
|
|
- upstream `denoland/rusty_v8` release archives on Windows
|
|
|
|
|
- source-built V8 archives on Darwin, GNU Linux, and musl Linux
|
|
|
|
|
- `openai/codex` release assets for published musl release pairs
|
|
|
|
|
|
|
|
|
|
Cargo builds still use prebuilt `rusty_v8` archives by default. Only Bazel
|
|
|
|
|
overrides `RUSTY_V8_ARCHIVE`/`RUSTY_V8_SRC_BINDING_PATH` in `MODULE.bazel` to
|
|
|
|
|
select source-built local archives for its consumer builds.
|
2026-03-19 18:05:23 -07:00
|
|
|
|
|
|
|
|
Current pinned versions:
|
|
|
|
|
|
|
|
|
|
- Rust crate: `v8 = =146.4.0`
|
2026-03-20 12:08:25 -07:00
|
|
|
- Embedded upstream V8 source for musl release builds: `14.6.202.9`
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
The consumer-facing selectors are:
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
- `//third_party/v8:rusty_v8_archive_for_target`
|
|
|
|
|
- `//third_party/v8:rusty_v8_binding_for_target`
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
Musl release assets are expected at the tag:
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
- `rusty-v8-v<crate_version>`
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
with these raw asset names:
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
- `librusty_v8_release_<target>.a.gz`
|
|
|
|
|
- `src_binding_release_<target>.rs`
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
The dedicated publishing workflow is `.github/workflows/rusty-v8-release.yml`.
|
|
|
|
|
It builds musl release pairs from source and keeps the release artifacts as the
|
|
|
|
|
statically linked form:
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
- `//third_party/v8:rusty_v8_release_pair_x86_64_unknown_linux_musl`
|
|
|
|
|
- `//third_party/v8:rusty_v8_release_pair_aarch64_unknown_linux_musl`
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
Cargo musl builds use `RUSTY_V8_ARCHIVE` plus a downloaded
|
|
|
|
|
`RUSTY_V8_SRC_BINDING_PATH` to point at those `openai/codex` release assets
|
|
|
|
|
directly. We do not use `RUSTY_V8_MIRROR` for musl because the upstream `v8`
|
|
|
|
|
crate hardcodes a `v<crate_version>` tag layout, while our musl artifacts are
|
|
|
|
|
published under `rusty-v8-v<crate_version>`.
|
2026-03-19 18:05:23 -07:00
|
|
|
|
2026-03-20 12:08:25 -07:00
|
|
|
Do not mix artifacts across crate versions. The archive and binding must match
|
|
|
|
|
the exact resolved `v8` crate version in `codex-rs/Cargo.lock`.
|