Support the PG hostpath storage solution

[SuJinpei]

Summary by CodeRabbit

• Documentation
  • Added a comprehensive guide for creating PostgreSQL instances using hostpath-backed persistent storage without external provisioners. Covers prerequisites, manual storage configuration, instance setup, high availability considerations, troubleshooting steps for common issues, and storage reusability guidance with practical configuration examples.

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

[coderabbitai]

Walkthrough

A new documentation file is added explaining how to create a PostgreSQL instance using hostpath PersistentVolume without an external provisioner, including StorageClass configuration, PV creation, Postgres manifest examples, troubleshooting guidance, and High Availability considerations.

Changes

Cohort / File(s)	Summary
Documentation docs/en/solutions/How_to_Create_a_Postgres_Instance_Using_Hostpath_PV_Without_an_External_Provisioner.md	New guide covering manual StorageClass setup, hostpath PV configuration with nodeAffinity, Postgres (Alauda/Spilo) manifest example, HA considerations, troubleshooting steps (pending pods, storageClass mismatches, capacity/permissions issues, admission webhooks), and PV lifecycle management with Retain policy implications.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Suggested reviewers

• tyzhou111
• sinbadonline

Poem

🐰 A guide to storage so fine and true,
Hostpath volumes, PersistentView,
Postgres dances on kubernetes ground,
With StorageClass magic, persistence is found! 📚✨

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 'Support the PG hostpath storage solution' directly relates to the main change, which is adding documentation about creating a PostgreSQL instance using hostpath PersistentVolumes.
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_Create_a_Postgres_Instance_Using_Hostpath_PV_Without_an_External_Provisioner.md (1)

10-14: Rephrase introduction to avoid repetitive sentence structures.

Three successive sentences begin with "This", which impacts readability. Consider reordering or rewording to improve clarity.

- # Create a PostgreSQL Instance Using Hostpath PV Without an External Provisioner
+ # Create a PostgreSQL Instance Using Hostpath PV Without an External Provisioner
  
  ## Introduction
  
- This guide explains how to configure an instance of Alauda support for PostgreSQL to store its data in a specific directory on your Kubernetes host machine. This is achieved by creating a manual `StorageClass` and a `PersistentVolume` (PV). This approach is useful when an external storage provisioner is not available.
+ This guide explains how to configure an instance of Alauda support for PostgreSQL to store its data in a specific directory on your Kubernetes host machine using a manual `StorageClass` and `PersistentVolume` (PV). When an external storage provisioner is not available, this approach provides a practical solution.

📜 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 9b79033.

📒 Files selected for processing (1)

• docs/en/solutions/How_to_Create_a_Postgres_Instance_Using_Hostpath_PV_Without_an_External_Provisioner.md

🧰 Additional context used

🪛 LanguageTool

docs/en/solutions/How_to_Create_a_Postgres_Instance_Using_Hostpath_PV_Without_an_External_Provisioner.md

[style] ~14-~14: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...geClassand aPersistentVolume` (PV). This approach is useful when an external sto...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: build

🔇 Additional comments (2)

docs/en/solutions/How_to_Create_a_Postgres_Instance_Using_Hostpath_PV_Without_an_External_Provisioner.md (2)

73-73: Verify that the external documentation link is still valid.

The guide references external Alauda documentation. Please confirm that the link on line 73 to "Create Instance" is current and accessible in your documentation system.

---

1-128: Comprehensive and well-structured documentation.

The guide is thorough and actionable, covering all essential aspects of setting up PostgreSQL with hostpath storage. The YAML examples are clear, the prerequisites section is practical, and the troubleshooting section addresses real-world issues including permission handling, admission webhooks, and node affinity constraints. The warning about single-instance deployments for hostpath storage is appropriately placed. Great work on this guide.