Add upgrade oam plugin docs

[zhhray]

Summary by CodeRabbit

• Documentation
  • Added comprehensive guide for upgrading the OAM Application Cluster Plugin, including webhook cleanup procedures, package upload workflow, and post-upgrade verification steps.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

A new documentation file is added providing end-to-end instructions for upgrading the OAM Application Cluster Plugin in ACP-managed clusters, including webhook cleanup procedures and the violet tool-based upgrade workflow.

Changes

Cohort / File(s)	Summary
Documentation: OAM Plugin Upgrade Guide docs/en/solutions/How_to_Upgrade_OAM_Application_Cluster_Plugin.md	New guide covering prerequisites, manual webhook cleanup (MutatingWebhookConfiguration and ValidatingWebhookConfiguration removal), and detailed upgrade workflow with violet tool, including backup procedures, plugin upload, upgrade execution, and post-upgrade verification steps.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Suggested reviewers

• fanzy618
• tyzhou111

Poem

🐰 A guide hops forth, with steps so clear,
To upgrade plugins without fear—
Webhooks cleaned, new packages in place,
ACP 4.2 embraces its grace! ✨

Pre-merge checks

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Add upgrade oam plugin docs' directly relates to the changeset, which introduces new documentation for upgrading the OAM Application Cluster Plugin.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

docs/en/solutions/How_to_Upgrade_OAM_Application_Cluster_Plugin.md (1)

154-158: Fix awkward verb repetition in upgrade instruction.

Line 156 reads "Click Upgrade to Upgrade on the plugin details page," which has redundant verb usage. Rephrase for clarity.

🔎 Proposed wording improvement

-1. Click **Upgrade** to Upgrade on the plugin details page.
+1. Click the **Upgrade** button on the plugin details page.

Alternatively:

-1. Click **Upgrade** to Upgrade on the plugin details page.
+1. Click **Upgrade** to proceed with the upgrade.

📜 Review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a033494 and a21336a.

📒 Files selected for processing (1)

• docs/en/solutions/How_to_Upgrade_OAM_Application_Cluster_Plugin.md

🔇 Additional comments (4)

docs/en/solutions/How_to_Upgrade_OAM_Application_Cluster_Plugin.md (4)

1-11: Clear document structure with appropriate frontmatter.

The introduction and prerequisites sections are well-organized and clearly communicate the scope and preconditions for the upgrade process.

---

37-130: Webhook cleanup procedures are detailed and well-structured.

The manual configuration update steps include clear backup commands, specific deletion scopes with YAML examples, and verification procedures. The explanation of why this action is necessary (lines 34-35) provides valuable context for administrators.

---

132-158: Upload and upgrade workflow is clear with well-documented commands.

The violet tool usage is explained with specific syntax and parameter descriptions, making it straightforward for administrators to follow. The file naming convention with version placeholder is appropriately documented.

---

160-173: Comprehensive post-upgrade verification ensures successful completion.

The verification procedures cover plugin state, pod health, and functional testing, providing administrators with concrete steps to confirm the upgrade success. The conclusion appropriately summarizes the upgrade outcome.

[jianliao82]

Log in => Login