How mabuwasel/ecs-session works
Main Components
a. Client-Side Components:
• ECS Session CLI Tool (Main Application)
• AWS CLI (Dependency)
• Session Manager Plugin (Dependency)
b. AWS-Side Components:
• AWS IAM (Authentication/Authorization)
• AWS ECS Service
• AWS ECS Tasks/Containers
• AWS Systems Manager (SSM)
Flow Representation
a. Initial authentication flow:
• CLI Tool → AWS IAM (credentials verification)
b. Resource discovery flow:
• CLI Tool → ECS (list clusters)
• CLI Tool → ECS (list services)
• CLI Tool → ECS (list tasks)
c. Session establishment flow:
• CLI Tool → Systems Manager → ECS Container (execute-command)
Important Elements to Highlight
• Green: Local components
• Blue: AWS services
• Yellow: Security components (IAM)
• Rectangles: Main components
• Hexagons: AWS services
Additional Details
Annotations showing:
• Required IAM permissions (reference iam-policy.json)
• Supported regions
• Execute-command feature requirement
Technical Specifications
A small technical requirements section showing:
• Go runtime dependency
• AWS CLI version requirement
• Session Manager Plugin requirement
Key Considerations:
• Keep the focus on the interaction flow between local tools and AWS services
• Authentication and authorization checkpoints
• Execute-command feature as a critical component
• Error handling paths (e.g., when execute-command is not enabled)