Skip to content

[Nexthop] Protect against OOM when building FBOSS in Distro #921

Open
travisb-nexthop wants to merge 5 commits intofacebook:mainfrom
nexthop-ai:raghav.build-stack-part10.2
Open

[Nexthop] Protect against OOM when building FBOSS in Distro #921
travisb-nexthop wants to merge 5 commits intofacebook:mainfrom
nexthop-ai:raghav.build-stack-part10.2

Conversation

@travisb-nexthop
Copy link
Contributor

Pre-submission checklist

  • I've ran the linters locally and fixed lint errors related to the files I modified in this PR. You can install the linters by running pip install -r requirements-dev.txt && pre-commit install
  • pre-commit run

Summary

FBOSS is a beast to build with some forwarding stack compilation units needing 6 or 7 GB and some linking jobs requiring nearly 16G. Prevent running out of memory by limiting job parallelism of the platform stack and forwarding stack builds based on available memory.

Test Plan

Shown to not OOM the build VM in the FBOSS Distro Omnibus PR #847

raghav-nexthop and others added 5 commits February 10, 2026 02:45
Add abstract build component framework for managing build operations.

- Implement AbstractComponent base class for build components
- Add component lifecycle management (prepare, build, extract)
- Integrate with artifact store, download, and execute modules
- Enable extensible component-based build architecture

Tests utilizing the above infrastructure will be added when component build supports are included.
Add build entrypoint orchestration for component-based builds.

- Implement build entrypoint for coordinating component build workflows
- Add support for build configuration and execution management
- Include comprehensive unit tests for entrypoint functionality
Add ImageBuilder class for orchestrating component builds and image assembly.

- ImageBuilder: Main orchestration class for building FBOSS images
- Compression support for build artifacts (zstd)
- Component build coordination
- Test coverage for compression functionality
- Updated build_test.py to use ImageBuilder
Add scripts and build configuration for building FBOSS forwarding and platform stacks.

- CMakeLists.txt:  Defines build targets for forwarding stack
- package.py:   Script for packaging forwarding and platform stacks
- build_fboss_stack.sh:   Script for building forwarding and platform stacks
<!-- Thanks for submitting a pull request! We appreciate you spending
the time to work on these changes. Please provide enough information so
that others can review your pull request. -->

**Pre-submission checklist**
- [X] I've ran the linters locally and fixed lint errors related to the
files I modified in this PR. You can install the linters by running `pip
install -r requirements-dev.txt && pre-commit install`
- [X] `pre-commit run`

<!-- Explain the motivation for making this change and any other context
that you think would help reviewers of your code. What existing problem
does the pull request solve? -->

FBOSS is a beast to build with some forwarding stack compilation units
needing 6 or 7 GB and some linking jobs requiring nearly 16G. Prevent
running out of memory by limiting job parallelism of the platform
stack and forwarding stack builds based on available memory.

<!-- Demonstrate the code is solid. Example: The exact commands you ran
and their output, screenshots / videos if the pull request changes the
user interface. How exactly did you verify that your PR solves the issue
you wanted to solve? -->

<!-- If a relevant Github issue exists for this PR, please make sure you
link that issue to this PR -->

Shown to not OOM the build VM in the FBOSS Distro Omnibus PR
facebook#847
@meta-cla meta-cla bot added the CLA Signed label Feb 10, 2026
@travisb-nexthop travisb-nexthop marked this pull request as ready for review February 11, 2026 01:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants