Skip to content

docs: replace deprecated PingCAP domains#361

Open
wuhuizuo wants to merge 1 commit intotikv:masterfrom
wuhuizuo:fix/update-pingcap-domains-master
Open

docs: replace deprecated PingCAP domains#361
wuhuizuo wants to merge 1 commit intotikv:masterfrom
wuhuizuo:fix/update-pingcap-domains-master

Conversation

@wuhuizuo
Copy link
Copy Markdown

@wuhuizuo wuhuizuo commented Apr 2, 2026

Summary

  • replace deprecated download.pingcap.org references with download.pingcap.com
  • replace deprecated charts.pingcap.org references with charts.pingcap.com
  • keep existing paths and protocols unchanged

Validation

  • git diff --check
  • verified no remaining download.pingcap.org / charts.pingcap.org references in the patched branch

Summary by CodeRabbit

  • Documentation
    • Updated download URLs across installation, deployment, testing, verification, and monitoring guides to use the new download.pingcap.com domain for TiDB, TiKV, Prometheus, node_exporter, Grafana, and Java client artifacts.
    • Updated Helm chart repository URLs for TiKV Operator setup to use https://charts.pingcap.com/ across documentation versions.

@ti-chi-bot
Copy link
Copy Markdown

ti-chi-bot Bot commented Apr 2, 2026

Welcome @wuhuizuo! It looks like this is your first PR to tikv/website 🎉

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 2, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8680a59f-ddc7-4e2b-b1b7-cc677b5076b4

📥 Commits

Reviewing files that changed from the base of the PR and between 7856116 and 37887ac.

📒 Files selected for processing (29)
  • content/docs/3.0/tasks/deploy/binary.md
  • content/docs/3.0/tasks/try/tikv-operator.md
  • content/docs/4.0/tasks/deploy/binary.md
  • content/docs/4.0/tasks/try/tikv-operator.md
  • content/docs/5.1/deploy/install/test.md
  • content/docs/5.1/deploy/install/verify.md
  • content/docs/5.1/deploy/monitor/deploy.md
  • content/docs/5.1/reference/CLI/pd-ctl.md
  • content/docs/5.1/reference/CLI/pd-recover.md
  • content/docs/6.1/deploy/install/test.md
  • content/docs/6.1/deploy/install/verify.md
  • content/docs/6.1/deploy/monitor/deploy.md
  • content/docs/6.1/reference/CLI/pd-ctl.md
  • content/docs/6.1/reference/CLI/pd-recover.md
  • content/docs/6.5/deploy/install/test.md
  • content/docs/6.5/deploy/install/verify.md
  • content/docs/6.5/deploy/monitor/deploy.md
  • content/docs/6.5/reference/CLI/pd-ctl.md
  • content/docs/6.5/reference/CLI/pd-recover.md
  • content/docs/7.1/deploy/install/test.md
  • content/docs/7.1/deploy/install/verify.md
  • content/docs/7.1/deploy/monitor/deploy.md
  • content/docs/7.1/reference/CLI/pd-ctl.md
  • content/docs/7.1/reference/CLI/pd-recover.md
  • content/docs/dev/deploy/install/test.md
  • content/docs/dev/deploy/install/verify.md
  • content/docs/dev/deploy/monitor/deploy.md
  • content/docs/dev/reference/CLI/pd-ctl.md
  • content/docs/dev/reference/CLI/pd-recover.md
✅ Files skipped from review due to trivial changes (27)
  • content/docs/dev/deploy/install/verify.md
  • content/docs/dev/deploy/monitor/deploy.md
  • content/docs/7.1/deploy/install/verify.md
  • content/docs/4.0/tasks/try/tikv-operator.md
  • content/docs/5.1/deploy/monitor/deploy.md
  • content/docs/5.1/deploy/install/verify.md
  • content/docs/6.5/deploy/install/verify.md
  • content/docs/7.1/deploy/install/test.md
  • content/docs/6.1/deploy/install/test.md
  • content/docs/6.1/deploy/install/verify.md
  • content/docs/dev/reference/CLI/pd-ctl.md
  • content/docs/dev/reference/CLI/pd-recover.md
  • content/docs/5.1/reference/CLI/pd-recover.md
  • content/docs/6.5/reference/CLI/pd-ctl.md
  • content/docs/dev/deploy/install/test.md
  • content/docs/5.1/deploy/install/test.md
  • content/docs/5.1/reference/CLI/pd-ctl.md
  • content/docs/7.1/deploy/monitor/deploy.md
  • content/docs/6.5/reference/CLI/pd-recover.md
  • content/docs/4.0/tasks/deploy/binary.md
  • content/docs/7.1/reference/CLI/pd-ctl.md
  • content/docs/6.5/deploy/monitor/deploy.md
  • content/docs/6.1/reference/CLI/pd-ctl.md
  • content/docs/6.1/deploy/monitor/deploy.md
  • content/docs/3.0/tasks/deploy/binary.md
  • content/docs/7.1/reference/CLI/pd-recover.md
  • content/docs/6.1/reference/CLI/pd-recover.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • content/docs/6.5/deploy/install/test.md

📝 Walkthrough

Walkthrough

Updated documentation download and Helm chart URLs across multiple docs: replaced download.pingcap.orgdownload.pingcap.com for binaries/checksums/jars and charts.pingcap.orgcharts.pingcap.com for Helm repository entries.

Changes

Cohort / File(s) Summary
TiKV Operator Setup
content/docs/3.0/tasks/try/tikv-operator.md, content/docs/4.0/tasks/try/tikv-operator.md
Changed Helm repo URL from https://charts.pingcap.org/ to https://charts.pingcap.com/.
Binary Deployment Instructions
content/docs/3.0/tasks/deploy/binary.md, content/docs/4.0/tasks/deploy/binary.md
Replaced TiDB tarball and .sha256 download hosts from download.pingcap.org to download.pingcap.com in single‑machine and multi‑node sections.
Test Installation Guides
content/docs/5.1/.../deploy/install/test.md, content/docs/6.1/.../deploy/install/test.md, content/docs/6.5/.../deploy/install/test.md, content/docs/7.1/.../deploy/install/test.md, content/docs/dev/.../deploy/install/test.md
Replaced download.pingcap.orgdownload.pingcap.com for TiDB binary and checksum download URLs across version branches.
Verification & Java Client
content/docs/5.1/.../deploy/install/verify.md, content/docs/6.1/.../deploy/install/verify.md, content/docs/6.5/.../deploy/install/verify.md, content/docs/7.1/.../deploy/install/verify.md, content/docs/dev/.../deploy/install/verify.md
Updated tikv-client-java.jar (and related jar) download URLs to download.pingcap.com.
Monitoring Deployment
content/docs/5.1/.../deploy/monitor/deploy.md, content/docs/6.1/.../deploy/monitor/deploy.md, content/docs/6.5/.../deploy/monitor/deploy.md, content/docs/7.1/.../deploy/monitor/deploy.md, content/docs/dev/.../deploy/monitor/deploy.md
Switched Prometheus, node_exporter, and Grafana wget URLs to download.pingcap.com (same filenames/versions).
PD Control Reference
content/docs/5.1/.../reference/CLI/pd-ctl.md, content/docs/6.1/.../reference/CLI/pd-ctl.md, content/docs/6.5/.../reference/CLI/pd-ctl.md, content/docs/7.1/.../reference/CLI/pd-ctl.md, content/docs/dev/.../reference/CLI/pd-ctl.md
Updated pd-ctl package and .sha256 URLs to download.pingcap.com and aligned {version} example URL.
PD Recover Reference
content/docs/5.1/.../reference/CLI/pd-recover.md, content/docs/6.1/.../reference/CLI/pd-recover.md, content/docs/6.5/.../reference/CLI/pd-recover.md, content/docs/7.1/.../reference/CLI/pd-recover.md, content/docs/dev/.../reference/CLI/pd-recover.md
Replaced TiDB package and checksum URLs with download.pingcap.com and updated {version} example links.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A nimble rabbit nibbles links,
Swapping .org for shiny .com kinks.
Across the docs I hop and cheer,
URLs aligned far and near—
Hooray! 🥕

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title 'docs: replace deprecated PingCAP domains' accurately and concisely describes the primary change in the pull request—updating domain references across documentation files.
Description check ✅ Passed The description clearly explains what was changed (deprecated domain replacements), why (domain updates), and includes validation steps performed, adequately covering the PR's objectives.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

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

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 and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🧹 Nitpick comments (1)
content/docs/3.0/tasks/deploy/binary.md (1)

31-31: Note: Protocol inconsistency for SHA256 checksum URL.

Line 31 (and line 101) use http:// instead of https:// for the SHA256 checksum download. While this is not introduced by this PR, consider updating to https:// for consistency and security.

🔒 Suggested protocol update
-    wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
+    wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

Apply the same change at line 101.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@content/docs/3.0/tasks/deploy/binary.md` at line 31, Update the SHA256
checksum download commands to use HTTPS instead of HTTP: locate the two wget
lines that download "tidb-latest-linux-amd64.sha256" (the occurrences using
"http://download.pingcap.com/tidb-latest-linux-amd64.sha256") and change their
URLs to "https://download.pingcap.com/tidb-latest-linux-amd64.sha256" to ensure
protocol consistency and security.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@content/docs/6.5/deploy/install/test.md`:
- Around line 89-90: The .sha256 checksum downloads use insecure HTTP; update
the wget invocations that fetch the checksum files (e.g., the lines invoking
wget http://download.pingcap.com/...tidb-latest-linux-amd64.sha256 and the other
similar .sha256 wget) to use HTTPS instead so the checksum cannot be tampered
with in transit; locate the wget commands that reference ".sha256" (the checksum
download commands) and replace "http://" with "https://" for each occurrence.

In `@content/docs/dev/deploy/install/test.md`:
- Line 90: Replace the insecure HTTP checksum download command so it uses HTTPS:
update the wget invocation that fetches "tidb-latest-linux-amd64.sha256" (and
the other occurrence around the same block) to use
https://download.pingcap.com/tidb-latest-linux-amd64.sha256 instead of http://
so the sha256 checksum file is fetched over TLS and cannot be modified in
transit.

---

Nitpick comments:
In `@content/docs/3.0/tasks/deploy/binary.md`:
- Line 31: Update the SHA256 checksum download commands to use HTTPS instead of
HTTP: locate the two wget lines that download "tidb-latest-linux-amd64.sha256"
(the occurrences using
"http://download.pingcap.com/tidb-latest-linux-amd64.sha256") and change their
URLs to "https://download.pingcap.com/tidb-latest-linux-amd64.sha256" to ensure
protocol consistency and security.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 50c181e7-a71a-433a-aad6-da9d5a8a1984

📥 Commits

Reviewing files that changed from the base of the PR and between 1578bc3 and 7856116.

📒 Files selected for processing (29)
  • content/docs/3.0/tasks/deploy/binary.md
  • content/docs/3.0/tasks/try/tikv-operator.md
  • content/docs/4.0/tasks/deploy/binary.md
  • content/docs/4.0/tasks/try/tikv-operator.md
  • content/docs/5.1/deploy/install/test.md
  • content/docs/5.1/deploy/install/verify.md
  • content/docs/5.1/deploy/monitor/deploy.md
  • content/docs/5.1/reference/CLI/pd-ctl.md
  • content/docs/5.1/reference/CLI/pd-recover.md
  • content/docs/6.1/deploy/install/test.md
  • content/docs/6.1/deploy/install/verify.md
  • content/docs/6.1/deploy/monitor/deploy.md
  • content/docs/6.1/reference/CLI/pd-ctl.md
  • content/docs/6.1/reference/CLI/pd-recover.md
  • content/docs/6.5/deploy/install/test.md
  • content/docs/6.5/deploy/install/verify.md
  • content/docs/6.5/deploy/monitor/deploy.md
  • content/docs/6.5/reference/CLI/pd-ctl.md
  • content/docs/6.5/reference/CLI/pd-recover.md
  • content/docs/7.1/deploy/install/test.md
  • content/docs/7.1/deploy/install/verify.md
  • content/docs/7.1/deploy/monitor/deploy.md
  • content/docs/7.1/reference/CLI/pd-ctl.md
  • content/docs/7.1/reference/CLI/pd-recover.md
  • content/docs/dev/deploy/install/test.md
  • content/docs/dev/deploy/install/verify.md
  • content/docs/dev/deploy/monitor/deploy.md
  • content/docs/dev/reference/CLI/pd-ctl.md
  • content/docs/dev/reference/CLI/pd-recover.md

Comment on lines +89 to +90
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Use HTTPS for .sha256 downloads to preserve integrity guarantees.

The checksum files are still fetched via http:// (Line 90, Line 160). This undermines the checksum verification step because the checksum itself can be tampered with in transit.

🔧 Proposed fix
-    wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
+    wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256
...
-    wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
+    wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

Also applies to: 159-160

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@content/docs/6.5/deploy/install/test.md` around lines 89 - 90, The .sha256
checksum downloads use insecure HTTP; update the wget invocations that fetch the
checksum files (e.g., the lines invoking wget
http://download.pingcap.com/...tidb-latest-linux-amd64.sha256 and the other
similar .sha256 wget) to use HTTPS instead so the checksum cannot be tampered
with in transit; locate the wget commands that reference ".sha256" (the checksum
download commands) and replace "http://" with "https://" for each occurrence.

wget https://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Use HTTPS for checksum downloads to preserve integrity guarantees.

The .sha256 files are still fetched over plain HTTP. If the checksum file can be modified in transit, sha256sum -c no longer provides trustworthy verification.

🔧 Proposed fix
-    wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
+    wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256
...
-    wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
+    wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

Also applies to: 160-160

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@content/docs/dev/deploy/install/test.md` at line 90, Replace the insecure
HTTP checksum download command so it uses HTTPS: update the wget invocation that
fetches "tidb-latest-linux-amd64.sha256" (and the other occurrence around the
same block) to use https://download.pingcap.com/tidb-latest-linux-amd64.sha256
instead of http:// so the sha256 checksum file is fetched over TLS and cannot be
modified in transit.

Signed-off-by: wuhuizuo <wuhuizuo@126.com>
@wuhuizuo wuhuizuo force-pushed the fix/update-pingcap-domains-master branch from 7856116 to 37887ac Compare April 2, 2026 10:42
wget https://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Suggested change
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

wget https://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Suggested change
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

wget https://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Suggested change
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

wget https://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Suggested change
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

wget https://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Suggested change
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

wget https://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Suggested change
wget http://download.pingcap.com/tidb-latest-linux-amd64.sha256
wget https://download.pingcap.com/tidb-latest-linux-amd64.sha256

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.

1 participant