Guide to migrate Zone CP from On-Prem Global CP to Konnect

[lobkovilya]

Description

Added a new guide on how to migrate Zone from on-prem Global to Konnect
Fix https://github.com/Kong/kong-mesh/issues/3503
Preview https://deploy-preview-6320--kongdocs.netlify.app/konnect/mesh-manager/migrate-zone/

Testing instructions

Preview link:

Checklist

• Review label added
• PR pointed to correct branch (main for immediate publishing, or a release branch: e.g. release/gateway-3.2, release/deck-1.17)

[netlify]

✅ Deploy Preview for kongdocs ready!

Name	Link
🔨 Latest commit	0bdf4ea
🔍 Latest deploy log	https://app.netlify.com/sites/kongdocs/deploys/65368b446749fd00082b7bef
😎 Deploy Preview	https://deploy-preview-6320--kongdocs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	9 paths audited Performance: 95 (🟢 up 1 from production) Accessibility: 80 (no change from production) Best Practices: 96 (🟢 up 6 from production) SEO: 90 (no change from production) PWA: - View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[cloudjumpercat]

@lobkovilya This is a great doc write up! Thanks for adding this. I made some copyedits and left a comment with some questions I had about one sentence, if you wouldn't mind taking a look at that.

[lahabana]

There's a constant confusion between zones and global which makes this guide hard to follow.
Are we trying to switch zones from an existing on-prem global control-plane to a mink one?
There's nowhere atm where we say update the config of the CP and restart the zone CP for example.

Also it would be hard to add limitations. For example we already discussed that this process would cause cross-zone traffic to break for some time.

[lobkovilya]

There's a constant confusion between zones and global which makes this guide hard to follow.

I fixed a couple of places you pointed out.

Are we trying to switch zones from an existing on-prem global control-plane to a mink one?

Yes

There's nowhere atm where we say update the config of the CP and restart the zone CP for example.

I was thinking Follow the instructions in the {{site.konnect_short_name}} UI to set up Helm and a secret token. should cover that. But you're right, it's better to mention config update and CP restart explicitly.

Also it would be hard to add limitations. For example we already discussed that this process would cause cross-zone traffic to break for some time.

Why it would be hard? I can probably add the section at the bottom of the page no?

[lahabana]

Why it would be hard? I can probably add the section at the bottom of the page no?
Sorry typo I meant "add" :) I think it should towards the top of the page and we probably want 2 diagrams one before and one after the migration to make it clear what this does

[cloudjumpercat]

@lahabana @lobkovilya If you could add info about the CP config update, restarting the zone, a section about limitations, and attach 2 diagram mockups (pre and post migration), I can revise the text and add our branding to the diagrams.

[lobkovilya]

I'm not sure if these diagrams are actually useful. Maybe I should add anything else to them.

[lahabana]

LGTM great addition!

[cloudjumpercat]

LGTM! Thanks for creating this great guide, @lobkovilya !

[lobkovilya]

Thanks a lot for helping with it, @cloudjumpercat!