aws-containers

Deploy and operate containerized workloads on ECS, Fargate, and ECR.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill aws-containers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-containers
Source: https://github.com/mreferre/aws-agent-toolkit-skills/tree/main/.kiro/skills/aws-containers
Command: npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill aws-containers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps you deploy and operate containerized workloads on AWS without getting stuck on ECS/Fargate configuration pitfalls, ECR image management, or ECS Exec debugging.

Core Features & Use Cases

  • ECS service and task deployment guidance: Choose the right ECS mode (Express Mode vs Fargate vs EC2), configure task networking correctly (awsvpc for Fargate), and set deployment safety knobs like circuit breaker with rollback and health check grace periods.
  • ECR repository lifecycle and image reliability: Create repositories, manage lifecycle policies safely (including manifest-list multi-arch gotchas), and troubleshoot image pull failures for private subnets.
  • Operational debugging and troubleshooting: Use ECS Exec to debug running containers, diagnose common failure modes like 502/ALB health checks and OOM (exit code 137), and ensure correct IAM role separation (execution role vs task role) and secrets injection.

Quick Start

Tell the skill: "Help me deploy a simple HTTP container to ECS using ECS Express Mode, and recommend the safest defaults for logging and deployment rollback."

Frequently Asked Questions about aws-containers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a container to AWS Fargate behind a load balancer?

To deploy a container to AWS Fargate, configure an ECS service using awsvpc networking mode, attach it to an Application Load Balancer, and set deployment safety knobs like health check grace periods and circuit breaker rollback to ensure safe traffic routing.

Why does my ECS Fargate task fail to pull an image from ECR in a private subnet?

ECS Fargate image pull failures in private subnets usually stem from missing VPC endpoints for ECR, incorrect execution role permissions for ecr:GetAuthorizationToken, or restrictive security groups blocking Docker registry traffic.

How do I configure blue green deployments for ECS services?

Configure blue green deployments for ECS services by enabling the deployment circuit breaker with rollback, setting proper health check configurations, and using ALB target group swapping to shift traffic only after new tasks pass health checks.

What causes exit code 137 on ECS Fargate tasks and how do I fix it?

Exit code 137 on ECS Fargate indicates an Out of Memory (OOM) error where the container exceeded its allocated memory limit; fix it by increasing the task memory reservation or optimizing the container's memory usage.

How do I manage ECR repository lifecycle policies for multi-arch container images?

Manage ECR lifecycle policies for multi-arch images by targeting untagged manifests carefully, as lifecycle rules can accidentally delete manifest list references; apply tag-based rules to preserve multi-arch build artifacts.