1
0
mirror of synced 2025-12-19 09:57:42 -05:00

Update documentation to reflect increases in GEI's repository size limits and the impacted reusable docs elements (#55883)

Co-authored-by: Felicity Chapman <felicitymay@github.com>
This commit is contained in:
Jim Boyle
2025-06-03 13:39:14 -04:00
committed by GitHub
parent 1601b7d335
commit 75d53ed833
8 changed files with 29 additions and 17 deletions

View File

@@ -142,7 +142,13 @@ When you migrate a repository directly, teams and team access to repositories ar
## Limitations on migrated data
{% data reusables.enterprise-migration-tool.limitations-of-migrated-data %}
{% data reusables.enterprise-migration-tool.limitations-of-dotcom %}
### Limitations of {% data variables.product.prodname_importer_proper_name %}
* {% data reusables.enterprise-migration-tool.git-repo-size-limit %}
* **40 GB limit for metadata ({% data variables.release-phases.public_preview %}):** The {% data variables.product.prodname_importer_secondary_name %} cannot migrate repositories with more than 40 GB of metadata. Metadata includes issues, pull requests, releases, and attachments. In most cases, large metadata is caused by binary assets attached to releases. You can exclude releases from the migration with the `migrate-repo` command's `--skip-releases` flag, and then move your releases manually after the migration.
{% data reusables.enterprise-migration-tool.limitations-of-migration-tooling %}
## Getting started

View File

@@ -29,7 +29,12 @@ If you want to migrate Azure Pipelines to {% data variables.product.prodname_act
## Limitations on migrated data
{% data reusables.enterprise-migration-tool.limitations-of-migrated-data %}
{% data reusables.enterprise-migration-tool.limitations-of-dotcom %}
### Limitations of {% data variables.product.prodname_importer_proper_name %}
* {% data reusables.enterprise-migration-tool.git-repo-size-limit %}
{% data reusables.enterprise-migration-tool.limitations-of-migration-tooling %}
## Getting started

View File

@@ -34,7 +34,12 @@ Currently, the following data is **not** migrated.
## Limitations on migrated data
{% data reusables.enterprise-migration-tool.limitations-of-migrated-data %}
{% data reusables.enterprise-migration-tool.limitations-of-dotcom %}
### Limitations of {% data variables.product.prodname_importer_proper_name %}
* **40 GB size limit for repository archives ({% data variables.release-phases.public_preview %}):** The {% data variables.product.prodname_importer_secondary_name %} cannot migrate repositories with more than 40 GB of combined git data and metadata in the repository archive.
{% data reusables.enterprise-migration-tool.limitations-of-migration-tooling %}
## Getting started

View File

@@ -0,0 +1 @@
**40 GB size limit for a Git repository ({% data variables.release-phases.public_preview %}):** This limit applies only to the source code. To check if the repository archive is over the limit, use the [git-sizer](https://github.com/github/git-sizer) tool and review the total blob size in the output. The git-sizer tool also helps to identify potential issues related to large files, blob size, commit size, and tree counts that could impact migrations.

View File

@@ -0,0 +1,7 @@
There are limits to what {% data variables.product.prodname_importer_proper_name %} can migrate. Some are due to limitations of {% data variables.product.prodname_dotcom %}, while others are limitations of {% data variables.product.prodname_importer_proper_name %} itself.
### Limitations of {% data variables.product.prodname_dotcom %}
* **2 GB size limit for a single Git commit:** No single commit in your Git repository can be larger than 2 GB. If any of your commits are larger than 2 GB, you will need to split the commit into smaller commits that are each 2 GB or smaller.
* **255 byte limit for Git references:** No single [Git reference](https://git-scm.com/book/en/v2/Git-Internals-Git-References), commonly known as a "ref", can have a name larger than 255 bytes. Usually, this means that your references cannot be more than 255 characters long, but any non-[ASCII](https://en.wikipedia.org/wiki/ASCII) characters, such as emojis, may consume more than one byte. If any of your Git references are too large, we'll return a clear error message.
* **100 MB file size limit:** After you complete your migration, no single file in your Git repository can be larger than 100 MB. During repository migration this limit is increased to 400 MB. Consider using {% data variables.large_files.product_name_short %} to store large files. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files).

View File

@@ -1,15 +1,3 @@
There are limits to what {% data variables.product.prodname_importer_proper_name %} can migrate. Some are due to limitations of {% data variables.product.prodname_dotcom %}, while others are limitations of {% data variables.product.prodname_importer_proper_name %} itself.
### Limitations of {% data variables.product.prodname_dotcom %}
* **2 GB size limit for a single Git commit:** No single commit in your Git repository can be larger than 2 GB. If any of your commits are larger than 2 GB, you will need to split the commit into smaller commits that are each 2 GB or smaller.
* **255 byte limit for Git references:** No single [Git reference](https://git-scm.com/book/en/v2/Git-Internals-Git-References), commonly known as a "ref", can have a name larger than 255 bytes. Usually, this means that your references cannot be more than 255 characters long, but any non-[ASCII](https://en.wikipedia.org/wiki/ASCII) characters, such as emojis, may consume more than one byte. If any of your Git references are too large, we'll return a clear error message.
* **100 MB file size limit:** After you complete your migration, no single file in your Git repository can be larger than 100 MB. This limit is increased to 400 MB when migrating a repository. Consider using {% data variables.large_files.product_name_short %} for storing large files. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files).
### Limitations of {% data variables.product.prodname_importer_proper_name %}
* **20 GB size limit for a Git repository:** This limit only applies to the source code. To check if the repository archive is over the limit, use the [git-sizer](https://github.com/github/git-sizer) tool and review the total blob size in the output. The git-sizer tool also helps to identify potential issues related to large files, blob size, commit size, and tree counts that could impact migrations.
* **20 GB limit for metadata:** The {% data variables.product.prodname_importer_secondary_name %} cannot migrate repositories with more than 20 GB of metadata. Metadata includes issues, pull requests, releases, and attachments. In most cases, large metadata is caused by binary assets attached to releases. You can exclude releases from the migration with the `migrate-repo` command's `--skip-releases` flag, and then move your releases manually after the migration.
* **400 MB file size limit:** When migrating a repository with {% data variables.product.prodname_importer_proper_name %}, no single file in your Git repository can be larger than 400 MB. Consider using {% data variables.large_files.product_name_short %} for storing large files. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files).
* **{% data variables.large_files.product_name_short %} objects not migrated:** The {% data variables.product.prodname_importer_secondary_name %} can migrate repositories that use {% data variables.large_files.product_name_short %}, but the LFS objects themselves will not be migrated. They can be pushed to your migration destination as a follow-up task after the migration is complete. For more information, see [AUTOTITLE](/repositories/creating-and-managing-repositories/duplicating-a-repository#mirroring-a-repository-that-contains-git-large-file-storage-objects).
* **Follow-up tasks required:** When migrating between {% data variables.product.prodname_dotcom %} products, certain settings are not migrated and must be reconfigured in the new repository. For a list of follow-up tasks you'll need to complete after each migration, see [AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#completing-follow-up-tasks).

View File

@@ -1 +1 @@
For complex repositories larger than around 5 GB, we recommend contacting {% data variables.product.prodname_expert_services %}.
For complex repositories larger than around 40GB, we recommend contacting {% data variables.product.prodname_expert_services %}.

View File

@@ -1 +1 @@
For repositories with git or metadata archives greater than 20GB, consider engaging our {% data variables.product.prodname_expert_services %} to help bring your large repositories within Enterprise Cloud Importer limits.
For repositories with git or metadata archives greater than 40GB, consider engaging our {% data variables.product.prodname_expert_services %} to help bring your large repositories within Enterprise Cloud Importer limits.