From 26615ddcc452d0510df401bac6d94425913bcbf8 Mon Sep 17 00:00:00 2001 From: Junko Suzuki Date: Mon, 6 Oct 2025 19:23:23 +0900 Subject: [PATCH] Update the unit for push limit (#57760) Co-authored-by: Anne-Marie <102995847+am-stead@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../troubleshooting-the-2-gb-push-limit.md | 15 ++++++++------- ...bitbucket-server-to-github-enterprise-cloud.md | 2 +- .../limitations-of-dotcom.md | 4 ++-- 3 files changed, 11 insertions(+), 10 deletions(-) diff --git a/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md b/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md index 324d356b2a53..56bc92b80066 100644 --- a/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md +++ b/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md @@ -1,6 +1,7 @@ --- -title: Troubleshooting the 2 GB push limit -intro: 'Learn how to work around the 2 GB push limit.' +title: Troubleshooting the 2 GiB push limit +intro: 'Learn how to work around the 2 GiB push limit.' +allowTitleToDifferFromFilename: true versions: fpt: '*' ghec: '*' @@ -9,18 +10,18 @@ shortTitle: Maximum push limit ## About the push limit -{% data variables.product.prodname_dotcom %} has a maximum 2 GB limit for a single push. You might hit this limit when trying to upload very large repositories for the first time, importing large repositories from other platforms, or when trying to rewrite the history of large existing repositories. +{% data variables.product.prodname_dotcom %} has a maximum 2 GiB limit for a single push. You might hit this limit when trying to upload very large repositories for the first time, importing large repositories from other platforms, or when trying to rewrite the history of large existing repositories. If you hit this limit, you may see one of the following error messages: * `fatal: the remote end hung up unexpectedly` * `remote: fatal: pack exceeds maximum allowed size` -You can either split up your push into smaller parts, or delete the Git history and start from scratch. If you have made a single commit that's larger than 2 GB and you can't delete the Git history and start from scratch, then you will need to perform an interactive rebase to split the large commit into multiple smaller ones. +You can either split up your push into smaller parts, or delete the Git history and start from scratch. If you have made a single commit that's larger than 2 GiB and you can't delete the Git history and start from scratch, then you will need to perform an interactive rebase to split the large commit into multiple smaller ones. ## Splitting up a large push -You can avoid hitting the limit by breaking your push into smaller parts, each of which should be under 2 GB in size. If a branch is within this size limit, you can push it all at once. However, if a branch is larger than 2 GB, you'll need to split the push into even smaller portions and push only a few commits at a time. +You can avoid hitting the limit by breaking your push into smaller parts, each of which should be under 2 GiB in size. If a branch is within this size limit, you can push it all at once. However, if a branch is larger than 2 GiB, you'll need to split the push into even smaller portions and push only a few commits at a time. 1. If you haven't configured the remote yet, add the repository as a new remote. For more information, see [AUTOTITLE](/get-started/git-basics/managing-remote-repositories#adding-a-remote-repository). 1. To find suitable commits spread out along the history of the main branch in your local repository, run the following command: @@ -57,7 +58,7 @@ echo "$step_commits" | while read commit message; do git push REMOTE-NAME +$comm ## Starting from scratch -If the repository does not have any history, or your initial commit was over 2 GB on its own and you don't mind resetting the Git history, you can also start from scratch. +If the repository does not have any history, or your initial commit was over 2 GiB on its own and you don't mind resetting the Git history, you can also start from scratch. 1. On your local copy, delete the hidden `.git` folder to remove all the previous Git history and convert it back into a normal folder full of files. 1. Create a new empty folder. @@ -66,6 +67,6 @@ If the repository does not have any history, or your initial commit was over 2 G If you do not already use {% data variables.large_files.product_name_short %}, you can skip this step, or you can set up the tracking rules you intend to use in the `.gitattributes` file in the new folder before you copy any other files across. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage). -1. Move batches of files that are smaller than 2 GB from the old folder to the new folder. After each batch is moved, create a commit and push it before moving the next batch. You can take a cautious approach and stick to around 2 GB. Alternatively, if you have a folder with files meant for {% data variables.large_files.product_name_short %}, you can ignore those files when considering the 2 GB limit per batch. +1. Move batches of files that are smaller than 2 GiB from the old folder to the new folder. After each batch is moved, create a commit and push it before moving the next batch. You can take a cautious approach and stick to around 2 GiB. Alternatively, if you have a folder with files meant for {% data variables.large_files.product_name_short %}, you can ignore those files when considering the 2 GiB limit per batch. Once the old folder is empty, the {% data variables.product.prodname_dotcom %} repository should contain everything. If you are using {% data variables.large_files.product_name_short %}, all files meant for {% data variables.large_files.product_name_short %} should be pushed to {% data variables.large_files.product_name_short %} storage. diff --git a/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/about-migrations-from-bitbucket-server-to-github-enterprise-cloud.md b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/about-migrations-from-bitbucket-server-to-github-enterprise-cloud.md index dd0b82ef463c..dba982a7f372 100644 --- a/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/about-migrations-from-bitbucket-server-to-github-enterprise-cloud.md +++ b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/about-migrations-from-bitbucket-server-to-github-enterprise-cloud.md @@ -38,7 +38,7 @@ Currently, the following data is **not** migrated. ### 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. +* **40 GiB 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 GiB of combined git data and metadata in the repository archive. {% data reusables.enterprise-migration-tool.limitations-of-migration-tooling %} ## Getting started diff --git a/data/reusables/enterprise-migration-tool/limitations-of-dotcom.md b/data/reusables/enterprise-migration-tool/limitations-of-dotcom.md index bdee7301f2d8..348add4a8f60 100644 --- a/data/reusables/enterprise-migration-tool/limitations-of-dotcom.md +++ b/data/reusables/enterprise-migration-tool/limitations-of-dotcom.md @@ -2,6 +2,6 @@ There are limits to what {% data variables.product.prodname_importer_proper_name ### 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. +* **2 GiB size limit for a single Git commit:** No single commit in your Git repository can be larger than 2 GiB. If any of your commits are larger than 2 GiB, you will need to split the commit into smaller commits that are each 2 GiB 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). +* **100 MiB file size limit:** After you complete your migration, no single file in your Git repository can be larger than 100 MiB. During repository migration this limit is increased to 400 MiB. 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).