Code GenerationDocker and local infrastructure

Code generation docker-compose*.yml

Run Generated Microservices with Docker Compose

Compose files materialize the complete local topology and specialized build, integration, cache and Kubernetes profiles.

When to use

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

Behavior

docker-compose.yml runs generated services plus only the infrastructure required by the graph.
The canonical graph includes Redpanda, Temporal Server with PostgreSQL and UI, Prometheus and Grafana.
Specialized generated Compose files isolate language runtime images, CMake builds, integration tests, dependency cache and local Kubernetes tooling.
Service ports, connector addresses, health checks, volumes and generated configuration are wired consistently with the graph.

Compose files

Generated Compose entrypoints and their responsibilities.

FilePurposeDescription

docker-compose.ymlCanonical runtime

Services, Redpanda, Temporal, Prometheus and Grafana.

docker-compose.dependency-cache.generated.ymlDependency cache

Nexus package proxy and Git mirror.

docker-compose.kubernetes.ymlLocal Kubernetes

OCI registry, k3s container and Helm client.

docker-compose.cmake.generated.ymlC++ build/runtime

CMake builder and per-service runtime containers.

docker-compose.cpp-runtime.generated.ymlC++ minimal runtime

Production-style C++ service images.

docker-compose.integration.generated.ymlC++ integration

Services and Redpanda for generated integration checks.

docker-compose.python-runtime.generated.ymlPython runtime

Minimal Python service images.

docker-compose.typescript-runtime.generated.ymlTypeScript runtime

Minimal TypeScript service images.

<service>/docker-compose*.generated.ymlStandalone service

Build and run one extracted service repository.

Docker commands

Workspace container lifecycle.

CommandScopeDescription

make docker-buildWorkspace

Build all service images using the language-specific image targets.

make docker-build-localWorkspace

Compatibility alias for docker-build; use the language debug target or docker-build-dev for source-oriented images.

make docker-build-devWorkspace

Build generated development images for languages that provide source-mounted debugging.

make docker-upWorkspace

Build images and dashboards, then start the canonical Compose topology in detached mode.

make docker-up-devWorkspace

Start the generated development-image topology.

make docker-startWorkspace

Start previously created Compose containers without rebuilding them.

make docker-downWorkspace

Stop the Compose environment while retaining persistent volumes.

make docker-restartWorkspace

Stop and recreate the complete Compose environment.

make docker-cleanWorkspace

Stop containers and remove project volumes and orphan containers. Persistent local data is lost.

make docker-up RUNTIME_IMAGE=1Workspace

Select minimal final runtime stages without source trees, debuggers or build tools.

Local environment

make docker-up
docker compose ps
make docker-restart
make docker-down
# destructive cleanup
make docker-clean