← Back to article
Cluster Migration Inventory Worksheet
Free worksheet from our Ingress NGINX migration guide
Capture every ingress class, hostname, annotation, TLS dependency, and rollback owner in one place before migrating from Ingress NGINX.
Get your free checklist
Enter your email to unlock this resource instantly.
Instructions
Complete one worksheet per cluster. Document every ingress resource before starting migration. This inventory prevents surprises during cutover and gives rollback owners clear accountability.
1. Cluster Information
Cluster name:
Environment:
K8s version:
Current ingress controller:
Target replacement:
Migration owner:
2. Ingress Resource Inventory
List every Ingress resource in the cluster.
| Namespace | Ingress Name | Ingress Class | Hostname(s) | Backend Service | Owner |
|---|---|---|---|---|---|
3. Annotation and Custom Config Audit
Identify every nginx-specific annotation and custom snippet in use.
- Rewrite rules (nginx.ingress.kubernetes.io/rewrite-target)
- Custom headers (configuration-snippet, server-snippet)
- Rate limiting annotations
- CORS configuration
- Proxy buffer size and timeout overrides
- Authentication annotations (auth-url, auth-signin)
- Canary and traffic-splitting annotations
- Custom error page configurations
4. TLS and Certificate Dependencies
| Hostname | TLS Secret Name | Cert Source (cert-manager, manual, wildcard) | Expiry Date | Notes |
|---|---|---|---|---|
5. Redirect and Rewrite Map
| Source Path | Target Path | Type (301/302/rewrite) | Ingress Resource | Notes |
|---|---|---|---|---|
6. Migration Checklist
- All ingress resources documented in this worksheet
- Annotation equivalents identified for target controller
- Gateway API resources written for each ingress
- TLS certificates validated for new controller compatibility
- DNS cutover plan documented with TTL considerations
- Rollback procedure tested and documented
- Load testing completed on new controller
- Monitoring and alerting updated for new controller
- Team communication sent with migration timeline
7. Rollback Plan
Rollback owner:
Rollback trigger:
Rollback steps:
Max rollback time:
Found this useful? Read the full article:
Read: Ingress NGINX Retirement: Your Kubernetes Migration Guide →