ecs-mixed-ami-canary

Validate a mixed-AMI ECS canary lane with separate ASGs, launch templates, and isolated service placement.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/amitkarpe/agent-skills --skill ecs-mixed-ami-canary-amitkarpe
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ecs-mixed-ami-canary
Source: https://github.com/amitkarpe/agent-skills/tree/main/skills/ecs-mixed-ami-canary
Command: npx skills add https://github.com/amitkarpe/agent-skills --skill ecs-mixed-ami-canary-amitkarpe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Rolling out a new AMI or CIS hardening fix across an EC2-backed ECS cluster risks breaking the main workload if the new image is untested. This Skill plans and validates a canary lane inside one ECS cluster so a new AMI can be calibrated on isolated capacity before any wider rollout. ## Core Features & Use Cases - Lane Validation: Confirms the canary ASG joins the same cluster and that the canary node is EC2-healthy, SSM-online, Docker-healthy, and ECS-agent-healthy. - Placement Isolation: Verifies the canary service is pinned to the canary lane via capacity providers and placement constraints so the main service never lands on the new AMI by default. - Evidence Capture: The check-lane.sh script collects cluster, service, container-instance, EC2, AMI, and ASG data into a timestamped evidence directory with rollback notes. - Use Case: Before a production window, run the lane check to confirm stable and canary services are isolated, capture before/after service counts, and freeze rollback steps (stop scheduling, drain tasks, scale canary ASG to zero). ## Quick Start Ask the agent to validate the mixed-AMI canary lane for your ECS cluster by providing the cluster name, AWS profile, region, and the stable and canary service names.

Frequently Asked Questions about ecs-mixed-ami-canary

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

FAQPage Schema
How do I test a new AMI on ECS without affecting production tasks?▼

Create a separate canary ASG and launch template with the new AMI in the same ECS cluster, register it as a distinct capacity provider, and pin a dedicated canary service to that lane with placement constraints. The check-lane.sh script then validates isolation and node health.

How to validate ECS canary node health before rollout?▼

Confirm the canary node is EC2-healthy, SSM-online, Docker-healthy, and ECS-agent-connected, in that order. The skill's script captures container-instance detail, EC2 instance data, and ASG mapping into a timestamped evidence directory for review.

Can stable and canary ECS services share one cluster safely?▼

Yes, if each lane uses separate ASGs, launch templates, and capacity providers with placement constraints keeping the main service off the canary node. A dedicated canary service is preferred over one mixed service until the new AMI is proven.

What is the rollback process for a failed ECS AMI canary?▼

Stop canary scheduling, drain canary tasks, and scale the canary ASG to zero. Because the stable lane was never modified, the main workload continues running on the known-good AMI throughout the rollback.

What dependencies does the ECS lane check script require?▼

The script requires the AWS CLI, jq, and Python 3, plus an AWS profile and region with permissions for ECS, EC2, and Auto Scaling describe calls. All collected evidence is written under a timestamped directory in ~/.AGENTS-temp.