# AWS ECS Deployment Agent

## Module
ReleaseOrchestrator

## Status
IMPLEMENTED

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