fix(ecs): enabling the circuitBreaker is not recommended loudly enough

[rix0rrr]

If a simple misconfiguration in an ECS Task Definition causes the task to never start, a Service based off of that Task Definition takes 3 hours to fail unless circuitBreaker is configured.

This is not obvious: our examples don't show that and the construct itself never tells you about it.

Update our top-level README example to include the circuit breaker field, and make the construct warn you if you didn't configure the property (you most likely always want it). Also remove desiredCapacity from the initial example, which is not recommended anymore because setting that unscales your service during deployments (it even warns).

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[github-actions]

⚠️ This pull request description does not follow the correct template structure.

PRs without a linked issue will receive lower priority for review and merging. Please update the description to follow the PR template and include a line like Closes #123 in the Issue section. If no existing issue matches your change, create one first.

[aws-cdk-automation]

(This review is outdated)

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-05-06 09:14 UTC · Rule: default-squash
• ✅ Checks passed · in-place
• ✅ Merged — 2026-05-06 10:54 UTC · at 18de8e741dbcdd4cabea91849709debe4289da6f · squash

This pull request spent 1 hour 39 minutes 37 seconds in the queue, including 31 minutes 56 seconds running CI.

Required conditions to merge

• #approved-reviews-by >= 1 [🛡 GitHub branch protection]
  • fix(ecs): enabling the circuitBreaker is not recommended loudly enough #37755
• #changes-requested-reviews-by = 0 [🛡 GitHub branch protection]
  • fix(ecs): enabling the circuitBreaker is not recommended loudly enough #37755
• any of [🛡 GitHub branch protection]:
  • check-success = validate-pr
  • check-neutral = validate-pr
  • check-skipped = validate-pr
• any of [🛡 GitHub branch protection]:
  • check-success = build
  • check-neutral = build
  • check-skipped = build

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

[github-actions]

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.