Back to all scenarios
Scenario #354
Storage
Kubernetes v1.26, in-tree to CSI migration

In-Tree Plugin PVs Lost After Driver Migration

Existing in-tree volumes became unrecognized after enabling CSI migration.

Find this helpful?
What Happened

Migrated GCE volumes to CSI plugin. Old PVs had legacy annotations and didn’t bind correctly.

Diagnosis Steps
  • 1PVs showed Unavailable state.
  • 2Migration feature gates enabled but missing annotations.
Root Cause

Backward incompatibility in migration logic for pre-existing PVs.

Fix/Workaround
• Manually edited PV annotations to match CSI requirements.
Lessons Learned

Migration feature gates must be tested in staging.

How to Avoid
  • 1Run migration with shadow mode first.
  • 2Migrate PVs gradually using tools like pv-migrate.