Skip to content
← 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 this checklist as a PDF — we'll send it to your inbox.

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 →