docker

Start Full Stack

```bash

# Start all services with infrastructure

docker-compose up -d

# View logs for specific service

docker-compose logs -f blueprint-service

# Rebuild single service after code changes

docker-compose build blueprint-service && docker-compose up -d --force-recreate blueprint-service

```

Infrastructure Only (for Aspire development)

```bash

# Start databases without application services

docker-compose -f docker-compose.infrastructure.yml up -d

```

| Concept | Usage | Example |

|---------|-------|---------|

| Chiseled images | Distroless for security | mcr.microsoft.com/dotnet/aspnet:10.0-noble-chiseled |

| Multi-stage builds | Separate build/runtime | FROM sdk AS build → FROM aspnet AS final |

| YAML anchors | Shared env config | <<: [otel-env, jwt-env] |

| Health checks | Startup dependencies | condition: service_healthy |

| Bridge network | Service DNS | http://wallet-service:8080 |

Service Definition with Dependencies

When: Adding a new microservice

```yaml

my-service:

build:

context: .

dockerfile: src/Services/Sorcha.MyService/Dockerfile

image: sorcha/my-service:latest

container_name: sorcha-my-service

restart: unless-stopped

environment:

<<: [otel-env, jwt-env]

OTEL_SERVICE_NAME: my-service

ASPNETCORE_ENVIRONMENT: Development

ASPNETCORE_URLS: http://+:8080

ConnectionStrings__Redis: redis:6379

volumes:

- dataprotection-keys:/home/app/.aspnet/DataProtection-Keys

depends_on:

redis:

condition: service_healthy

networks:

- sorcha-network

```

Multi-Stage Dockerfile

When: Creating Dockerfile for .NET service

```dockerfile

FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build

WORKDIR /src

COPY ["src/Services/Sorcha.MyService/Sorcha.MyService.csproj", "src/Services/Sorcha.MyService/"]

RUN dotnet restore "src/Services/Sorcha.MyService/Sorcha.MyService.csproj"

COPY src/ ./src/

RUN dotnet publish "src/Services/Sorcha.MyService/Sorcha.MyService.csproj" -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:10.0-noble-chiseled AS final

WORKDIR /app

COPY --from=publish /app/publish .

USER $APP_UID

ENTRYPOINT ["dotnet", "Sorcha.MyService.dll"]

```

• [docker](references/docker.md) - Container patterns and anti-patterns
• [ci-cd](references/ci-cd.md) - GitHub Actions workflows
• [deployment](references/deployment.md) - Production deployment
• [monitoring](references/monitoring.md) - OpenTelemetry and Aspire Dashboard

• See the aspire skill for .NET Aspire orchestration patterns
• See the postgresql skill for database container configuration
• See the mongodb skill for document database setup
• See the redis skill for caching container patterns
• See the yarp skill for API Gateway routing configuration

> Fetch latest Docker documentation with Context7.

How to use Context7:

1. Use mcp__context7__resolve-library-id to search for "docker"
2. Prefer website documentation (IDs starting with /websites/) over source code repositories
3. Query with mcp__context7__query-docs using the resolved library ID

Library ID: /websites/docker _(resolve using mcp__context7__resolve-library-id, prefer /websites/ when available)_

Recommended Queries:

• "docker compose health checks"
• "multi-stage build best practices"
• "docker networking bridge mode"