Skip to content

Commit ee2fb04

Browse files
authored
Merge pull request #40706 from github/repo-sync
Repo sync
2 parents fa913ba + 26615dd commit ee2fb04

File tree

3 files changed

+11
-10
lines changed

3 files changed

+11
-10
lines changed

content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
2-
title: Troubleshooting the 2 GB push limit
3-
intro: 'Learn how to work around the 2 GB push limit.'
2+
title: Troubleshooting the 2 GiB push limit
3+
intro: 'Learn how to work around the 2 GiB push limit.'
4+
allowTitleToDifferFromFilename: true
45
versions:
56
fpt: '*'
67
ghec: '*'
@@ -9,18 +10,18 @@ shortTitle: Maximum push limit
910

1011
## About the push limit
1112

12-
{% 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.
13+
{% 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.
1314

1415
If you hit this limit, you may see one of the following error messages:
1516

1617
* `fatal: the remote end hung up unexpectedly`
1718
* `remote: fatal: pack exceeds maximum allowed size`
1819

19-
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.
20+
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.
2021

2122
## Splitting up a large push
2223

23-
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.
24+
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.
2425

2526
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).
2627
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
5758

5859
## Starting from scratch
5960

60-
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.
61+
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.
6162

6263
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.
6364
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
6667

6768
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).
6869

69-
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.
70+
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.
7071

7172
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.

content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/about-migrations-from-bitbucket-server-to-github-enterprise-cloud.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Currently, the following data is **not** migrated.
3838

3939
### Limitations of {% data variables.product.prodname_importer_proper_name %}
4040

41-
* **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.
41+
* **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.
4242
{% data reusables.enterprise-migration-tool.limitations-of-migration-tooling %}
4343

4444
## Getting started

data/reusables/enterprise-migration-tool/limitations-of-dotcom.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,6 @@ There are limits to what {% data variables.product.prodname_importer_proper_name
22

33
### Limitations of {% data variables.product.prodname_dotcom %}
44

5-
* **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.
5+
* **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.
66
* **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.
7-
* **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).
7+
* **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).

0 commit comments

Comments
 (0)