Skip to content

Free cluster: replace the automatic upgrade (graduation) with a customer-managed move to a paid cluster, and add the Fabric Eventhouse path - #2954

Closed
Shirimorshtein wants to merge 10 commits into
MicrosoftDocs:mainfrom
Shirimorshtein:patch-1
Closed

Shirimorshtein wants to merge 10 commits into
MicrosoftDocs:mainfrom
Shirimorshtein:patch-1

Conversation

@Shirimorshtein

Copy link
Copy Markdown

Summary

The free cluster's automatic upgrade to a full cluster ("graduation") is being deprecated. Customers who want a paid cluster create one themselves, move their data, and delete the free cluster when they're done. Microsoft doesn't convert, move, or delete the free cluster - deleting it is the customer's responsibility. Eventhouse in Microsoft Fabric (free trial) is recommended as the default growth path.

Changes

File Change
start-for-free.md Upgrade bullet -> create a new cluster and migrate your data; the free cluster isn't converted, moved, or deleted automatically. New sections Try Eventhouse in Microsoft Fabric for free and Move to a paid cluster. Related content updated; ms.date bumped.
start-for-free-move-to-paid.md New how-to: create the paid cluster -> export/import data -> reapply permissions and data connections -> validate and switch -> delete the free cluster (customer action), plus the Eventhouse alternative.
start-for-free-web-ui.md Overview bullet and Related content updated (move to a paid cluster / try Eventhouse).
start-for-free-upgrade.md + media/start-for-free-upgrade/* Deleted; redirected to the new article in .openpublishing.redirection.json.
toc.yml Admin > Manage > Free cluster: Upgrade a free cluster -> Move to a paid cluster.
start-for-free-event-hubs.md, whats-new-archive.md Links to the removed article retargeted.

Timing - do not merge before the UI change ships

The free-cluster UI still shows Upgrade to Azure Cluster and runs the automatic flow today. Keep this PR as a draft until the UI change is in production, then merge so the docs and the product switch together.

Open items for reviewers

  • Step 2 commands (export/import) need engineering validation on a real free cluster (Amir Dachabash's team).
  • Final label of the UI button ("Upgrade to Azure Cluster" vs. "Move to a paid cluster"); align start-for-free-web-ui.md.
  • Retake media/start-for-free-web-ui/start-for-free-overview-page.png after the UI change.
  • Confirm the Fabric links resolve in the build.
  • Legal/CELA review of the Important box wording (same owners as PR #7207).

Suggested reviewers: ADX content developer; Yochai Gilad (author of PR #7207); Amir Dachabash (step 2 commands); Noam Shapira / Michal Bar (PM review).


Thank you for contributing to Kusto documentation

Please add a brief comment outlining the purpose of this PR. Add links to any relevant references such as DevOps work items.

Make sure you've done the following:

  1. Learn Authoring Assistant: Check the review done by the system to check editorial and style guide suggestions. Approve or #reject all suggestions before sign-off.

  2. Successful build: Review the build status to make sure all files are green (Succeeded) and there are no errors, warnings, or suggestions.

  3. Preview the pages: Click each Preview URL link, scan the entire page looking for formatting issues, in particular the parts you edited.

  4. Check the Table of Contents: If you're adding a new markdown file, make sure it is linked from the table of contents.

  5. Sign off: Once the PR is finalized, add a comment with #sign-off . If you need to cancel the sign-off, add a comment with #hold-off.

    NOTE: Signing off means the document can be published at any time.

Next steps

  • All PRs to this repository are reviewed and merged by a human. Automatic merge is disabled on this repository for PRs, even with the qualifies-for-auto-merge label.
  • Once all feedback on the PR is addressed, the PR will be merged into the main branch.

Learn more about how to contribute

… cluster replaces automatic upgrade; add Fabric Eventhouse path

Graduation (automatic upgrade of a free cluster) is being deprecated. The article now explains that customers create a paid cluster, migrate their data and delete the free cluster themselves (the free cluster is not converted, moved or deleted automatically), and recommends Eventhouse in Microsoft Fabric as a free path.
…a paid cluster replaces upgrade; add Eventhouse link
…automatic upgrade is deprecated; redirected to start-for-free-move-to-paid)-upgrade.md
…art-for-free-upgrade articlefor-free-upgrade directory
@prmerger-automator

Copy link
Copy Markdown
Contributor

Shirimorshtein : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. Sreedhar Pelluru (@spelluru)@shirimorshtein

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit a9c41b6:

✅ Validation status: passed

File Status Preview URL Details
data-explorer/.openpublishing.redirection.json ✅Succeeded
data-explorer/media/start-for-free-upgrade/start-for-free-upgrade-cluster-details.png ✅Succeeded n/a (file deleted or renamed)
data-explorer/media/start-for-free-upgrade/start-for-free-upgrade-cluster.png ✅Succeeded n/a (file deleted or renamed)
data-explorer/start-for-free-event-hubs.md ✅Succeeded
data-explorer/start-for-free-move-to-paid.md ✅Succeeded
data-explorer/start-for-free-upgrade.md ✅Succeeded n/a (file deleted or renamed)
data-explorer/start-for-free-web-ui.md ✅Succeeded
data-explorer/start-for-free.md ✅Succeeded
data-explorer/toc.yml ✅Succeeded
data-explorer/whats-new-archive.md ✅Succeeded

For more details, please refer to the build report.

@prmerger-automator

Copy link
Copy Markdown
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Deleted File(s) This PR deletes Markdown or YAML files owned by another author, or json file(s). The pull request must contain a comment from the pull request author confirming that all the file deletions are intentional before the pull request can be merged.
Yaml File(s) This PR includes changes to .yml file(s) owned by another author.
File Change Percent This PR contains file(s) with more than 30% file change.
GDPR Content(s) PR references GDPR and must be human reviewed to ensure appropriate guidelines are followed.
Image File This PR added, updated, or deleted an image file(s).
Json File This PR contains json file(s).

@Shirimorshtein
Shirimorshtein marked this pull request as ready for review November 2, 2026 13:05
@Court72

Copy link
Copy Markdown
Contributor

Shirimorshtein

This PR was opened in the public repository, but Microsoft employees need to work in the private repository: dataexplorer-docs-pr. For more information and resources to get started, see Should I work in a private or a public repo (sign-in required).

You can re-create your changes in a new PR in the private repo, or you can move the commits from this PR into the private repo.

If you need help moving these commits or if you have questions, email the publicprs alias.

I'll close this PR now.
#please-close
@MicrosoftDocs/public-repo-pr-review-team

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants