Skip to content

Commit 5f69a91

Browse files
rubennortemeta-codesync[bot]
authored andcommitted
Document FANTOM_FORCE_CI_MODE for full local runs (#56531)
Summary: Pull Request resolved: #56531 Add a section to the Fantom `__docs__/README.md` that recommends running the full suite locally with `FANTOM_FORCE_CI_MODE=1`. In CI mode, `globalSetup` pre-builds the entire `(hermesVariant × enableOptimized)` binary matrix once up-front and per-test buck2 invocations are skipped, which eliminates buck2 daemon contention from the worker pool — a common source of sporadic build failures when many workers race to build different binary variants at the same time. CI environments (`SANDCASTLE`, `GITHUB_ACTIONS`) already auto-detect this mode; this just documents it for local use. Changelog: [Internal] Reviewed By: andrewdacenko Differential Revision: D101795648 fbshipit-source-id: 984bc8bfd034347b5aee0ff438b037e5eb9d41a8
1 parent c1ffe9f commit 5f69a91

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

  • private/react-native-fantom/__docs__

private/react-native-fantom/__docs__/README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -303,6 +303,24 @@ memory heap and print a message indicating where it was saved. E.g.:
303303
You can have multiple calls to `Fantom.takeJSMemoryHeapSnapshot()` in your test,
304304
and each one will create a different file.
305305

306+
### Running the full suite locally
307+
308+
When running the entire suite locally, set `FANTOM_FORCE_CI_MODE=1`:
309+
310+
```shell
311+
FANTOM_FORCE_CI_MODE=1 yarn fantom
312+
```
313+
314+
In CI mode, `globalSetup` pre-builds the entire
315+
`(hermesVariant × enableOptimized)` binary matrix once up-front (see
316+
[`global-setup/build.js`](../runner/global-setup/build.js)) and per-test buck2
317+
invocations are skipped. This eliminates buck2 daemon contention from the worker
318+
pool, which can otherwise cause sporadic build failures when many workers race
319+
to build different binary variants at the same time.
320+
321+
CI environments (`SANDCASTLE`, `GITHUB_ACTIONS`) auto-detect this mode — see
322+
[`runner/EnvironmentOptions.js`](../runner/EnvironmentOptions.js).
323+
306324
### FAQ
307325

308326
#### How is this different from Jest tests?

0 commit comments

Comments
 (0)