📚 Sync docs from alaudadevops/gitlab-ce-operator on 48a5965a597e95f32a1463bdd22f5450584e448b

Source: docs(upgrade): add ARM image links and upgrade script improvements (#270)
Author: nanjingfm
Ref: refs/heads/release-18.2
Commit: 48a5965a597e95f32a1463bdd22f5450584e448b

This commit automatically syncs documentation changes from the source-docs repository.

🔗 View source commit: https://github.com/alaudadevops/gitlab-ce-operator/commit/48a5965a597e95f32a1463bdd22f5450584e448b
🤖 Synced on 2025-11-07 06:57:51 UTC

Author: edge-katanomi-app2[bot]

.github/SYNC_INFO.md

@@ -1,10 +1,10 @@
 # Documentation Sync Information
 
-- **Last synced**: 2025-11-04 05:51:42 UTC
+- **Last synced**: 2025-11-07 06:57:51 UTC
 - **Source repository**: alaudadevops/gitlab-ce-operator
-- **Source commit**: [31bc01dcba1d99f06da68d23e9e3fd6ed9b8f18e](https://github.com/alaudadevops/gitlab-ce-operator/commit/31bc01dcba1d99f06da68d23e9e3fd6ed9b8f18e)
-- **Triggered by**: nanjingfm
-- **Workflow run**: [#46](https://github.com/alaudadevops/gitlab-ce-operator/actions/runs/19059216700)
+- **Source commit**: [48a5965a597e95f32a1463bdd22f5450584e448b](https://github.com/alaudadevops/gitlab-ce-operator/commit/48a5965a597e95f32a1463bdd22f5450584e448b)
+- **Triggered by**: edge-katanomi-app2[bot]
+- **Workflow run**: [#50](https://github.com/alaudadevops/gitlab-ce-operator/actions/runs/19160759813)
 
 ## Files synced:
 - docs/

docs/en/upgrade/02_14_upgrade_to_17.md renamed to docs/en/upgrade/02_14_upgrade_to_17.mdx

@@ -143,22 +143,76 @@ Test setup:
 
 4. Prepare the images needed for the upgrade. Download each version of the image from the attachments and push them to an image repository that the GitLab deployment cluster can pull from. Image download links:
 
-    ```shell
-    # amd images
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-0-12-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-3-6-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-9-5-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-10-5-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-0-5-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-4-6-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-11-13-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-3-8-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-7-9-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-11-10-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-3-6-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-5-5-amd.tgz
-    https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-8-1-amd.tgz
-    ```
+    <Tabs>
+      <Tab label="China Region">
+        ```shell
+        # amd images
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-0-12-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-3-6-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-9-5-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-10-5-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-0-5-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-4-6-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-11-13-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-3-8-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-7-9-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-11-10-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-3-6-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-5-5-amd.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-8-1-amd.tgz
+
+        # arm images
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-0-12-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-3-6-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-9-5-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-14-10-5-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-0-5-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-4-6-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-15-11-13-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-3-8-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-7-9-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-16-11-10-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-3-6-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-5-5-arm.tgz
+        https://cloud.alauda.cn/attachments/knowledge/242090509/gitlab-ce-17-8-1-arm.tgz
+        ```
+      </Tab>
+
+      <Tab label="Other Regions">
+        ```shell
+        # amd images
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-0-12-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-3-6-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-9-5-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-10-5-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-15-0-5-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-15-4-6-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-15-11-13-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-16-3-8-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-16-7-9-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-16-11-10-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-17-3-6-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-17-5-5-amd.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-17-8-1-amd.tgz
+
+        # arm images
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-0-12-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-3-6-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-9-5-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-14-10-5-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-15-0-5-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-15-4-6-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-15-11-13-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-16-3-8-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-16-7-9-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-16-11-10-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-17-3-6-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-17-5-5-arm.tgz
+        https://cloud.alauda.io/attachments/knowledge/242090509/gitlab-ce-17-8-1-arm.tgz
+        ```
+      </Tab>
+    </Tabs>
+
 
 5. Prepare the scripts needed for the upgrade.
 
@@ -261,7 +315,23 @@ Test setup:
       17.8.1-ce.0
     )
 
+    STATE_FILE="upgrade_state.log"
+    touch "$STATE_FILE"
+
+    is_done() {
+      grep -Fxq "$1" "$STATE_FILE"
+    }
+
+    mark_done() {
+      echo "$1" >> "$STATE_FILE"
+    }
+
     for version in "${versions[@]}"; do
+      if is_done "$version"; then
+        echo "Version ${version} already processed, skipping..."
+        continue
+      fi
+
       echo "Upgrading to ${version}..."
       new_image="${image%:*}:${version}"
       kubectl -n $GITLAB_NAMESPACE set image deployment/gitlab gitlab=$new_image
@@ -288,7 +358,10 @@ Test setup:
       done
       bash monitor_gitlab.sh $new_pod_name
       echo "Upgraded to ${version} successfully"
+      mark_done "$version"
     done
+
+    echo "All upgrades completed successfully!"
     EOF
     ```
 
@@ -436,13 +509,12 @@ Test setup:
 
     ```bash
     export NODE_IP=<node_ip>
+    export GITLAB_IMAGE=<registry-host>/gitlab/gitlab-ce:14.0.12-ce.0
     ```
 
     Create the `all-in-one` GitLab instance.
 
     ```bash
-    export GITLAB_IMAGE=<registry-host>/gitlab/gitlab-ce:14.0.12-ce.0
-
     kubectl apply -f - <<EOF
     apiVersion: v1
     kind: Service
@@ -921,9 +993,15 @@ The namespace of the new gitlab instance must be the same as the namespace of th
 
 1. The migrated data does not include avatars and attachments, so the new GitLab instance cannot display this content. To resolve this issue, you can replace the upload PVC of GitLab 17.8.z with the PVC used by 14.0.12.
 
+    Set the environment variable for the uploads pvc name:
+
     ```bash
     export UPLOADS_PVC_NAME=<name of the uploads pvc>
+    ```
 
+    Patch the new GitLab instance to use the uploads PVC:
+
+    ```bash
     kubectl patch gitlabofficials.operator.alaudadevops.io ${NEW_GITLAB_NAME} -n $GITLAB_NAMESPACE --type='json' -p='
     {
       "spec": {