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.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

Build development images with source/debug support where the language provides it.

make docker-upWorkspace

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

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