Repository model

When to use

Use this reference when generating, reviewing or operating a Service Architect project.

Behavior

• Every service with modulePath is publishable as its own repository.
• Every shared module with modulePath is publishable independently.
• The project root becomes an orchestration repository when settings.repoPath is configured.
• The root repository restores external components at moduleVersion through clone.generated.sh instead of owning their source.
• make git-push publishes modules and services before publishing the root workspace.

Repository derivation

settings.name: "Commerce Platform"
settings.repoPath: github.com/acme/commerce-platform
services:
  orderService:
    name: "Order Service"
    modulePath: github.com/acme/order-service
modules:
  contracts:
    name: commerce_contracts
    modulePath: github.com/acme/commerce-contracts

Related documentation