Skip to content

Fix/update vpa docs master#754

Open
zhhray wants to merge 3 commits intomasterfrom
fix/update-vpa-docs-master
Open

Fix/update vpa docs master#754
zhhray wants to merge 3 commits intomasterfrom
fix/update-vpa-docs-master

Conversation

@zhhray
Copy link
Copy Markdown
Contributor

@zhhray zhhray commented May 8, 2026

Summary by CodeRabbit

  • Documentation
    • Reorganized VerticalPodAutoscaler documentation with improved structure and clearer explanations of CPU/memory recommendations
    • Added prerequisites section with monitoring component guidance and CLI workflow reference
    • Enhanced plugin installation and upgrade instructions via platform UI
    • Updated Web Console login and navigation steps

zhhray and others added 2 commits May 8, 2026 16:36
Co-authored-by: huizhang <huizhang@alauda.io>
(cherry picked from commit 97717e8)
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 8, 2026

Review Change Stack

Walkthrough

This PR reorganizes and expands the VPA documentation guide with improved structure, clearer conceptual explanations, and enhanced prerequisite guidance. The Overview section now explains VPA's recommendation and application workflow, Prerequisites include monitoring setup and CLI reference, and installation steps are explicitly documented with UI and upgrade paths.

Changes

VPA Documentation Restructuring

Layer / File(s) Summary
Overview and Conceptual Foundation
docs/en/developer/building_application/operation_maintaining/add_vpa.mdx
Introductory sections replaced with structured Overview and Understanding VerticalPodAutoscalers sections. Clarified how VPA recommends and optionally applies CPU/memory requests and limits based on historical pod usage monitoring.
Features, Prerequisites, and Installation Guidance
docs/en/developer/building_application/operation_maintaining/add_vpa.mdx
Elastic scaling warning rewritten. Supported Features section added. Prerequisites expanded to include monitoring components and health checks. Plugin installation and upgrade steps documented via platform UI, including violet CLI workflow reference.
User Instructions
docs/en/developer/building_application/operation_maintaining/add_vpa.mdx
Web Console usage instructions refined. First step updated to "Log in and navigate to the Container Platform."

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

A guide reborn, clear as spring breeze, 🐰
VPA concepts flow with ease,
Prerequisites mapped, steps all bright,
Console paths now shown just right,
Users navigate with gentle sight.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Fix/update vpa docs master' is vague and uses generic terms that don't clearly convey the specific changes made to the VPA documentation. Consider using a more descriptive title that specifies the main changes, such as 'Reorganize and expand VPA documentation with clearer explanations and updated prerequisites' or 'Update VPA documentation structure and add prerequisites guidance'.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/update-vpa-docs-master

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
Contributor

@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: 1

🧹 Nitpick comments (1)
docs/en/developer/building_application/operation_maintaining/add_vpa.mdx (1)

39-53: ⚡ Quick win

Prerequisites sub-bullets contradict the Installing section below.

The prerequisite at line 40 states the plugin must already be installed, but lines 41–42 then describe the installation actions (download, upload via violet). This duplicates and conflicts with the dedicated Installing the Vertical Pod Autoscaler Plugin section (lines 46–53). As written, users are given partial install instructions buried in a checklist, then full UI-based install instructions immediately after.

Consider restructuring so that the prerequisite simply states "the plugin must be installed" and points readers to the Installing section, rather than embedding upload steps inline.

✏️ Proposed restructure
 ## Prerequisites
 Before using VPA, ensure the following:
 - The **Alauda Container Platform Vertical Pod Autoscaler** cluster plugin is installed in your cluster.
-  - Download the latest plugin package compatible with your platform version.
-  - Utilize the `violet` CLI tool to upload **Alauda Container Platform Vertical Pod Autoscalers** and **Alauda DevOps Pipelines** packages to your target cluster. For detailed instructions on using `violet`, please refer to the [CLI](/ui/cli_tools/index.mdx).
+  If not yet installed, see [Installing the Vertical Pod Autoscaler Plugin](`#installing-the-vertical-pod-autoscaler-plugin`) below.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/en/developer/building_application/operation_maintaining/add_vpa.mdx`
around lines 39 - 53, The prerequisites section ("Before using VPA") currently
embeds partial install steps that conflict with the later "Installing the
Vertical Pod Autoscaler Plugin" section; remove the download/upload bullets and
replace them with a single line stating that the "Alauda Container Platform
Vertical Pod Autoscaler cluster plugin" must be installed and link or point
readers to the "Installing the Vertical Pod Autoscaler Plugin" section for UI
and violet CLI upload instructions (leave the monitoring deployment bullet
as-is).
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/en/developer/building_application/operation_maintaining/add_vpa.mdx`:
- Around line 40-42: The paragraph mentioning the VPA prerequisite incorrectly
includes a reference to the "Alauda DevOps Pipelines" package; remove that
copy-paste error so the bullet reads only about downloading the VPA plugin and
uploading the VPA package with the `violet` CLI. Update the second bullet to
mention only "Alauda Container Platform Vertical Pod Autoscalers" (and the
`violet` CLI) and delete the "Alauda DevOps Pipelines" phrase; keep the `violet`
CLI link to the CLI docs unchanged for usage guidance.

---

Nitpick comments:
In `@docs/en/developer/building_application/operation_maintaining/add_vpa.mdx`:
- Around line 39-53: The prerequisites section ("Before using VPA") currently
embeds partial install steps that conflict with the later "Installing the
Vertical Pod Autoscaler Plugin" section; remove the download/upload bullets and
replace them with a single line stating that the "Alauda Container Platform
Vertical Pod Autoscaler cluster plugin" must be installed and link or point
readers to the "Installing the Vertical Pod Autoscaler Plugin" section for UI
and violet CLI upload instructions (leave the monitoring deployment bullet
as-is).
🪄 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: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 630f062c-b321-4047-b42a-764670881609

📥 Commits

Reviewing files that changed from the base of the PR and between 355aec7 and e4affa6.

📒 Files selected for processing (1)
  • docs/en/developer/building_application/operation_maintaining/add_vpa.mdx

Comment on lines +40 to +42
- The **Alauda Container Platform Vertical Pod Autoscaler** cluster plugin is installed in your cluster.
- Download the latest plugin package compatible with your platform version.
- Utilize the `violet` CLI tool to upload **Alauda Container Platform Vertical Pod Autoscalers** and **Alauda DevOps Pipelines** packages to your target cluster. For detailed instructions on using `violet`, please refer to the [CLI](/ui/cli_tools/index.mdx).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

"Alauda DevOps Pipelines" package requirement appears to be a copy-paste error.

Line 42 instructs users to upload both Alauda Container Platform Vertical Pod Autoscalers and Alauda DevOps Pipelines packages via the violet CLI as part of the VPA prerequisites. Including DevOps Pipelines as a dependency for VPA is unexpected and is likely carried over from an unrelated workflow. Please confirm whether this is intentional or remove the DevOps Pipelines reference.

✏️ Proposed fix
-  - Utilize the `violet` CLI tool to upload **Alauda Container Platform Vertical Pod Autoscalers** and **Alauda DevOps Pipelines** packages to your target cluster. For detailed instructions on using `violet`, please refer to the [CLI](/ui/cli_tools/index.mdx).
+  - Utilize the `violet` CLI tool to upload the **Alauda Container Platform Vertical Pod Autoscalers** package to your target cluster. For detailed instructions on using `violet`, please refer to the [CLI](/ui/cli_tools/index.mdx).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- The **Alauda Container Platform Vertical Pod Autoscaler** cluster plugin is installed in your cluster.
- Download the latest plugin package compatible with your platform version.
- Utilize the `violet` CLI tool to upload **Alauda Container Platform Vertical Pod Autoscalers** and **Alauda DevOps Pipelines** packages to your target cluster. For detailed instructions on using `violet`, please refer to the [CLI](/ui/cli_tools/index.mdx).
- The **Alauda Container Platform Vertical Pod Autoscaler** cluster plugin is installed in your cluster.
- Download the latest plugin package compatible with your platform version.
- Utilize the `violet` CLI tool to upload the **Alauda Container Platform Vertical Pod Autoscalers** package to your target cluster. For detailed instructions on using `violet`, please refer to the [CLI](/ui/cli_tools/index.mdx).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/en/developer/building_application/operation_maintaining/add_vpa.mdx`
around lines 40 - 42, The paragraph mentioning the VPA prerequisite incorrectly
includes a reference to the "Alauda DevOps Pipelines" package; remove that
copy-paste error so the bullet reads only about downloading the VPA plugin and
uploading the VPA package with the `violet` CLI. Update the second bullet to
mention only "Alauda Container Platform Vertical Pod Autoscalers" (and the
`violet` CLI) and delete the "Alauda DevOps Pipelines" phrase; keep the `violet`
CLI link to the CLI docs unchanged for usage guidance.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 8, 2026

Deploying alauda-container-platform with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7b88add
Status: ✅  Deploy successful!
Preview URL: https://6b8989dd.alauda-container-platform.pages.dev
Branch Preview URL: https://fix-update-vpa-docs-master.alauda-container-platform.pages.dev

View logs

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant