Skip to content

Improve file store deprecation warning messages#18900

Merged
harupy merged 2 commits intomlflow:masterfrom
harupy:improve-filestore-deprecation-warning
Nov 19, 2025
Merged

Improve file store deprecation warning messages#18900
harupy merged 2 commits intomlflow:masterfrom
harupy:improve-filestore-deprecation-warning

Conversation

@harupy
Copy link
Member

@harupy harupy commented Nov 19, 2025

🛠 DevTools 🛠

Open in GitHub Codespaces

Install mlflow from this PR

# mlflow
pip install git+https://github.com/mlflow/mlflow.git@refs/pull/18900/merge
# mlflow-skinny
pip install git+https://github.com/mlflow/mlflow.git@refs/pull/18900/merge#subdirectory=libs/skinny

For Databricks, use the following command:

%sh curl -LsSf https://raw.githubusercontent.com/mlflow/mlflow/HEAD/dev/install-skinny.sh | sh -s pull/18900/merge

Related Issues/PRs

Addresses #18497 (comment)

What changes are proposed in this pull request?

This PR improves the deprecation warning messages for both tracking and model registry file stores to be more informative and less alarming to users. The warnings now include:

  • Specific deprecation timeframe (February 2026)
  • More reassuring language ("Consider transitioning" instead of "Please switch")

How is this PR tested?

  • Existing unit/integration tests
  • New unit/integration tests

Updated test regex patterns to match the new warning messages. Both tests pass successfully.

Does this PR require documentation update?

  • No. You can skip the rest of this section.

Release Notes

Is this a user-facing change?

  • Yes. Give a description of this change to be included in the release notes for MLflow users.

Improved deprecation warning messages for file-based tracking and model registry backends with specific timeline (February 2026) and clearer migration guidance.

What component(s), interfaces, languages, and integrations does this PR affect?

Components

  • area/tracking: Tracking Service, tracking client APIs, autologging
  • area/model-registry: Model Registry service, APIs, and the fluent client calls for Model Registry

How should the PR be classified in the release notes? Choose one:

  • rn/documentation - A user-facing documentation change worth mentioning in the release notes

Should this PR be included in the next patch release?

  • Yes (this PR will be cherry-picked and included in the next patch release)
  • No (this PR will be included in the next minor release)

🤖 Generated with Claude Code

Update deprecation warnings for both tracking and model registry
file stores to be more informative and less alarming:
- Add specific deprecation timeframe (February 2026)
- Use more reassuring language ("Consider transitioning")
- Remove "we" pronoun for neutral tone
- Provide clear migration guidance

Also update corresponding tests to match new warning messages.

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

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: harupy <17039389+harupy@users.noreply.github.com>
@github-actions github-actions bot added area/model-registry Model registry, model registry APIs, and the fluent client calls for model registry area/tracking Tracking service, tracking client APIs, autologging rn/documentation Mention under Documentation Changes in Changelogs. labels Nov 19, 2025
@harupy harupy requested a review from dbczumar November 19, 2025 00:02
@github-actions
Copy link
Contributor

github-actions bot commented Nov 19, 2025

Documentation preview for 018bcf7 is available at:

More info
  • Ignore this comment if this PR does not change the documentation.
  • The preview is updated when a new commit is pushed to this PR.
  • This comment was created by this workflow run.
  • The documentation was built by this workflow run.

Copy link
Collaborator

@dbczumar dbczumar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@harupy harupy added this pull request to the merge queue Nov 19, 2025
Merged via the queue into mlflow:master with commit e596512 Nov 19, 2025
47 checks passed
@harupy harupy deleted the improve-filestore-deprecation-warning branch November 19, 2025 16:46
Tian-Sky-Lan pushed a commit to Tian-Sky-Lan/mlflow that referenced this pull request Nov 24, 2025
Signed-off-by: harupy <17039389+harupy@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Signed-off-by: Tian Lan <sky.blue266000@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/model-registry Model registry, model registry APIs, and the fluent client calls for model registry area/tracking Tracking service, tracking client APIs, autologging rn/documentation Mention under Documentation Changes in Changelogs.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants