Files
git.stella-ops.org/docs/features/unchecked/releaseorchestrator/docker-compose-deployment-agent.md

2.2 KiB

Docker Compose Deployment Agent

Module

ReleaseOrchestrator

Status

IMPLEMENTED

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