Files
git.stella-ops.org/docs/features/checked/releaseorchestrator/docker-compose-deployment-agent.md
2026-02-14 09:11:48 +02:00

2.3 KiB

Docker Compose Deployment Agent

Module

ReleaseOrchestrator

Status

VERIFIED

Description

Compose agent capability for docker-compose stack management: pull, up, down, scale, health-check operations. Includes compose file management with digest-locked image references.

Implementation Details

  • Modules: src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/
  • Key Classes:
    • ComposeCapability (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/ComposeCapability.cs) - IAgentCapability implementation for Compose stack management
    • ComposeExecutor (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/ComposeExecutor.cs) - executes docker-compose commands
    • ComposeFileManager (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/ComposeFileManager.cs) - manages compose files with digest-locked references
    • ComposePullTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/Tasks/ComposePullTask.cs) - pulls images for compose stack
    • ComposeUpTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/Tasks/ComposeUpTask.cs) - brings up compose stack
    • ComposeDownTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/Tasks/ComposeDownTask.cs) - tears down compose stack
    • ComposeScaleTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/Tasks/ComposeScaleTask.cs) - scales compose services
    • ComposeHealthCheckTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/Tasks/ComposeHealthCheckTask.cs) - health check for compose services
    • ComposePsTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Compose/Tasks/ComposePsTask.cs) - lists compose service status
  • Interfaces: IComposeTask, IAgentCapability
  • Source: SPRINT_20260110_108_003_AGENTS_compose.md

E2E Test Plan

  • Pull images via ComposePullTask and verify all images are pulled
  • Bring up a compose stack via ComposeUpTask and verify all services are running
  • Scale a service via ComposeScaleTask and verify the desired replica count
  • Health check via ComposeHealthCheckTask and verify service health status
  • Tear down via ComposeDownTask and verify all services are stopped

Verification

  • Verified: 2026-02-13T21:00:00Z
  • Method: Tier 2d integration tests
  • Result: PASS