ecs-health-check-debug

Diagnose ECS Fargate CDK rollback failures from missing curl in Docker images.

2|Updated May 10, 2026
One-click install
npx skills add https://github.com/freedomw1987/tree_monstor --skill ecs-health-check-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ecs-health-check-debug
Source: https://github.com/freedomw1987/tree_monstor/tree/main/skills/devops/ecs-health-check-debug
Command: npx skills add https://github.com/freedomw1987/tree_monstor --skill ecs-health-check-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ECS Fargate CDK deployments frequently fail with a ROLLBACK_IN_PROGRESS error when the container health check relies on the curl command, but the Docker image does not include curl installed. This causes health checks to fail repeatedly, containers to restart in a loop, and the ECS service to never stabilize, leading to CDK deployment timeouts and failed releases.

Core Features & Use Cases

  • Root Cause Identification: Clearly pinpoints the missing curl dependency in Docker images as the source of ECS health check stabilization failures.
  • Multiple Remediation Options: Provides three actionable, platform-agnostic solutions: adding curl to the Dockerfile, modifying the health check command to use tools already present in the image, or using ECS exec for manual container verification.
  • Post-Fix Validation: Includes step-by-step AWS CLI commands to confirm curl exists in the running container, check target group health, and review ECS service events to verify the deployment is fully stable.
  • Use Case: Perfect for DevOps engineers deploying Node.js or Bun containerized applications to AWS ECS Fargate via CDK who encounter unexpected deployment rollbacks with no clear root cause.

Quick Start

Use this skill to diagnose and fix ECS Fargate CDK deployment failures caused by missing curl in your Docker image for container health checks.

Frequently Asked Questions about ecs-health-check-debug

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

FAQPage Schema
Why does my ECS Fargate CDK deployment rollback when the health check fails?

ECS Fargate CDK deployments rollback when health checks fail because the Docker image is missing the curl utility, causing containers to restart in a loop and preventing service stabilization.

How do I fix ECS health check curl errors in a Node.js or Bun Docker image?

Fix ECS health check curl errors by adding curl to your Dockerfile, modifying the health check command to use existing image tools, or using ECS exec for manual container verification.

How do I verify an ECS Fargate deployment is stable after fixing a health check?

Verify ECS Fargate deployment stability by running AWS CLI commands to confirm curl exists in the running container, check target group health, and review ECS service events.

Can I use ECS exec to debug health check failures on Fargate containers?

Yes, you can use ECS exec to manually access and verify the running container, checking whether curl is present and diagnosing why health check commands fail.

Does AWS CDK support modifying health check commands for ECS Fargate services?

Yes, AWS CDK supports modifying health check commands for ECS Fargate services, allowing you to replace curl with tools already available in your Docker image.

What are the limitations of using curl for ECS container health checks?

Using curl for ECS container health checks requires the utility to be installed in the Docker image; if it is missing, health checks fail repeatedly, causing deployment timeouts and rollbacks.