From 13caa0b91f2158cd9b5741101cf0e3eadc7ce7f7 Mon Sep 17 00:00:00 2001 From: Laura Coursen Date: Thu, 5 Aug 2021 08:42:15 -0500 Subject: [PATCH] note that external LFS files aren't included in archives, take 2 (#20700) --- ...naging-git-lfs-objects-in-archives-of-your-repository.md | 6 ++---- .../releasing-projects-on-github/about-releases.md | 2 +- .../managing-releases-in-a-repository.md | 2 +- .../about-storage-and-bandwidth-usage.md | 2 +- .../configuring-git-large-file-storage.md | 2 +- .../large_files/can-include-lfs-objects-archives.md | 2 +- 6 files changed, 7 insertions(+), 9 deletions(-) diff --git a/content/github/administering-a-repository/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md b/content/github/administering-a-repository/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md index 67cd62863fd4..5f644fe3566c 100644 --- a/content/github/administering-a-repository/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md +++ b/content/github/administering-a-repository/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md @@ -5,8 +5,6 @@ intro: 'You can choose whether {% data variables.large_files.product_name_long % permissions: 'People with admin permissions for a repository can manage whether {% data variables.large_files.product_name_short %} objects are included in archives of the repository.' versions: fpt: '*' - ghes: '>3.0' - ghae: '*' topics: - Repositories redirect_from: @@ -16,9 +14,9 @@ redirect_from: {% data variables.product.product_name %} creates source code archives of your repository in the form of ZIP files and tarballs. People can download these archives on the main page of your repository or as release assets. By default, {% data variables.large_files.product_name_short %} objects are not included in these archives, only the pointer files to these objects. To improve the usability of archives for your repository, you can choose to include the {% data variables.large_files.product_name_short %} objects instead. -{% ifversion fpt %} If you choose to include {% data variables.large_files.product_name_short %} objects in archives of your repository, every download of those archives will count towards bandwidth usage for your account. Each account receives {% data variables.large_files.initial_bandwidth_quota %} per month of bandwidth for free, and you can pay for additional usage. For more information, see "[About storage and bandwidth usage](/github/managing-large-files/about-storage-and-bandwidth-usage)" and "[Managing billing for {% data variables.large_files.product_name_long %}](/billing/managing-billing-for-git-large-file-storage)." -{% endif %} + +If you use an external LFS server (configured in your `.lfsconfig`), those LFS files will not be included in archives of the repository. The archive will only contain files that have been committed to {% data variables.product.product_name %}. ## Managing {% data variables.large_files.product_name_short %} objects in archives diff --git a/content/github/administering-a-repository/releasing-projects-on-github/about-releases.md b/content/github/administering-a-repository/releasing-projects-on-github/about-releases.md index fce501eabe3d..e9586e5adcaf 100644 --- a/content/github/administering-a-repository/releasing-projects-on-github/about-releases.md +++ b/content/github/administering-a-repository/releasing-projects-on-github/about-releases.md @@ -27,7 +27,7 @@ You can receive notifications when new releases are published in a repository wi Anyone with read access to a repository can view and compare releases, but only people with write permissions to a repository can manage releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)." -{% ifversion fpt or ghes > 3.0 or ghae %} +{% ifversion fpt %} People with admin permissions to a repository can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} diff --git a/content/github/administering-a-repository/releasing-projects-on-github/managing-releases-in-a-repository.md b/content/github/administering-a-repository/releasing-projects-on-github/managing-releases-in-a-repository.md index f7a46e8216dc..d563c5a54e0c 100644 --- a/content/github/administering-a-repository/releasing-projects-on-github/managing-releases-in-a-repository.md +++ b/content/github/administering-a-repository/releasing-projects-on-github/managing-releases-in-a-repository.md @@ -24,10 +24,10 @@ shortTitle: Manage releases {% ifversion fpt %} You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "Publishing an action in the {% data variables.product.prodname_marketplace %}." -{% endif %} You can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} +{% endif %} {% ifversion fpt or ghae or ghes %} {% tip %} diff --git a/content/github/managing-large-files/versioning-large-files/about-storage-and-bandwidth-usage.md b/content/github/managing-large-files/versioning-large-files/about-storage-and-bandwidth-usage.md index e4998ac3a597..9b2e33d2e347 100644 --- a/content/github/managing-large-files/versioning-large-files/about-storage-and-bandwidth-usage.md +++ b/content/github/managing-large-files/versioning-large-files/about-storage-and-bandwidth-usage.md @@ -20,7 +20,7 @@ For example: - If you push a 500 MB file to {% data variables.large_files.product_name_short %}, you'll use 500 MB of your allotted storage and none of your bandwidth. If you make a 1 byte change and push the file again, you'll use another 500 MB of storage and no bandwidth, bringing your total usage for these two pushes to 1 GB of storage and zero bandwidth. - If you download a 500 MB file that's tracked with LFS, you'll use 500 MB of the repository owner's allotted bandwidth. If a collaborator pushes a change to the file and you pull the new version to your local repository, you'll use another 500 MB of bandwidth, bringing the total usage for these two downloads to 1 GB of bandwidth. -{% ifversion fpt or ghes > 3.0 %} +{% ifversion fpt %} If {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} diff --git a/content/github/managing-large-files/versioning-large-files/configuring-git-large-file-storage.md b/content/github/managing-large-files/versioning-large-files/configuring-git-large-file-storage.md index aaf016b49b0c..69ed09e4cc31 100644 --- a/content/github/managing-large-files/versioning-large-files/configuring-git-large-file-storage.md +++ b/content/github/managing-large-files/versioning-large-files/configuring-git-large-file-storage.md @@ -60,5 +60,5 @@ If there are existing files in your repository that you'd like to use {% data va ## Further reading -- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)"{% ifversion fpt or ghes > 3.0 or ghae %} +- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)"{% ifversion fpt %} - "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)"{% endif %} diff --git a/data/reusables/large_files/can-include-lfs-objects-archives.md b/data/reusables/large_files/can-include-lfs-objects-archives.md index f5349707cda2..aed646de475b 100644 --- a/data/reusables/large_files/can-include-lfs-objects-archives.md +++ b/data/reusables/large_files/can-include-lfs-objects-archives.md @@ -1,3 +1,3 @@ -{% ifversion fpt or ghes > 3.0 or ghae %} +{% ifversion fpt %} You can choose whether {% data variables.large_files.product_name_short %} objects are included in source code archives, such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %}