📚 Sync docs from alaudadevops/gitlab-ce-operator on d6630f97ce96c967898f7f3dbb36d2af1d23171b

Source: doc: enhance upgrade documentation with migration duration tips (#282)
Author: nanjingfm
Ref: refs/heads/release-17.8
Commit: d6630f97ce96c967898f7f3dbb36d2af1d23171b

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

🔗 View source commit: AlaudaDevops/gitlab-ce-operator@d6630f9
🤖 Synced on 2025-11-10 09:23:28 UTC

Author: nanjingfm

.github/SYNC_INFO.md

@@ -1,10 +1,10 @@
 # Documentation Sync Information
 
-- **Last synced**: 2025-11-07 07:15:32 UTC
+- **Last synced**: 2025-11-10 09:23:28 UTC
 - **Source repository**: alaudadevops/gitlab-ce-operator
-- **Source commit**: [bd825f948336c858eca03a26aad0ae17d2f54f96](https://github.com/alaudadevops/gitlab-ce-operator/commit/bd825f948336c858eca03a26aad0ae17d2f54f96)
+- **Source commit**: [d6630f97ce96c967898f7f3dbb36d2af1d23171b](https://github.com/alaudadevops/gitlab-ce-operator/commit/d6630f97ce96c967898f7f3dbb36d2af1d23171b)
 - **Triggered by**: nanjingfm
-- **Workflow run**: [#52](https://github.com/alaudadevops/gitlab-ce-operator/actions/runs/19161120278)
+- **Workflow run**: [#54](https://github.com/alaudadevops/gitlab-ce-operator/actions/runs/19226787347)
 
 ## Files synced:
 - docs/

docs/en/upgrade/02_14_upgrade_to_17.mdx

@@ -19,12 +19,6 @@ Versions 3.16 and 3.18 support GitLab versions that lag behind the official vers
 
 ## Process Overview
 
-:::warning
-The time required for the upgrade varies significantly depending on the size of the GitLab data. It may take several days to complete the upgrade, **so it's necessary to evaluate the maintenance window in advance**.
-
-Test data: Includes 3 projects (one large project of 666MB, 2 empty projects), backup file size of 668MB, upgrade time of 8 hours.
-:::
-
 ### Data Migration Path
 
 According to the [official upgrade path](https://gitlab-com.gitlab.io/support/toolbox/upgrade-path/?current=14.0.12&target=17.8.1&distro=docker&edition=ce) documentation, the data migration path is as follows:
@@ -58,6 +52,28 @@ Back up the `platform-deployed` GitLab and restore it to an `all-in-one` image d
 For the latest GitLab instance and operator versions, please refer to the [Release Note](../overview/release_notes.mdx).
 :::
 
+:::tip Migration Duration
+The migration process involves database and repository backup/restore operations:
+
+- Larger databases increase migration time.
+- A higher number of repositories or larger single repositories significantly extends the duration.
+- Storage performance also impacts efficiency — using topolvm is recommended for better performance.
+
+Test setup:
+
+- One large repository (~600 MB), others are small initial repositories
+- GitLab instance: 6,700 issues, 3,600 merge requests
+
+|Migration Step	| Key Factor	| 1,000 Repos	 |10,000 Repos|
+|----|---|---|---|
+|Back up platform-deployed GitLab 14.0.12	| Repo size & count	| 10 min	| 30 min|
+|Restore to all-in-one GitLab 14.0.12	|Repo size & count	| 20 min	| 1 hr|
+|Rolling upgrade to GitLab 17.8.1	| Database size	| 1 hr 30 min	| 1 hr 40 min|
+|Back up all-in-one GitLab 17.8.1	| Repo size & count	| 3 min	| 10 min|
+|Restore to platform-deployed GitLab | Repo size & count	| 30 min	| 1 hr|
+
+:::
+
 
 ## Prerequisites
 
@@ -332,7 +348,14 @@ For the latest GitLab instance and operator versions, please refer to the [Relea
 
       echo "Waiting for migrations to finish..."
       kubectl -n $GITLAB_NAMESPACE cp finalize_migrations.sql $new_pod_name:/tmp/finalize_migrations.sql
-      kubectl -n $GITLAB_NAMESPACE exec -ti $new_pod_name -- bash -c "gitlab-psql -t -A -f /tmp/finalize_migrations.sql > /tmp/run_migration_tasks.sh && bash -x /tmp/run_migration_tasks.sh"
+      for i in {1..3}; do
+        echo "Running migration tasks (attempt $i/3)..."
+        if kubectl -n $GITLAB_NAMESPACE exec -ti $new_pod_name -- bash -c "gitlab-psql -t -A -f /tmp/finalize_migrations.sql > /tmp/run_migration_tasks.sh && xargs -d \"\n\" -P 3 -I {} bash -c \"{}\" < /tmp/run_migration_tasks.sh"; then
+          echo "Migration tasks completed successfully"
+          break
+        fi
+        sleep 20
+      done
       bash monitor_gitlab.sh $new_pod_name
       echo "Upgraded to ${version} successfully"
       mark_done "$version"
@@ -550,10 +573,10 @@ For the latest GitLab instance and operator versions, please refer to the [Relea
                   protocol: TCP
               resources:
                 limits:
-                  cpu: "4"
+                  cpu: "8"
                   memory: 8Gi
                 requests:
-                  cpu: 2
+                  cpu: 4
                   memory: "4Gi"
               securityContext:
                 privileged: true
@@ -632,6 +655,22 @@ For the latest GitLab instance and operator versions, please refer to the [Relea
     kubectl -n $GITLAB_NAMESPACE cp all-in-one-gitlab-secrets.json $pod_name:/etc/gitlab/gitlab-secrets.json
     ```
 
+    Disable unnecessary components.
+
+    ```bash
+    cat <<EOF >> gitlab.rb
+    prometheus['enable'] = false
+    gitlab_kas['enable'] = false
+    redis_exporter['enable'] = false
+    gitlab_exporter['enable'] = false
+    postgres_exporter['enable'] = false
+    sidekiq['enable'] = false
+    EOF
+
+    # Copy the gitlab.rb to the pod
+    kubectl -n $GITLAB_NAMESPACE cp gitlab.rb $pod_name:/etc/gitlab/gitlab.rb
+    ```
+
     Restart the pod and wait for it to start up.
 
     ```bash