Skip to content

docs: remove outdated CentOS 7 quick start recommendation - #21968

Open
doc-claw-bot wants to merge 2 commits into
pingcap:masterfrom
doc-claw-bot:docs/quick-start-os-recommendation
Open

doc-claw-bot wants to merge 2 commits into
pingcap:masterfrom
doc-claw-bot:docs/quick-start-os-recommendation

Conversation

@doc-claw-bot

@doc-claw-bot doc-claw-bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

What is changed, added, or deleted? (Required)

  • Update the Chinese quick-start-with-tidb.md page to remove the outdated CentOS 7.3/7.6 recommendations in the simulated production deployment section.
  • Fix the cleanup steps in the simulated production deployment section to use tiup cluster stop and tiup cluster destroy instead of the Playground-only Ctrl+C and tiup clean --all flow.
  • Point readers to the current OS and platform requirements page for the supported Linux distribution and CPU architecture combinations.

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions (in Chinese).

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)

What is the related PR or file link(s)?

AI agent involvement

  • The changes in this PR were primarily made by an AI agent on behalf of the PR author.

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

Summary by CodeRabbit

  • 文档
    • 更新快速入门中的环境要求,链接至支持的操作系统及 CPU 架构说明。
    • 调整清理步骤,改为先停止集群,再销毁集群。

@ti-chi-bot

ti-chi-bot Bot commented Oct 8, 2026

Copy link
Copy Markdown

[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 hfxsd for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

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

@ti-chi-bot ti-chi-bot Bot added contribution This PR is from a community contributor. missing-translation-status This PR does not have translation status info. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Oct 8, 2026
@coderabbitai

coderabbitai Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Repository: pingcap/docs-cn/.coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: f02a992d-6dea-4342-94fd-5210f98c10d7


📥 Commits

Reviewing files that changed from the base of the PR and between aa9a05e and fdedcc7.



📒 Files selected for processing (1)
  • quick-start-with-tidb.md


Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 3 remain after this review.




📝 Walkthrough
📝 Walkthrough

Walkthrough

快速开始文档更新了 Linux 发行版和 CPU 架构要求说明,并将清理步骤改为先停止集群,再销毁集群。

Changes

TiDB 快速开始文档

层 / 文件 说明
更新操作系统要求说明
quick-start-with-tidb.md
将 CentOS 版本建议改为链接至 TiDB 支持的 Linux 发行版和操作系统与 CPU 架构组合要求。
更新集群清理步骤
quick-start-with-tidb.md
将清理步骤改为先运行 tiup cluster stop <cluster-name>,再运行 tiup cluster destroy <cluster-name>。删除按 Control+C 停止服务、等待退出及运行 tiup clean --all 的步骤。

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other



Merge Risk: ⚪ Minimal · up to fdedc

The quick-start now points readers to the supported platform requirements and documents a valid cluster cleanup sequence. No material merge risk is evident.

Architecture Summary

Architecture risk: 🔵 Low · up to fdedc

The change affects 1 system.

Changed systems: quick-start-with-tidb.md

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — quick-start-with-tidb.md (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

  • observed — Modified behavior in quick-start-with-tidb.md: 将推荐安装 CentOS 7.3 及以上版本改为安装 TiDB 支持的 Linux 发行版,并链接至操作系统要求文档。
  • observed — Modified behavior in quick-start-with-tidb.md: 保留 TiUP Cluster 支持 x86_64(AMD64)和 ARM 架构的说明;删除各架构对应的 CentOS 版本建议,并改为链接至支持的操作系统与 CPU 架构组合要求。
  • observed — Modified behavior in quick-start-with-tidb.md: 清理步骤改为先执行 tiup cluster stop <cluster-name>,再执行 tiup cluster destroy <cluster-name>;删除了按 Control+C 停止服务、等待退出并运行 tiup clean --all 的步骤。


Pre-merge checks | Passed 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Title check Passed 标题准确描述了删除过时 CentOS 7 快速开始推荐这一实际变更。虽然未涵盖清理步骤修正,但仍与变更内容直接相关。
Description check Passed 描述包含变更内容、适用版本、相关链接、AI 参与情况和范围复选框。必需信息基本完整,符合模板要求。

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create a new PR



  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@doc-claw-bot doc-claw-bot added type/bugfix This PR fixes a bug. translation/from-docs This PR is translated from a PR in pingcap/docs. needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. labels Oct 8, 2026
@ti-chi-bot ti-chi-bot Bot removed the missing-translation-status This PR does not have translation status info. label Oct 8, 2026
@ti-chi-bot ti-chi-bot Bot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Oct 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution This PR is from a community contributor. needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. translation/from-docs This PR is translated from a PR in pingcap/docs. type/bugfix This PR fixes a bug.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant