danhuawang commented on code in PR #11121: URL: https://github.com/apache/gravitino/pull/11121#discussion_r3256128490
########## docs/how-to-upgrade.md: ########## @@ -132,4 +139,52 @@ upgraded schema, e.g. if you upgraded the schema to Gravitino 0.8.0 then you will want to compare your schema dump against the contents of `schema-0.8.0-<type>.sql` +## Upgrading via Helm Chart + +:::note +The Gravitino Helm chart does not currently support automatic schema migration. Before running +`helm upgrade`, you must manually back up your database (see [Step 2](#step-2-backup-your-gravitino-instance)) +and apply the appropriate SQL upgrade scripts (see [Step 5](#step-5-apply-the-upgrade-scripts)). +::: + +This section describes how to upgrade a Gravitino deployment managed by the Gravitino Helm chart + +### Step 1: Prepare the new values file + +Create a new values file for the target version (e.g., `values-1.3.0.yaml`) based on the +previous one. Apply the following changes compared to `values-1.2.0.yaml`: + +| Field | 1.2.0 | 1.3.0 | Review Comment: Fixed. Two changes to make the Helm upgrade section version-agnostic: Step 1: Replaced hardcoded version numbers and filenames with <new-version> placeholders. Version-specific field changes are kept under a #### 1.2.0 → 1.3.0 subsection so future versions only need a new subsection appended. Step 2: Replaced the hardcoded chart filename, namespace, and values filename with <new-version> and <namespace> placeholders. The #### 1.2.0 → 1.3.0 subsection is retained because the GRAVITINO_HOME path change is a breaking change that operators must not miss. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
