Workspace commands

The root Makefile is a stable user entrypoint that includes generated orchestration and active language backends.

When to use

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

Run these commands from the generated project root.
Generic targets fan out to all services and contract packages selected by the graph.
make.generated.mk is generator-owned; keep custom targets in the user Makefile or separate included files.

Common build, quality and generation targets.

CommandScopeDescription

make / make allWorkspace

Build all generated services. This is the default target.

make initWorkspace

First-time setup: install or verify tools, generate transport artifacts and format sources.

make buildWorkspace

Run every language backend build target selected by the graph.

make testWorkspace

Run tests for all generated services and packages.

make lintWorkspace

Run language linters and type checks.

make lint-fixWorkspace

Apply supported automatic lint and formatting fixes.

make fmtWorkspace

Format all source and schema files owned by the selected language backends.

make genWorkspace

Regenerate protobuf, OpenAPI and transport bindings.

make cleanWorkspace

Remove generated build artifacts without deleting business sources.

make toolsWorkspace

Download or verify pinned code-generation, lint and repository tools.

make ciWorkspace

Run tools, build, test and lint as one local CI pipeline.

make integration-testWorkspace

Run generated cross-service integration scenarios.

make runWorkspace

Alias for starting the complete Docker Compose environment.

make actWorkspace

Execute generated GitHub Actions locally through act.

make grafana-dashboardsWorkspace

Generate dashboards for every service from Jsonnet sources.

make helpWorkspace

Print documented Make targets from all included generated Makefiles.

make init
make build
make test
make lint
make docker-up