How truenas/core-build works
Main Components (Top Level)
a) Build System Core
• Represented by a large container showing the main build process
b) Input Sources
• On the left side
• Include:
• Git repositories
• Configuration templates
• Build profiles
c) Output Artifacts
• On the right side
• Include:
• ISO files
• Update files
• Log files
Build System Components (Detail Level)
a) Build Tools Layer
• Tools from build/tools/
• Include:
• build-os.py
• build-packages.py
• create-iso.py
• create-upgrade-distribution.py
b) Profile Management
• Profiles system (build/profiles/)
• FreeNAS profile structure
c) Customization Layer
• Build/customize/ scripts
• Connection to main build process
Testing Framework
• At the bottom
• Connection to:
• FreeBSD tests
• TrueOS tests
• Validation flow
Key Relationships
a) Build Flow:
• Git checkout → Source preparation
• Profile selection → Build configuration
• Package building → OS assembly
• OS assembly → ISO creation
b) Dependencies:
• Connection to FreeBSD base
• Package dependencies
• Build tool relationships
Important Elements
a) Environment Requirements:
• FreeBSD 13.x requirement
• Hardware requirements
b) Build Artifacts Storage:
• _BE directory structure
• Release artifacts organization