Skip to content

KEP-0003: Technical implementation strategy for Kubeflow Hub rename#2239

Open
chambridge wants to merge 1 commit intokubeflow:mainfrom
chambridge:kep-0003-renaming-strategy
Open

KEP-0003: Technical implementation strategy for Kubeflow Hub rename#2239
chambridge wants to merge 1 commit intokubeflow:mainfrom
chambridge:kep-0003-renaming-strategy

Conversation

@chambridge
Copy link
Contributor

Description

Introduces KEP-0003 defining the technical implementation strategy for renaming "Kubeflow Model Registry" to "Kubeflow Hub" following community approval of KEP-907. The KEP establishes Kubeflow Hub as an umbrella project name grouping AI asset management components (Model Registry, Catalog, and future capabilities) while maintaining stable component names to minimize disruption.

Key Technical Decisions:

  • Repository rename: kubeflow/model-registry → kubeflow/hub
  • Container registry hard cutover to ghcr.io/kubeflow/hub/* for new versions
  • Go developers encouraged to migrate to Kubeflow SDK
  • API paths remain unchanged for backwards compatibility
  • Python SDK package name stays "model-registry" (component-specific)
  • Kubernetes service names unchanged (component names remain accurate)
  • Addition of /catalog/ API alias alongside /model_catalog/

Design Approach:

  • Zero breaking changes to API paths and Python SDK
  • Hard cutover for container images with clear migration timeline
  • Component-by-component impact analysis with mitigation strategies
  • Comprehensive user stories covering all stakeholder groups
  • Phased graduation criteria (Alpha → Beta → Stable)
  • Detailed alternatives analysis with rationale for decisions

The KEP follows proper KEP format with complete sections for summary, motivation, proposal, design details, test plan, graduation criteria, drawbacks, alternatives, and references.

Merge criteria:

  • All the commits have been signed-off (To pass the DCO check)
  • The commits have meaningful messages
  • Automated tests are provided as part of the PR for major new functionalities; testing instructions have been added in the PR body (for PRs involving changes that are not immediately obvious).
  • The developer has manually tested the changes and verified that the changes work.
  • Code changes follow the kubeflow contribution guidelines.
  • For first time contributors: Please reach out to the Reviewers to ensure all tests are being run, ensuring the label ok-to-test has been added to the PR.

If you have UI changes

  • The developer has added tests or explained why testing cannot be added.
  • Included any necessary screenshots or gifs if it was a UI change.
  • Verify that UI/UX changes conform the UX guidelines for Kubeflow.

…w Hub rename

Introduces KEP-0003 defining the technical implementation strategy for
renaming "Kubeflow Model Registry" to "Kubeflow Hub" following community
approval of KEP-907. The KEP establishes Kubeflow Hub as an umbrella project
name grouping AI asset management components (Model Registry, Catalog, and
future capabilities) while maintaining stable component names to minimize
disruption.

Key Technical Decisions:
- Repository rename: kubeflow/model-registry → kubeflow/hub
- Container registry hard cutover to ghcr.io/kubeflow/hub/* for new versions
- Go developers encouraged to migrate to Kubeflow SDK
- API paths remain unchanged for backwards compatibility
- Python SDK package name stays "model-registry" (component-specific)
- Kubernetes service names unchanged (component names remain accurate)
- Addition of /catalog/ API alias alongside /model_catalog/

Design Approach:
- Zero breaking changes to API paths and Python SDK
- Hard cutover for container images with clear migration timeline
- Component-by-component impact analysis with mitigation strategies
- Comprehensive user stories covering all stakeholder groups
- Phased graduation criteria (Alpha → Beta → Stable)
- Detailed alternatives analysis with rationale for decisions

The KEP follows proper KEP format with complete sections for summary,
motivation, proposal, design details, test plan, graduation criteria,
drawbacks, alternatives, and references.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Chris Hambridge <chambrid@redhat.com>
@google-oss-prow
Copy link

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign rareddy for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments