Owner: Engineering Team | Last Updated: 2026-01-30 | Status: Current
Troubleshooting deployment and CI/CD issues.
| Issue | Cause | Solution |
|---|---|---|
| ECS task won't start | Health check failing | Check CloudWatch logs, verify port 3001 |
| Docker build timeout | Slow dependency download | Increase CI timeout, check network |
| ECR push denied | IAM permissions | Check OIDC role has ecr:PutImage |
| GitHub Actions failed | Workflow error | Check Actions logs, fix YAML |
| Env vars missing in ECS | Task definition outdated | Update task definition with new vars |
| Container OOM killed | Insufficient memory | Increase memory in task definition (current: 3500MB) |
| Deployment stuck | ECS service update | Check ECS events tab, force new deployment |
Log path: /ecs/{cluster}/{service}
Useful filters:
ERROR — Application errorsWARN — WarningsOOMKilled — Memory issuesHealthCheck — Health check failures| CI/CD Pipelines | Deployment pipeline config |
| Web App Deployment | Web app deploy process |
| Docker Configuration | Docker deployment config |
| Date | Author | Change |
|---|---|---|
| 2026-01-30 | Admin | Initial creation |
Prev: Environment Issues | Next: Performance Issues | Up: General