Skip to content

byoc: update custom, shared, and release content - #24425

Open
lilin90 wants to merge 16 commits into
pingcap:release-8.5from
lilin90:byoc-preview-updates
Open

lilin90 wants to merge 16 commits into
pingcap:release-8.5from
lilin90:byoc-preview-updates

Conversation

@lilin90

@lilin90 lilin90 commented Oct 10, 2026 •

Copy link
Copy Markdown
Member

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

  • Update BYOC CustomContent and content shared by BYOC & Premium
  • Make select BYOC CustomContent public on the pages of all cloud plans

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.

  • 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)?

  • Related code change PR links (if applicable):
  • This PR is translated from:
  • Other reference 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

  • Documentation
    • Updated TiDB Cloud guides to cover Premium and BYOC for connections, backups and restores, data imports and exports, auditing, data pipelines, changefeeds, and instance management.
    • Clarified plan-specific availability and requirements, including AWS import prerequisites and the lack of OSS import support for BYOC.
    • Updated BYOC availability wording and expanded plan information in product, pricing, security, and support guidance.

@lilin90 lilin90 self-assigned this Oct 10, 2026
@lilin90 lilin90 added translation/no-need No need to translate this PR. BYOC Related to TiDB Cloud BYOC docs. labels Oct 10, 2026
@ti-chi-bot

ti-chi-bot Bot commented Oct 10, 2026

Copy link
Copy Markdown

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@ti-chi-bot ti-chi-bot Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 10, 2026
@ti-chi-bot

ti-chi-bot Bot commented Oct 10, 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 ask for approval from lilin90. 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 the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Oct 10, 2026
@coderabbitai

coderabbitai Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

The documentation updates make BYOC content visible in selected TiDB Cloud pages and name BYOC alongside Premium in multiple guides. They also add BYOC-specific details for backup costs, import limitations, connection options, changefeed capacity, and data-access controls.

Changes: BYOC documentation coverage

Layer / File(s) Summary
Plan overviews and availability
TOC-tidb-cloud-byoc.md, tidb-cloud/architecture-concepts.md, tidb-cloud/select-cluster-tier.md, tidb-cloud/manage-projects-and-resources.md, tidb-cloud/tidb-cloud-intro.md, tidb-cloud/tidb-cloud-billing.md, tidb-cloud/tidb-cloud-support.md
Plan and product pages remove selected BYOC-specific content wrappers. The plan list shows all six plans, and the introduction changes BYOC’s AWS status from private preview to public preview.
Backup, restore, and deletion
tidb-cloud/backup-and-restore-concepts.md, tidb-cloud/premium/backup-and-restore-premium.md, tidb-cloud/premium/delete-tidb-instance.md
Guidance names Premium and BYOC directly. The backup guides describe plan-specific storage and cost details.
Instance and private endpoint connections
tidb-cloud/premium/connect-to-premium-via-aws-private-endpoint.md, tidb-cloud/premium/connect-to-premium-via-public-connection.md, tidb-cloud/premium/connect-to-tidb-instance.md, tidb-cloud/premium/set-up-sink-private-endpoint-premium.md
Connection and private-endpoint guides name Premium and BYOC. The MySQL CLI import guide also describes BYOC public and private connection options.
Pipelines, imports, and exports
tidb-cloud/data-pipeline-lake-faq.md, tidb-cloud/data-pipeline.md, tidb-cloud/premium/import-csv-files-premium.md, tidb-cloud/premium/import-from-s3-premium.md, tidb-cloud/premium/import-with-mysql-cli-premium.md, tidb-cloud/premium/premium-export.md
Pipeline and data-transfer guides add BYOC coverage. CSV import guidance states that BYOC does not support OSS imports and specifies a tag for BYOC AWS Role ARNs.
Changefeed coverage and capacity
tidb-cloud/changefeed-overview.md, tidb-cloud/changefeed-sink-to-apache-kafka.md, tidb-cloud/changefeed-sink-to-mysql.md
Selected changefeed limits, connectivity instructions, and navigation include BYOC. Capacity guidance describes BYOC capacity in provisioned TiCDC-node vCPUs.
Audit logging, insights, and security
tidb-cloud/premium/tidb-cloud-auditing-premium.md, tidb-cloud/statement-insight.md, tidb-cloud/security-overview.md, tidb-cloud/tidb-cloud-log-redaction.md
Audit logging, Statement Insights, and log-redaction pages include BYOC. The security overview adds a BYOC data-access-controls section.

Priority: ➖ Normal

Estimated code review effort: 3 (Moderate) | ~20 minutes

Change: Other

Suggested reviewers: qiancai

Merge Risk: 🔵 Low · up to d5c04

The PR changes documentation only, but several BYOC instructions could mislead readers or render incorrectly. These are bounded documentation fixes rather than runtime risks.

Security architecture risk: 🔵 Low · up to d5c04

The shared guidance retains deployment-specific connection restrictions, credential requirements, and storage-access prerequisites. No security bypass introduced by this PR was established. However, BYOC network-control instructions and authorization enforcement remain insufficiently verified.

Retained concerns
No architecture-level concerns identified.

Security review details

Security Blast Radius

  • inferred — The sensitive outcomes described by these guides are SQL access to a selected instance and storage-backed writes into selected database tables. Storage exposure depends on the supplied credentials and IAM resource permissions. Documentation alone does not establish maximum cross-instance, tenant, or cloud-account authority.

Trust Boundaries and Controls

  • observed — The expanded MySQL CLI instructions retain SQL credentials, appropriate SQL privileges, and commands using VERIFY_IDENTITY with a CA certificate. No changed BYOC branch removes these documented controls; their runtime effectiveness was not verified.
  • observed — The linked IAM setup documents bucket and object-resource permissions, a trusted TiDB Cloud account, and an external ID. The BYOC role tag is an additional prerequisite, not evidence that arbitrary tagged roles can be assumed. The deployed BYOC trust policy and enforcement path remain unknown.

Resilience and Maintainability Implications

  • inferred — Documented forward validation and manual partial-import cleanup do not resolve authorization after role revocation, interruption, repeated execution, or concurrent imports. Production lifecycle evidence is needed to assess those guarantees; no PR-introduced failure in those transitions was established.
Pre-merge checks: Passed 5
Passed 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 The title clearly identifies the BYOC and shared-content updates. The wording is concise and related to the main changes.
Description check Passed The description includes the required change summary and identifies v8.5 as the affected version. Optional reference links are empty, but the description is otherwise complete and relevant.
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Create a new PR
  • Autofix · 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.

Update two TiDB Cloud Premium docs to consistently cover both Premium and BYOC instances. This revises page titles/summaries, replaces conditional plan-specific text with shared wording, and cleans up repeated references across backup/restore and AWS PrivateLink guidance. It also updates one pricing link label for clarity.
@ti-chi-bot ti-chi-bot Bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Oct 10, 2026
Update seven TiDB Cloud Premium docs to consistently state support for both {{{ .premium }}} and {{{ .byoc }}} instances in titles, summaries, headings, and body text. This also replaces several inline plan-specific CustomContent fragments with direct wording for readability, and refines CSV import descriptions to clarify that Amazon S3 applies to both plans while Alibaba Cloud OSS remains Premium-only.
@ti-chi-bot ti-chi-bot Bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Oct 12, 2026
@lilin90 lilin90 changed the title (WIP) byoc: update custom and shared content byoc: update custom and shared content Oct 12, 2026
@lilin90
lilin90 marked this pull request as ready for review October 12, 2026 03:26
Copilot AI balanced review requested due to automatic review settings October 12, 2026 03:26
@ti-chi-bot ti-chi-bot Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 12, 2026
@lilin90
lilin90 requested a review from wildpcww October 12, 2026 03:26
@lilin90

lilin90 commented Oct 12, 2026

Copy link
Copy Markdown
Member Author

@coderabbitai help

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟡 Changes recommended

Several pages advertise BYOC support while retaining Premium-only procedures or headings, and the BYOC navigation remains stale.

7 open findings
What changed in this PR

Makes BYOC information publicly visible across shared TiDB Cloud documentation and broadens Premium procedures to cover BYOC.

Changes:

  • Removes selected BYOC-only content gates.
  • Expands shared Premium/BYOC task documentation.
  • Updates BYOC preview status and feature references.
File Description
tidb-cloud/​tidb-cloud-support.md Exposes BYOC support-plan requirements.
tidb-cloud/​tidb-cloud-intro.md Publishes BYOC overview and architecture note.
tidb-cloud/​tidb-cloud-billing.md Exposes BYOC pricing guidance.
tidb-cloud/​statement-insight.md Broadens availability wording to BYOC.
tidb-cloud/​select-cluster-tier.md Exposes BYOC plan information.
tidb-cloud/​premium/​tidb-cloud-auditing-premium.md Extends auditing guidance to BYOC.
tidb-cloud/​premium/​premium-export.md Extends export guidance to BYOC.
tidb-cloud/​premium/​import-from-s3-premium.md Adds BYOC to S3 import scope.
tidb-cloud/​premium/​import-csv-files-premium.md Adds BYOC to S3 import scope.
tidb-cloud/​premium/​delete-tidb-instance.md Extends deletion guidance to BYOC.
tidb-cloud/​premium/​connect-to-tidb-instance.md Broadens connection overview to BYOC.
tidb-cloud/​premium/​connect-to-premium-via-public-connection.md Extends public-connection guidance.
tidb-cloud/​premium/​connect-to-premium-via-aws-private-endpoint.md Extends PrivateLink guidance.
tidb-cloud/​premium/​backup-and-restore-premium.md Consolidates Premium/BYOC backup guidance.
tidb-cloud/​manage-projects-and-resources.md Exposes BYOC resource and creation links.
tidb-cloud/​data-pipeline.md Publishes shared BYOC pipeline references.
tidb-cloud/​data-pipeline-lake-faq.md Broadens latency guidance to BYOC.
tidb-cloud/​backup-and-restore-concepts.md Exposes BYOC backup concepts.
tidb-cloud/​architecture-concepts.md Publishes BYOC architecture details.

🧠 Review effort: Balanced


💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread tidb-cloud/premium/backup-and-restore-premium.md Outdated
Comment thread tidb-cloud/premium/connect-to-premium-via-aws-private-endpoint.md
Comment thread tidb-cloud/premium/delete-tidb-instance.md
Comment thread tidb-cloud/premium/import-csv-files-premium.md
Comment thread tidb-cloud/premium/import-from-s3-premium.md Outdated
Comment thread tidb-cloud/premium/premium-export.md Outdated
Comment thread tidb-cloud/premium/tidb-cloud-auditing-premium.md Outdated
lilin90 and others added 4 commits October 12, 2026 11:31
Updated the restore instructions to include BYOC instances.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@lilin90

lilin90 commented Oct 12, 2026

Copy link
Copy Markdown
Member Author

@wildpcww Please review changes in this PR. Thanks!

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🔇 Additional comments (10)
tidb-cloud/premium/connect-to-premium-via-aws-private-endpoint.md (1)

2-3: LGTM!

Also applies to: 6-6, 8-8, 30-30, 38-38, 44-44, 50-50, 59-59, 91-91, 109-109, 113-113, 135-135, 175-175, 197-197, 216-216

tidb-cloud/premium/connect-to-premium-via-public-connection.md (1)

2-2: LGTM!

Also applies to: 6-6, 8-8, 25-25, 29-29, 79-79

tidb-cloud/premium/connect-to-tidb-instance.md (1)

2-3: LGTM!

Also applies to: 6-6, 8-8, 16-16, 26-26, 34-34, 46-46

tidb-cloud/tidb-cloud-intro.md (1)

127-127: 🎯 Functional Correctness

The AWS BYOC availability status for release-8.5 cannot be decided from the available evidence. The repository shows the wording change, but no authoritative source confirms when BYOC entered public preview. The available web results do not establish this status.

tidb-cloud/premium/delete-tidb-instance.md (1)

28-28: 🎯 Functional Correctness

The concern is refuted. 🔒 means “In private preview,” not unavailable; ❌ denotes “Currently not available.” The backup documentation also explicitly includes BYOC Recycle Bin backups and restoration instructions, so the BYOC wording on lines 28 and 36 is supported.

tidb-cloud/data-pipeline-lake-faq.md (1)

22-22: LGTM!

tidb-cloud/data-pipeline.md (1)

57-57: LGTM!

Also applies to: 65-65, 75-75, 86-86, 90-90, 107-107

tidb-cloud/premium/import-from-s3-premium.md (1)

2-2: LGTM!

Also applies to: 3-3, 6-6, 8-8, 17-17, 23-23, 28-28, 36-36, 40-40, 45-45, 55-55, 77-77

tidb-cloud/premium/premium-export.md (1)

2-2: LGTM!

Also applies to: 3-3, 6-6, 8-8, 10-10, 12-12, 18-18, 36-36, 103-103, 108-108, 129-129, 134-134, 153-153, 158-158, 179-179

tidb-cloud/premium/connect-to-premium-via-public-connection.md-3-3 (1)

3-3: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

⚠️ Unverified finding
Verification ran but could not confirm this finding. It is shown for review, not as a verified issue.

Add “instance” to the summary.

The summary says “your BYOC” without a noun. The title and introduction use “instance.”

summary: Learn how to connect to your {{{ .premium }}} or {{{ .byoc }}} instance via public connection.

As per path instructions: “For every actionable issue, provide a GitHub committable suggestion block containing the exact replacement text whenever the fix can be safely and completely applied to contiguous lines in the diff.”

Source: Path instructions


ℹ️ Review info
⚙️ Run configuration
  • Configuration used: Repository: pingcap/docs/.coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 120d35cf-eb49-4914-a03e-5c58c9050b1c
📥 Commits

Reviewing files that changed from the base of the PR and between 98a43e4 and 89ff1d8.

📒 Files selected for processing (21)
  • TOC-tidb-cloud-byoc.md
  • tidb-cloud/architecture-concepts.md
  • tidb-cloud/backup-and-restore-concepts.md
  • tidb-cloud/data-pipeline-lake-faq.md
  • tidb-cloud/data-pipeline.md
  • tidb-cloud/manage-projects-and-resources.md
  • tidb-cloud/premium/backup-and-restore-premium.md
  • tidb-cloud/premium/connect-to-premium-via-aws-private-endpoint.md
  • tidb-cloud/premium/connect-to-premium-via-public-connection.md
  • tidb-cloud/premium/connect-to-tidb-instance.md
  • tidb-cloud/premium/delete-tidb-instance.md
  • tidb-cloud/premium/import-csv-files-premium.md
  • tidb-cloud/premium/import-from-s3-premium.md
  • tidb-cloud/premium/import-with-mysql-cli-premium.md
  • tidb-cloud/premium/premium-export.md
  • tidb-cloud/premium/tidb-cloud-auditing-premium.md
  • tidb-cloud/select-cluster-tier.md
  • tidb-cloud/statement-insight.md
  • tidb-cloud/tidb-cloud-billing.md
  • tidb-cloud/tidb-cloud-intro.md
  • tidb-cloud/tidb-cloud-support.md
💤 Files with no reviewable changes (4)
  • tidb-cloud/tidb-cloud-billing.md
  • tidb-cloud/tidb-cloud-support.md
  • tidb-cloud/architecture-concepts.md
  • tidb-cloud/select-cluster-tier.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.

@@ -48,7 +56,7 @@ Because CSV files do not contain schema information, before importing data from

Each database schema file must be in the `${db_name}-schema-create.sql` format and contain a `CREATE DATABASE` DDL statement. With this file, {{{ .premium }}} will create the `${db_name}` database to store your data when you import the data.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

🔎 Supported by static analysis

🏁 Script executed:

git diff --unified=6 98a43e43b8d02b1c0a405d0332dadbd055612466 89ff1d8e083e01dcf562fc2107d11e8a9885d75c -- tidb-cloud/premium/import-csv-files-premium.md tidb-cloud/premium/import-with-mysql-cli-premium.md
nl -ba tidb-cloud/premium/import-csv-files-premium.md | sed -n '48,74p;80,105p;145,158p'
nl -ba tidb-cloud/premium/import-with-mysql-cli-premium.md | sed -n '8,24p'

Repository: pingcap/docs

Length of output: 27382


Make the remaining import scope explicit.

BYOC supports Amazon S3 imports, but not Alibaba Cloud OSS imports. Qualify the schema-file instructions by provider instead of adding BYOC unconditionally. The scan step is Amazon S3-only, so it should name both plans. Also update the prerequisite link and text.

Suggested CSV guide updates
-        Each database schema file must be in the `${db_name}-schema-create.sql` format and contain a `CREATE DATABASE` DDL statement. With this file, {{{ .premium }}} will create the `${db_name}` database to store your data when you import the data.
+        Each database schema file must be in the `${db_name}-schema-create.sql` format and contain a `CREATE DATABASE` DDL statement. With this file, {{{ .premium }}} will create the `${db_name}` database to store your data when you import the data. For imports from Amazon S3, {{{ .byoc }}} will also create the `${db_name}` database.
...
-        If you do not include the table schema files in the Amazon S3 or Alibaba Cloud Object Storage Service directory where the CSV files are located, {{{ .premium }}} will not create the corresponding tables for you when you import the data.
+        If you do not include the table schema files in the Amazon S3 or Alibaba Cloud Object Storage Service directory where the CSV files are located, {{{ .premium }}} will not create the corresponding tables for you when you import the data. For imports from Amazon S3, {{{ .byoc }}} will also not create the corresponding tables.
...
-        Each table schema file must be in the `${db_name}.${table_name}-schema.sql` format and contain a `CREATE TABLE` DDL statement. With this file, {{{ .premium }}} will create the `${table_name}` table in the `${db_name}` database when you import the data.
+        Each table schema file must be in the `${db_name}.${table_name}-schema.sql` format and contain a `CREATE TABLE` DDL statement. With this file, {{{ .premium }}} will create the `${table_name}` table in the `${db_name}` database when you import the data. For imports from Amazon S3, {{{ .byoc }}} will also create the `${table_name}` table.
...
-6. {{{ .premium }}} automatically scans the source path. Review the scan results, check the data files found and corresponding target tables, and then click **Start Import**.
+6. {{{ .premium }}} or {{{ .byoc }}} automatically scans the source path. Review the scan results, check the data files found and corresponding target tables, and then click **Start Import**.
Suggested MySQL CLI guide updates
-> - Logical imports are best suited for relatively small SQL or CSV files. For faster, parallel imports from cloud storage or to process multiple files from [Dumpling](https://docs.pingcap.com/tidb/stable/dumpling-overview) exports, see [Import CSV Files from Cloud Storage into {{{ .premium }}}](/tidb-cloud/premium/import-csv-files-premium.md).
+> - Logical imports are best suited for relatively small SQL or CSV files. For faster, parallel imports from cloud storage or to process multiple files from [Dumpling](https://docs.pingcap.com/tidb/stable/dumpling-overview) exports, see [Import CSV Files from Cloud Storage into {{{ .premium }}} or {{{ .byoc }}}](/tidb-cloud/premium/import-csv-files-premium.md).
...
-Before you can import data to a {{{ .premium }}} instance via the MySQL Command-Line Client, you need the following prerequisites:
+Before you can import data to a {{{ .premium }}} or {{{ .byoc }}} instance via the MySQL Command-Line Client, you need the following prerequisites:

Comment thread tidb-cloud/premium/import-csv-files-premium.md Outdated
Comment thread tidb-cloud/statement-insight.md
@coderabbitai

coderabbitai Bot commented Oct 12, 2026

Copy link
Copy Markdown

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

CodeRabbit commands

These commands are invoked using PR/Issue comments.

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai review --preview-config to test the unmerged CodeRabbit configuration on a draft PR. The requester must have repository write access; preview results are non-authoritative.
  • @coderabbitai rate limit to show your current review rate limit status.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai track in a human-authored review thread to track the original finding until CodeRabbit verifies it is fixed.
  • @coderabbitai fixed in a tracked review thread to verify the current code against the original finding.
  • @coderabbitai evaluate custom pre-merge check --instructions <custom-checks-instructions> --name <custom-checks-title> [--mode <error|warning>] to validate the custom pre-merge checks instructions. Defaults to error when --mode is omitted.
  • @coderabbitai ignore pre-merge checks to override pre-merge checks and get an approval on PR.
  • @coderabbitai run pre-merge checks to run pre-merge checks on the pull request.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai emit path instructions to emit generated path-specific review instructions for this repository.
  • @coderabbitai generate project vocabulary to list vocabulary that is specific to this repository.
  • @coderabbitai resolve merge conflict to automatically resolve merge conflicts.
  • @coderabbitai autofix to automatically fix issues in the current review thread, or all unresolved review comments when used in the PR conversation.
  • @coderabbitai autopilot to enable Autofix to fix CodeRabbit findings and required CI, and resolve merge conflicts.
  • @coderabbitai autopilot resume to resume Autofix for this PR.
  • @coderabbitai autopilot stop to stop Autofix for this PR.
  • @coderabbitai fix-ci to automatically fix failing CI checks in a stacked pull request.
  • @coderabbitai fix-ci commit to automatically fix failing CI checks by committing fixes to the current branch.
  • @coderabbitai resolve to resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai generate configuration to create a PR that adds the current resolved configuration as .coderabbit.yaml (or show it if already present).
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Status, support, documentation and community

  • Visit our status page to check the current availability of CodeRabbit.
  • Create a ticket on our support page for assistance with any issues or questions.
  • Visit our documentation site for detailed information on how to use CodeRabbit.
  • Join our Discord community to connect with other users and get help from the community.
  • Follow us on X/Twitter for updates and announcements.

Comment thread tidb-cloud/premium/backup-and-restore-premium.md
Comment thread tidb-cloud/premium/connect-to-premium-via-public-connection.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

Caution

Some comments are outside the diff and can’t be posted inline due to GitHub limitations.

⚠️ Outside diff range comments (1)

🟡 Minor · Provide a BYOC-specific IP access-list guide. · connect-to-premium-via-public-connection.md:25

tidb-cloud/premium/connect-to-premium-via-public-connection.md:25
🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Provide a BYOC-specific IP access-list guide.

The link sends BYOC readers to a guide that states it applies only to Premium and provides Premium-specific steps. Link to a BYOC-capable guide, or update the target guide's applicability and instructions to cover BYOC.

Source: Path instructions


ℹ️ Review info
⚙️ Run configuration
  • Configuration used: Repository: pingcap/docs/.coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 49caf26a-7d6b-4aeb-91a5-9f9876fdf685
📥 Commits

Reviewing files that changed from the base of the PR and between 89ff1d8 and b121dbc.

📒 Files selected for processing (6)
  • tidb-cloud/changefeed-overview.md
  • tidb-cloud/changefeed-sink-to-mysql.md
  • tidb-cloud/premium/backup-and-restore-premium.md
  • tidb-cloud/premium/connect-to-premium-via-public-connection.md
  • tidb-cloud/security-overview.md
  • tidb-cloud/tidb-cloud-log-redaction.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.

Comment thread tidb-cloud/changefeed-overview.md Outdated
Comment thread tidb-cloud/security-overview.md Outdated
Comment thread tidb-cloud/tidb-cloud-log-redaction.md
@ti-chi-bot ti-chi-bot Bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Oct 13, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 4


ℹ️ Review info
⚙️ Run configuration
  • Configuration used: Repository: pingcap/docs/.coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: b8e33e9f-f445-4cb4-83ab-00c78a91e713
📥 Commits

Reviewing files that changed from the base of the PR and between b121dbc and d5c04a6.

📒 Files selected for processing (13)
  • tidb-cloud/changefeed-overview.md
  • tidb-cloud/changefeed-sink-to-apache-kafka.md
  • tidb-cloud/changefeed-sink-to-mysql.md
  • tidb-cloud/premium/backup-and-restore-premium.md
  • tidb-cloud/premium/connect-to-premium-via-public-connection.md
  • tidb-cloud/premium/delete-tidb-instance.md
  • tidb-cloud/premium/import-csv-files-premium.md
  • tidb-cloud/premium/import-with-mysql-cli-premium.md
  • tidb-cloud/premium/premium-export.md
  • tidb-cloud/premium/set-up-sink-private-endpoint-premium.md
  • tidb-cloud/premium/tidb-cloud-auditing-premium.md
  • tidb-cloud/security-overview.md
  • tidb-cloud/tidb-cloud-log-redaction.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.

Comment thread tidb-cloud/premium/backup-and-restore-premium.md
Comment thread tidb-cloud/premium/connect-to-premium-via-public-connection.md
Comment thread tidb-cloud/premium/delete-tidb-instance.md
Comment thread tidb-cloud/premium/premium-export.md
This change expands the IP access list documentation to cover both Premium and BYOC instances. It clarifies the public endpoint requirements for BYOC deployments and updates the instructions to reflect the correct networking flow for enabling public access and adding allowed IPs.
github-actions Bot pushed a commit to lilin90/pingcap-docsite-preview that referenced this pull request Oct 14, 2026
@lilin90 lilin90 changed the title byoc: update custom and shared content byoc: update custom, shared, and release content Oct 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

BYOC Related to TiDB Cloud BYOC docs. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. translation/no-need No need to translate this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants