Skip to main content

Скачивание архивов исходного кода

Вы можете скачать моментальный снимок кода в репозитории.

Обзор архивов исходного кода

Моментальный снимок любой ветви, тега или конкретной фиксации можно скачать из GitHub.com. Эти моментальные снимки создаются командой git archive в одном из двух форматов: tarball или zipball. Моментальные снимки не содержат всю историю репозитория. Если требуется весь журнал, можно клонировать репозиторий. Дополнительные сведения см. в разделе Клонирование репозитория.

Скачивание архивов исходного кода

Архивы исходного кода можно скачать тремя способами.

Скачивание архивов исходного кода из представления репозитория

  1. На GitHub.comперейдите на главную страницу репозитория.

  2. Над списком файлов щелкните Code.

    Снимок экрана: список файлов на целевой странице репозитория. Кнопка "Код" выделена темно-оранжевым контуром.

  3. Щелкните Скачайте ZIP-файл.

Скачивание архивов исходного кода из выпуска

  1. На GitHub.comперейдите на главную страницу репозитория.

  2. Справа от списка файлов щелкните Выпуски.

    Снимок экрана: главная страница репозитория. Ссылка, помеченная как "Выпуски", выделена оранжевым контуром.

  3. Прокрутите вниз до раздела "Активы" выпуска.

  4. Чтобы скачать исходный код, щелкните Исходный код (zip) или Исходный код (tar.gz).

Скачивание архивов исходного кода из тега

  1. На GitHub.comперейдите на главную страницу репозитория.

  2. Справа от списка файлов щелкните Выпуски.

    Снимок экрана: главная страница репозитория. Ссылка, помеченная как "Выпуски", выделена оранжевым контуром.

  3. В верхней части страницы "Выпуски" щелкните Теги.

  4. Чтобы скачать исходный код, нажмите кнопку **** или tar.gz.

    Снимок экрана: страница "Теги" репозитория. Параметры zip и tar.gz описаны в темно-оранжевый цвет.

URL-адреса архива исходного кода

Архивы исходного кода доступны по определенным URL-адресам для каждого репозитория. Например, рассмотрим репозиторий github/codeql. Существуют различные URL-адреса для скачивания ветви, тега или определенного ИД фиксации.

Тип архиваПримерURL
Ветвьmainhttps://github.com/github/codeql/archive/refs/heads/main.tar.gz
Тегcodeql-cli/v2.12.0https://github.com/github/codeql/archive/refs/tags/codeql-cli/v2.12.0.zip
Commitaef66c4https://github.com/github/codeql/archive/aef66c462abe817e3aad91d97aa782a1e2ad2c7.zip

Примечание. Вы можете использовать url-адреса .zip .tar.gz , указанные выше, для запроса zipball или tarball соответственно.

Стабильность архивов исходного кода

Архивы исходного кода создаются по запросу, кэшируются в течение некоторого времени, а затем удаляются. Если тот же архив запрашивается еще раз в будущем, он будет повторно создан. Важно понимать, какие гарантии : GitHub делает архивы исходного кода.

  • Архив ИД фиксации всегда будет иметь одинаковое содержимое файла при каждом запросе, если ИД фиксации по-прежнему находится в репозитории, а имя репозитория не изменилось.
  • Так как ветви и теги могут перемещаться в разные ИД фиксации, будущие скачивание архива может иметь другое содержимое, чем скачанные ранее архивы одной ветви или тега. Если ветвь или тег по-прежнему указывает на ту же ИД фиксации, он будет иметь то же содержимое файла.
  • Точные параметры сжатия, используемые для создания zipball или tarball, могут меняться с течением времени. Извлеченное содержимое не изменится, если ветвь или тег не изменяется, но внешний сжатый архив может иметь другой макет байтов. GitHub даст по крайней мере шесть месяцев уведомления перед изменением параметров сжатия.
  • Имя репозитория является частью структуры каталогов в архиве. Таким образом, если имя репозитория изменится, имя корневого каталога также изменится.

Если вы полагаетесь на стабильность архивов исходного кода для воспроизведения (обеспечивая всегда одинаковые файлы внутри архива), рекомендуется использовать REST API архивов с ИД фиксации для :ref. Использование ИД фиксации гарантирует, что вы всегда получите одно и то же содержимое файла в архиве, и вы будете защищены от репозиториев перезаписи тегов или перемещения голов ветвей.

Если вы полагаетесь на стабильность архивов для безопасности (например, чтобы убедиться, что вы не пытаетесь распаковать вредоносный созданный файл), рекомендуется использовать выпуски вместо использования исходных скачиваемых файлов. Дополнительные сведения см. в разделе Сведения о выпусках.

Для создания и отправки этих файлов в процессе выпуска можно использовать что-то подобное сторонним действием GitHub. REST API ресурсов выпуска можно использовать позже для их извлечения.