2026-01-14 04:56:20 +00:00
|
|
|
# Distribution Package Generation
|
|
|
|
|
|
|
|
|
|
**Purpose**: Generate complete distribution packages from compiled binaries and libraries.
|
|
|
|
|
|
|
|
|
|
## Contents
|
|
|
|
|
|
|
|
|
|
Scripts and outputs for creating distribution-ready packages across multiple platforms and formats.
|
|
|
|
|
|
|
|
|
|
## What is Distribution Generation
|
|
|
|
|
|
|
|
|
|
Distribution generation takes the compiled artifacts from `dist/` and packages them into:
|
|
|
|
|
|
|
|
|
|
- Installable archives (tar.gz, zip)
|
|
|
|
|
- Platform-specific installers (deb, rpm, brew)
|
|
|
|
|
- Docker/container images
|
|
|
|
|
- Binary distributions with configuration templates
|
|
|
|
|
|
|
|
|
|
## Build Process
|
|
|
|
|
|
|
|
|
|
The distribution build system:
|
|
|
|
|
|
|
|
|
|
1. Takes binaries from `dist/platform/`
|
|
|
|
|
2. Takes libraries from `dist/core/`
|
|
|
|
|
3. Takes configuration templates from `dist/config/`
|
|
|
|
|
4. Combines with installation scripts
|
|
|
|
|
5. Creates platform-specific packages
|
|
|
|
|
|
|
|
|
|
Generate a distribution:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
just dist-generate # Full distribution generation
|
|
|
|
|
just dist-validate # Validate generated distribution
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Output Artifacts
|
|
|
|
|
|
|
|
|
|
Generated distribution includes:
|
|
|
|
|
|
|
|
|
|
- Compiled binaries (orchestrator, control-center, MCP server)
|
|
|
|
|
- Installation script (install.sh)
|
|
|
|
|
- Configuration templates
|
|
|
|
|
- Documentation
|
|
|
|
|
- License files
|
|
|
|
|
|
|
|
|
|
## Related Directories
|
|
|
|
|
|
|
|
|
|
- `dist/` - Build output (source for distribution)
|
|
|
|
|
- `package/` - Alternative packaging (low-level format creation)
|
|
|
|
|
- `release/` - Version management and release tagging
|
|
|
|
|
|
|
|
|
|
## Integration
|
|
|
|
|
|
|
|
|
|
The distribution output is used by:
|
|
|
|
|
|
|
|
|
|
- Installation system (`provisioning-installer`)
|
|
|
|
|
- Package managers
|
|
|
|
|
- CI/CD pipelines
|
|
|
|
|
- End-user downloads
|
