mirror of
https://github.com/apple/container.git
synced 2026-07-14 13:37:02 +00:00
Kathryn Baldauf
16f2630126
We're working on making a pure swift container image build system that leverages containerization. This PR represents our initial design and initial work towards this goal. The native builder is still in active development and most of the implementation has not been started or completed. We will be opening a series of issues that represent various (but not necessarily all) pieces of work that need to be done here. There are docs included in this PR that describe the overall design of each component and outline some of our goals. The easiest way to view the docs by themselves (since this is a massive PR) is to look at the docs commit in the `Commits` tab. We'd love any feedback! @wlan0 --------- Signed-off-by: Kathryn Baldauf <k_baldauf@apple.com>
Swift Native Builder Documentation
Welcome to the Swift Native Builder documentation. These docs contain detailed information about the project's architecture and design decisions.
Documentation Structure
Core Documentation
- Design.md - Complete architectural design and implementation details
- High-level architecture overview
- Component descriptions (Parser, Scheduler, Executor, CAS)
- Security model and extensibility
Component Documentation
-
ContainerBuildIR - Intermediate Representation documentation
- Core types and operations
- Build graph structure
- Validation and analysis tools
-
ContainerBuildExecutor - Execution layer documentation
- Executor architecture and patterns
-
ContainerBuildCache - Caching layer documentation
- ContentStore-based cache architecture
- OCI-compliant cache entry format
- Eviction policies and index management
Quick Links
- Project README - Getting started and overview
- Examples - Sample code and usage patterns
Contributing
When adding new documentation:
- Place architectural documents in this docs folder
- Component-specific documentation goes under
docs/<component-name>/ - Update this README with links to new documents