managing-deployment-rollbacks
Tools and procedures for deploying applications and executing automated rollbacks.
Install
mkdir -p .claude/skills/managing-deployment-rollbacks && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/6628" && unzip -o skill.zip -d .claude/skills/managing-deployment-rollbacks && rm skill.zipInstalls to .claude/skills/managing-deployment-rollbacks
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Deploy use when you need to work with deployment and CI/CD.Key capabilities
- →Automated rollback for Kubernetes, ECS, and Lambda
- →Post-deployment health monitoring
- →Database migration rollback procedures
- →Post-incident reporting
- →Automated rollback policy configuration
How it works
The skill monitors post-deployment health metrics and triggers automated or manual reverts to previous versions using platform-specific commands like kubectl rollout undo.
Inputs & outputs
When to use managing-deployment-rollbacks
- →Executing deployment rollbacks
- →Automating CI/CD pipelines
- →Monitoring post-deployment health
- →Managing infrastructure updates
About this skill
Managing Deployment Rollbacks
Overview
Implement and execute deployment rollback procedures for Kubernetes, ECS, Lambda, and cloud VM deployments. Detect failed deployments via health checks and error rate monitoring, then automatically or manually revert to the last known good version with minimal downtime and data integrity preservation.
Prerequisites
kubectlconfigured with cluster access and permission to manage deployments- Deployment history retained (Kubernetes
revisionHistoryLimit, ECS task definition versions) - Monitoring system tracking error rate, latency, and health check status (Prometheus, Datadog, CloudWatch)
- Previous deployment artifacts (container images, task definitions) still available in the registry
- Database migration strategy that supports backward compatibility (expand-contract pattern)
Instructions
- Detect deployment failure: monitor error rate, P99 latency, pod restart count, and health check responses for 5-10 minutes post-deploy
- Assess rollback scope: determine if the issue is application code, configuration, or infrastructure
- For Kubernetes: execute
kubectl rollout undo deployment/<name>to revert to the previous revision - For ECS: update the service to use the previous task definition revision
- For Lambda: point the alias back to the previous function version
- Verify database compatibility: ensure the previous application version works with the current database schema (no forward-only migrations were applied)
- Confirm rollback success: verify health checks pass, error rate returns to baseline, and user-facing functionality is restored
- Generate a post-incident report: document what failed, when rollback was triggered, time to recovery, and root cause
- Create automated rollback rules: configure Kubernetes readiness probes, Argo Rollouts analysis, or CloudWatch alarms to trigger rollback without manual intervention
Output
- Rollback scripts for each deployment target (Kubernetes, ECS, Lambda)
- Automated rollback configuration (Kubernetes probes, Argo Rollouts AnalysisTemplate)
- Post-incident report template with timeline and root cause sections
- Monitoring dashboard with rollback trigger indicators
- Database migration rollback procedures (down migrations, backward-compatible schemas)
Error Handling
| Error | Cause | Solution |
|---|---|---|
no rollout history found | Revision history limit set to 0 or deployment was created fresh | Increase revisionHistoryLimit in deployment spec; manually specify the target image tag |
Rollback succeeded but errors persist | Issue is in configuration or external dependency, not application code | Check ConfigMaps, Secrets, and external service health; rollback configuration changes separately |
Database schema incompatible after rollback | Forward-only migration applied during failed deployment | Apply a down migration or use expand-contract pattern; never deploy breaking schema changes alongside code |
Old image no longer in registry | Lifecycle policy deleted the previous image | Restore from backup or rebuild from the git tag; extend image retention for production tags |
Rollback causes service disruption | Insufficient replicas during rollback transition | Set maxUnavailable: 0 in rolling update strategy to ensure zero-downtime rollback |
Examples
- "Roll back the production Kubernetes deployment to the previous revision after detecting a spike in 5xx errors."
- "Create an automated rollback policy using Argo Rollouts that reverts if error rate exceeds 1% during the first 10 minutes after deploy."
- "Generate a rollback runbook for an ECS service that includes steps to revert task definition, validate health, and notify the team via Slack."
Resources
- Kubernetes rollout management: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#rolling-back-a-deployment
- Argo Rollouts analysis: https://argoproj.github.io/argo-rollouts/features/analysis/
- AWS ECS rolling updates: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html
- Database migration patterns: https://martinfowler.com/articles/evodb.html
Prerequisites
Limitations
- →Requires backward-compatible database migration strategies
- →Depends on image retention policies in the container registry
How it compares
It provides a structured rollback runbook and automated policy templates instead of manual troubleshooting and redeployment.
Compared to similar skills
managing-deployment-rollbacks side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| managing-deployment-rollbacks (this skill) | 1 | 27d | Review | Advanced |
| deployment-pipeline-design | 6 | 2mo | Review | Advanced |
| cloudflare-deploy | 3 | 6mo | Review | Intermediate |
| deployment-engineer | 4 | 4mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by jeremylongshore
View all by jeremylongshore →You might also like
deployment-pipeline-design
wshobson
Design multi-stage CI/CD pipelines with approval gates, security checks, and deployment orchestration. Use when architecting deployment workflows, setting up continuous delivery, or implementing GitOps practices.
cloudflare-deploy
davila7
Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.
deployment-engineer
sickn33
Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.
DevOps / CI-CD Engineer
dr-pabs
Automate build, validation, deployment, and release operations for the project.
deployment-patterns
DekaPrayoga
Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications.
cicd-pipelines
peterbamuhigire
Use when designing or implementing a CI/CD pipeline — stage gates, GitHub Actions production patterns (matrix, reusable workflows, environments), OIDC federation to AWS/GCP/Vault, dependency and Docker-layer caching, fan-out/fan-in orchestration, blue/green and canary deployment, pipeline observabil