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.

From Ingress NGINX Retirement: Your Kubernetes Migration Guide

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 →