Construction Kit Repositories
Overview
A Construction Kit Repository is a file-based storage system that centrally provides various Construction Kit libraries for OctoMesh. These repositories serve as the source of truth for data model definitions across your Data Mesh architecture.
Repository Types
File System Repository
Local directory structure containing Construction Kit library definitions. Suitable for development environments or on-premise deployments.
Default paths:
- Windows:
%USERPROFILE%\.octo-ck-models - macOS:
~/octo-ck-models - Linux:
~/.octo-ck-models
Git Repository
GitHub or other Git-based repositories for version-controlled, distributed access to Construction Kit libraries. Enables collaboration and change tracking across teams.
By default, the meshmakers Git repository is configured, available at meshmakers.github.io.
System Libraries
Core Construction Kit libraries are compiled directly into OctoMesh services' source code. These system libraries are automatically available without external repository configuration and provide fundamental data types and patterns required by the platform.
Repository Structure
Construction Kit libraries are stored in validated form within the repository. The validated form contains all types, attributes, records, enums, and associations. This ensures consistency and integrity of data models across the entire Data Mesh infrastructure.
Dependency Resolution
Repositories are used to resolve dependencies between Construction Kit libraries. When a library references types from other libraries, the configured repositories are searched in the following order:
- Embedded System Construction Kits - Built-in libraries compiled into OctoMesh services
- Local File System Repository - User-specific or project-specific libraries
- GitHub Repository - Shared libraries from the configured Git repository
This resolution order ensures that system libraries take precedence, followed by local customizations, and finally community or organization-wide shared libraries.