Set up Confluent Cloud Cluster Linking to mirror topics from one Kafka cluster to another, then promote or fail over the mirror topic
domain: confluent-cloud · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Create a cluster link with `confluent kafka link create <link-name> --cluster <destination-cluster-id> --source-cluster <source-cluster-id> --source-bootstrap-server <source-endpoint> --source-api-key <source-api-key>` (or via Cloud Console / REST API / AdminClient)
Create a mirror topic on the destination cluster with `confluent kafka mirror create <topic> --cluster <destination-cluster-id> --link <link-name>`
Verify mirroring status and last fetched offset with `confluent kafka mirror describe <topic> --link <link-name> --cluster <destination-cluster-id>`
Optionally enable ACL sync when creating the link if both clusters are Confluent Cloud clusters in the same organization
For a planned migration run `confluent kafka mirror promote` (extra verification before cutover); for disaster recovery run `confluent kafka mirror failover` (immediate, no verification)
Confirm the topic is now writable and check it still appears in `confluent kafka mirror list` with STOPPED status
Known gotchas
ACL sync only works between two Confluent Cloud clusters in the same organization, not cross-org or between Confluent Platform and Confluent Cloud
Security, schema-validation, tiered-storage, and replica-placement configs never sync automatically from source to mirror topic
Promoted or failed-over topics keep appearing in mirror list/describe output (state STOPPED) as long as the cluster link exists — they don't disappear
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?