kcp migration

kcp migration

Commands for migrating using CPC Gateway.

Synopsis

Execute end-to-end Kafka migrations to Confluent Cloud using the Confluent Platform Connect (CPC) Gateway.

The migration workflow follows a defined lifecycle managed by a finite state machine:

1. Initialize — validate cluster link and gateway CRs, persist migration config (kcp migration init).
2. Check Lags — compare source and destination offsets until lag drops below the configured threshold.
3. Fence Gateway — apply the fenced gateway CR to block traffic during cutover.
4. Promote Topics — promote mirror topics at zero lag.
5. Switch Gateway — apply the switchover gateway CR to route traffic to Confluent Cloud.

If execution is interrupted at any step, re-running kcp migration execute resumes from the last completed step.

Supporting documentation:

• Gateway Switchover Examples — Gateway CR YAML templates for each supported authentication combination.
• Getting Started with Zero-Cut Migrations — end-to-end reference for the KCP + Gateway approach, including networking and auth pre-requisites.

Options

  -h, --help   help for migration

Options inherited from parent commands

      --verbose   Enable verbose logging to console

SEE ALSO

• kcp - A CLI tool for kafka cluster planning and migration
• kcp migration execute - Execute an initialized migration
• kcp migration init - Initialize a new migration
• kcp migration lag-check - Show mirror topic lag for the cluster link
• kcp migration list - List all migrations from the migration state file