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

2.4 KiB

AWS ECS Deployment Agent

Module

ReleaseOrchestrator

Status

VERIFIED

Description

ECS agent capability for AWS Elastic Container Service deployments: service create/update/delete, task execution, task definition registration, service scaling, deployment health monitoring, and CloudWatch log streaming. Supports Fargate and EC2 launch types.

Implementation Details

  • Modules: src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/
  • Key Classes:
    • EcsCapability (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/EcsCapability.cs) - IAgentCapability implementation for ECS deployments
    • EcsDeployServiceTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/Tasks/EcsDeployServiceTask.cs) - deploys/updates ECS services
    • EcsRegisterTaskDefinitionTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/Tasks/EcsRegisterTaskDefinitionTask.cs) - registers ECS task definitions
    • EcsScaleServiceTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/Tasks/EcsScaleServiceTask.cs) - scales ECS services
    • EcsHealthCheckTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/Tasks/EcsHealthCheckTask.cs) - deployment health monitoring
    • EcsRunTaskTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/Tasks/EcsRunTaskTask.cs) - runs one-off ECS tasks
    • EcsStopTaskTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/Tasks/EcsStopTaskTask.cs) - stops ECS tasks
    • EcsDescribeServiceTask (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/Tasks/EcsDescribeServiceTask.cs) - describes ECS service status
    • CloudWatchLogStreamer (src/ReleaseOrchestrator/__Agents/StellaOps.Agent.Ecs/CloudWatchLogStreamer.cs) - streams CloudWatch logs to orchestrator
  • Interfaces: IEcsTask, IAgentCapability
  • Source: SPRINT_20260110_108_006_AGENTS_ecs.md

E2E Test Plan

  • Register an ECS task definition via EcsRegisterTaskDefinitionTask and verify it is created in AWS
  • Deploy an ECS service via EcsDeployServiceTask and verify the service is running
  • Scale the service via EcsScaleServiceTask and verify desired count changes
  • Verify health check: EcsHealthCheckTask reports service health status
  • Verify CloudWatch log streaming: deployment logs are streamed to the orchestrator

Verification

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