## Summary Roll out Vue 3 (compatibility mode) on every page entry and global bundle that was not migrated with its own flag. The `vue3_migrate_final_sweep` feature flag controls it. This is part of the [Vue 3 migration epic](https://gitlab.com/groups/gitlab-org/-/epics/23285). - DRI: `mrincon` - Flag: `vue3_migrate_final_sweep` (beta, `default_enabled: false`), owned by `group::pipeline authoring`. The actor is the current user. - MR: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/261154 The flag covers 206 page entries and 3 global bundles in one step. The MR adds the files for the state of master and of the open MRs at the cutoff, 2026-10-26 00:00 UTC. A team that migrates its own page later replaces the final sweep flag in that page's `vue3_migration.yml` with its own flag. > [!note] > Process and guidance live in the docs. This issue holds the commands and tracks the rollout. > [Feature flag controls](https://docs.gitlab.com/development/feature_flags/controls/) · [Feature flag lifecycle](https://handbook.gitlab.com/handbook/product-development/how-we-work/product-development-flow/feature-flag-lifecycle/#feature-flag-lifecycle) ## What could go wrong? - The blast radius is large. One flag switches every page in scope, so a rollback switches all of them back to Vue 2. - When one page breaks, do not keep the whole flag off for it. In a follow-up MR, give that page its own flag or remove its `vue3_migration.yml`. Then turn the final sweep flag on again. - A page that has a bundle with no Vue 3 variant falls back to Vue 2. The helper reports this once per process as `Gitlab::Webpack::Manifest::AssetMissingError` with `vue3_entrypoint` set. - Under `@vue/compat`, a `Vue.use()` in one Vue 3 bundle reaches every app created after it on the page. A page that misses its own plugin install can work by accident. Check every page state in the browser console: ```js [...document.querySelectorAll('[data-gitlab-vue3-app]')].map((el) => el.dataset.gitlabVue3App); ``` ## Events - [Exceptions with vue3_migrate_final_sweep:1](https://log.gprd.gitlab.net/app/discover#/?_g=(time:(from:now-1d,to:now))&_a=(index:'7092c4e2-4eb5-46f2-8305-a7da2edad090',query:(language:kuery,query:'json.exception.feature_flag_states.keyword:%22vue3_migrate_final_sweep:1%22'),columns:!(json.exception.class,json.exception.message,json.extra.workflow_id,json.meta.caller_id),sort:!(!(json.time,desc)))) - [Events with vue3_migrate_final_sweep:1](https://log.gprd.gitlab.net/app/discover#/?_g=(time:(from:now-1d,to:now))&_a=(index:'7092c4e2-4eb5-46f2-8305-a7da2edad090',query:(language:kuery,query:'json.feature_flag_states:%22vue3_migrate_final_sweep:1%22'),columns:!(json.meta.caller_id,json.feature_flag_states),sort:!(!(json.time,desc)))) - [Error rate and other graphs by modifying the examples in the Visualization Library](https://log.gprd.gitlab.net/app/visualize#/?_g=h@358d019&s=FF%20Observability) ## Rollout Run all production `/chatops` in [`#production`](https://gitlab.slack.com/archives/C101F3796). Background: [incremental rollout process](https://docs.gitlab.com/development/feature_flags/controls/#process), [feature actors](https://docs.gitlab.com/development/feature_flags/#feature-actors). Do the steps in this order. After each production step, wait at least 15 minutes and look at the events above before you go to the next step. - [x] **Step 1: all non-production environments.** ``` /chatops gitlab run feature set vue3_migrate_final_sweep true --dev --pre --staging --staging-ref ``` - [x] **Step 2: production, `mrincon` only.** ``` /chatops gitlab run feature set --user=mrincon vue3_migrate_final_sweep true ``` - [x] **Step 3: production, `ntepluhina`, `mrincon`, `xanf`, `markrian`, `slashmanov` and `pburdette`.** ``` /chatops gitlab run feature set --user=ntepluhina,mrincon,xanf,markrian,slashmanov,pburdette vue3_migrate_final_sweep true ``` - [ ] **Step 4: production, all GitLab team members.** ``` /chatops gitlab run feature set --feature-group=gitlab_team_members vue3_migrate_final_sweep true ``` - [ ] **Step 5: production, a percentage of users.** Do the percentages in this order. - [ ] 10% ``` /chatops gitlab run feature set vue3_migrate_final_sweep 10 --actors ``` - [ ] 25% ``` /chatops gitlab run feature set vue3_migrate_final_sweep 25 --actors ``` - [ ] 50% ``` /chatops gitlab run feature set vue3_migrate_final_sweep 50 --actors ``` - [ ] **Step 6: production, all of GitLab.com.** Do the [Before global rollout](#before-global-rollout) checks first. ``` /chatops gitlab run feature set vue3_migrate_final_sweep true ``` ## Before global rollout See [enabling a feature for GitLab.com](https://docs.gitlab.com/development/feature_flags/controls/#enabling-a-feature-for-gitlabcom): - [Change management issue](https://handbook.gitlab.com/handbook/engineering/infrastructure-platforms/change-management/#feature-flags-and-the-change-management-process) opened, if required. This flag touches most pages. ## Cleanup After the flag is at 100% and stable: - [ ] Change every yml with `feature_flag: vue3_migrate_final_sweep` to `status: migrated` and remove the `feature_flag` line. - [ ] Remove `config/feature_flags/beta/vue3_migrate_final_sweep.yml`. ``` /chatops gitlab run release check <merge-request-url> <milestone> /chatops gitlab run feature delete vue3_migrate_final_sweep --dev --pre --staging --staging-ref --production ``` ## Rollback ``` /chatops gitlab run feature set vue3_migrate_final_sweep false /chatops gitlab run feature set vue3_migrate_final_sweep false --dev --pre --staging --staging-ref ``` <!-- claude session=bcfd8c5e-0d97-449b-8e92-50878fa6a3b6 posted=2026-10-26T11:05:00Z edited=2026-10-26T11:15:00Z --> <!-- claude session=3a29ce1a-34f5-4130-a179-9df7cb7e304c posted=2026-10-27T08:22:42Z -->