Add MCPRegistry to Helm migration guide#927
Open
ChrisJBurns wants to merge 1 commit into
Open
Conversation
Add a migration guide for moving operator-managed MCPRegistry deployments to the toolhive-registry-server Helm chart, and link it from the existing deprecation notices. Also reorder the deployment sidebar to lead with Helm and reapply the Helm-page deprecation note that did not land in #926. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a dedicated how-to guide for migrating an operator-managed MCPRegistry deployment to the standalone toolhive-registry-server Helm chart, and links it from existing deprecation callouts so readers have an actionable migration path.
Changes:
- Added a new migration page that walks through a parallel cutover from
MCPRegistryto Helm. - Updated registry docs to link to the migration guide from deprecation warnings and the Helm page intro callout.
- Reordered the registry deployment sidebar items to lead with Helm (recommended) and include the migration guide.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
sidebars.ts |
Reorders Registry Server deployment docs and adds the new migration page to navigation. |
docs/toolhive/guides-registry/migrate-to-helm.mdx |
New migration how-to guide from operator-managed MCPRegistry to Helm. |
docs/toolhive/guides-registry/deployment.mdx |
Links the migration guide from the top-level CRD deprecation warning. |
docs/toolhive/guides-registry/deploy-operator.mdx |
Links the migration guide from the operator deployment deprecation notice. |
docs/toolhive/guides-registry/deploy-helm.mdx |
Reintroduces the operator deprecation + migration link in the Helm page intro callout. |
Comment on lines
+149
to
+150
| kubectl -n <NAMESPACE> port-forward svc/registry-server 8080:80 | ||
| curl http://localhost:8080/v0/servers |
Comment on lines
+153
to
+155
| The Helm release creates a service named after the release (for example, | ||
| `registry-server`), which differs from the service the operator created for your | ||
| `MCPRegistry`. Note the new service name and endpoint for the next step. |
| | --------------------------------- | ------------------------------------------- | | ||
| | `spec.configYAML` | `config` (as structured YAML, not a string) | | ||
| | `spec.pgpassSecretRef` | pgpass Secret + init container (see below) | | ||
| | `spec.podTemplateSpec.…resources` | `resources` | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Follow-up to #926. Adds a dedicated guide for migrating an operator-managed
MCPRegistrydeployment to the standalone toolhive-registry-server Helm chart, and wires it into the existing deprecation notices.Changes:
guides-registry/migrate-to-helm.mdx: a parallel-cutover how-to guide (capture config → mapconfigYAMLto the chart'sconfigblock → deploy the release → verify → repoint clients → remove theMCPRegistry). Includes a field-mapping table and reuses the existing PostgreSQL database, so no data migration is required.deployment.mdxanddeploy-operator.mdx.Type of change
Related issues/PRs
Submitter checklist
Content and formatting
Navigation
sidebars.ts) updated for added, deleted, reordered, or renamed filesvercel.jsonfor moved, renamed, or deleted pages (n/a - no URLs changed)🤖 Generated with Claude Code