SAService ArchitectDocumentation

/

Code GenerationDocker and local infrastructure

Code generation RUNTIME_IMAGE=0 | 1

Development and runtime images

Generated multi-stage images separate fast local development from minimal production-style execution.

When to use

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

Behavior

The default local layout may mount sources, expose debugger ports and retain build tooling.
RUNTIME_IMAGE=1 selects final stages containing service binaries/runtime dependencies and configuration only.
Benchmark and profiling targets select runtime images automatically.
C++ reuses locked BuildKit dependency and ccache volumes; TypeScript reuses pnpm caches; Go local debug images use Delve; TypeScript debug images use the Node inspector.

Runtime and debug commands

make docker-up RUNTIME_IMAGE=1
make debug-<service-name>      # language-specific debugger
make cpp-release-up            # optimized C++ runtime
make profile                   # TypeScript framework/native profiles