Skip to content

Commit 026a577

Browse files
hoennlecoursen
andauthored
Enterprise Live Migrations: Add warning about partial support for migration branch protection rules (#62792)
Co-authored-by: Laura Coursen <lecoursen@github.com>
1 parent 8e29bf4 commit 026a577

1 file changed

Lines changed: 7 additions & 3 deletions

File tree

‎content/migrations/elm/migrated-data-reference.md‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,12 @@ The only organization-level action supported by {% data variables.product.prodna
2727
| Repository PR settings | Pull request merge and review settings |
2828
| Actions settings | Repository-level GitHub Actions configuration, including allowed actions and permissions |
2929
| Autolinks | Custom autolink references |
30-
| Branch protections | Branch protection rules |
30+
| Branch protections | Branch protection rules are partially migrated, with the limitations described below |
3131
| Pages | GitHub Pages configuration |
3232

33+
> [!WARNING]
34+
> Branch protection migration is partially supported. {% data variables.product.prodname_elm_short %} preserves whether actor restrictions are enabled for dismissing pull request reviews and pushing to protected branches, but it does not preserve the permitted users, teams, or apps. A push restriction can therefore be recreated on the destination with an empty allowlist. It also does not migrate pull request bypass actors, force-push actors, status check app bindings, matching-branch creation restrictions, merge queue settings, deployment requirements, or branch locking. Review and update migrated branch protection rules before allowing users to work in the destination repository.
35+
3336
### Git data, LFS, and wikis
3437

3538
| Resource | Notes |
@@ -96,7 +99,7 @@ The only organization-level action supported by {% data variables.product.prodna
9699
| Data | Notes |
97100
|---|---|
98101
| Repository defaults | N/A |
99-
| Repository rulesets | Only branch protection rules are migrated. |
102+
| Repository rulesets | Repository rulesets are not migrated. Branch protection rules are partially migrated. |
100103
| Pull requests from forks | N/A |
101104
| Pending pull request reviews | Only submitted reviews are migrated. |
102105

@@ -127,7 +130,7 @@ The following tables document which resource types support live updates and whic
127130
| **Label** | `created` | `deleted`, `edited` |
128131
| **Release** | `created`, `edited`, `prereleased`, `published`, `released`, `unpublished` | `deleted` |
129132
| **Milestone** | `closed`, `created`, `edited`, `opened` | `deleted` |
130-
| **Branch protection rule** | `created`, `edited` | `deleted` |
133+
| **Branch protection rule (partial support)** | `created`, `edited` | `deleted` |
131134
| **Commit comment** | `created`, `edited` | `deleted` |
132135
| **Page build** | All actions | N/A |
133136
| **Commit status checks** | All actions | N/A |
@@ -138,6 +141,7 @@ The following tables document which resource types support live updates and whic
138141
| **Repository actions settings** | `updated` | N/A |
139142
| **Repository webhook** | `created`, `updated` | N/A |
140143

144+
The branch protection limitations described in [Repository settings and configuration](#repository-settings-and-configuration) apply to both the initial migration and live updates.
141145

142146
> [!NOTE]
143147
> When a pull request review is submitted, {% data variables.product.prodname_elm_short %} imports the full review including all inline comments together. Inline comments that are part of an initial review submission are migrated correctly. However, **replies added to a review thread after the review has been submitted** are not captured as live updates and will not appear in the migrated repository.

0 commit comments

Comments
 (0)