chore: import upstream snapshot with attribution

2026-07-13 13:32:45 +08:00
commit e04ed9c211
1798 changed files with 307905 additions and 0 deletions
@@ -0,0 +1,40 @@
+---
+title: postgres-upgrade-precheck
+type: docs
+weight: 11
+description: Perform a pre-check for a Cloud SQL for PostgreSQL major version upgrade.
+---
+
+## About
+
+The `postgres-upgrade-precheck` tool initiates a pre-check on a Cloud SQL for PostgreSQL
+instance to assess its readiness for a major version upgrade using the Cloud SQL Admin API.
+It helps identify potential incompatibilities or issues before starting the actual upgrade process.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Example
+
+```yaml
+kind: tool
+name: postgres-upgrade-precheck
+type: postgres-upgrade-precheck
+source: cloud-sql-admin-source
+description: "Checks if a Cloud SQL PostgreSQL instance is ready for a major version upgrade to the specified target version."
+```
+
+## Reference
+
+| **field**    | **type** | **required** | **description**                                           |
+| ------------ | :------: | :----------: | --------------------------------------------------------- |
+| type         |  string  |     true     | Must be "postgres-upgrade-precheck". |
+| source       |  string  |     true     | The name of the `cloud-sql-admin` source to use.          |
+| description  |  string  |     false    | A description of the tool.                                |
+
+| **parameter**           | **type** | **required** | **description**                                                                 |
+| ----------------------- | :------: | :----------: | ------------------------------------------------------------------------------- |
+| project                 |  string  |     true     | The project ID containing the instance.                                         |
+| instance                    |  string  |     true     | The name of the Cloud SQL instance to check.                                    |
+| targetDatabaseVersion   |  string  |     false     | The target PostgreSQL major version for the upgrade (e.g., `POSTGRES_18`).  If not specified, defaults to the PostgreSQL 18. |