# Управление выпусками в репозитории

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

## Сведения об управлении выпусками

Вы можете создавать выпуски с заметками о выпуске, упоминаниями (@mentions) участников и ссылками на двоичные файлы, а также редактировать или удалять существующие выпуски. Вы также можете создавать, изменять и удалять выпуски с помощью API выпусков. Дополнительные сведения см [. в статье AUTOTITLE](/ru/rest/releases/releases) в документации по REST API.

Вы также можете опубликовать действие из конкретного релиза в GitHub Marketplace. Дополнительные сведения см. в разделе [Публикация действий в GitHub Marketplace](/ru/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace).

Вы можете выбрать, включены Хранилище больших файлов Git ли объектыGit LFS (Git Large File Storage — поддержка хранения больших файлов в Git) () в ZIP-файлы и тарболы, которые GitHub создаются для каждого релиза. Дополнительные сведения см. в разделе [Управление объектами LFS Git в архивах репозитория](/ru/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository).

## Создание выпуска

> \[!TIP]
> Если вы включили неизменяемые выпуски для репозитория, рекомендуется сначала создать выпуски в виде черновиков, прикрепить все ресурсы, а затем опубликовать. Это гарантирует, что все активы будут на месте до того, как релиз станет неизменяемым. Дополнительные сведения см. в разделе [Неизменяемые выпуски](/ru/code-security/concepts/supply-chain-security/immutable-releases).

<div class="ghd-tool webui">

1. На GitHubперейдите на главную страницу репозитория.
2. Справа от списка файлов щелкните **Выпуски**.

   ![Снимок экрана: главная страница репозитория. Ссылка, помеченная как "Выпуски", выделена оранжевым контуром.](/assets/images/help/releases/release-link.png)
3. В верхней части страницы нажмите кнопку **"Черновик" нового выпуска**.
4. Чтобы выбрать тег выпуска, выберите раскрывающееся меню " **Выбрать тег** ".
   * Чтобы использовать существующий тег, щелкните тег.
   * Чтобы создать новый тег, введите номер версии для выпуска и нажмите кнопку **"Создать новый тег**".
5. Если вы создали новый тег, выберите **раскрывающееся меню "Целевой** объект", а затем щелкните ветвь, содержащую проект, который вы хотите освободить.
6. При необходимости над полем описания выберите **раскрывающееся меню "Предыдущий тег** ", а затем выберите тег, определяющий предыдущий выпуск.

   ![Снимок экрана: форма "Новый выпуск". Раскрывающееся меню с надписью "Предыдущий тег: авто", выделено оранжевым контуром.](/assets/images/help/releases/releases-tag-previous-release.png)
7. В поле "Название выпуска" введите название выпуска.
8. В поле "Описание этого выпуска" введите описание выпуска.
   Если вы @mention любой пользователь в описании, опубликованный выпуск будет включать раздел "Участники" со списком **аватаров** всех упомянутых пользователей.
   Кроме того, вы можете автоматически создавать заметки о выпуске, нажав **кнопку "Создать заметки** о выпуске".
9. Если в выпуск необходимо включить двоичные файлы, например скомпилированные программы, перетащите или вручную выберите файлы в области двоичных файлов.
10. При необходимости, чтобы уведомить пользователей о том, что выпуск не готов к рабочей среде и может быть неустойчивым, выберите **это предварительная версия**.
11. При необходимости выберите **"Задать в качестве последнего выпуска**". Если этот параметр не выбран, последняя метка выпуска будет автоматически назначена на основе семантического управления версиями.
12. При необходимости, если для репозитория включен параметр GitHub Discussions, создайте обсуждение выпуска.
    * Выберите " **Создать обсуждение" для этого выпуска**.
    * **Выберите раскрывающееся меню "Категория**", а затем выберите категорию для обсуждения выпуска.
13. Если вы готовы опубликовать выпуск, нажмите кнопку **Опубликовать выпуск**. Чтобы поработать над релизом позже, нажмите **«Сохранить черновик**».  Если вы включили иммутабельные релизы для репозитория, создание черновика сначала позволяет прикрепить все ассеты до того, как релиз станет неизменным.
    Затем вы можете просмотреть опубликованные или черновики выпусков в веб-канале выпусков для репозитория. Дополнительные сведения см. в разделе [Просмотр выпусков и тегов репозитория](/ru/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags).

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Дополнительные сведения о GitHub CLIсм. в разделе [О GitHub CLI](/ru/github-cli/github-cli/about-github-cli).

1. Чтобы создать выпуск, используйте подкоманду `gh release create`. Замените `tag` на нужный тег.

   ```shell
   gh release create TAG
   ```

2. Следуйте интерактивным инструкциям. Кроме того, можно указать аргументы, чтобы пропустить эти инструкции. Для получения дополнительной информации о возможных аргументах см. [GitHub CLI руководство](https://cli.github.com/manual/gh_release_create). Например, эта команда создает предварительный выпуск с указанным названием и заметками.

<!-- markdownlint-disable outdated-release-phase-terminology --> <!-- disable the outdated-release-phase-terminology rule since "beta" is part of the CLI command --> 

```shell
gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a Публичный предварительный просмотр release" --prerelease
```

<!-- markdownlint-enable outdated-release-phase-terminology -->

Если вы @mentionGitHub пользуетесь заметками, опубликованный релиз будет включать раздел **участников** со списком аватаров всех упомянутых пользователей.

</div>

## Редактирование выпуска

> \[!NOTE]
> Если вы включили неизменяемые выпуски для репозитория, вы можете изменить только заметки о заголовке и выпуске после публикации выпуска. См [. раздел AUTOTITLE](/ru/code-security/concepts/supply-chain-security/immutable-releases).

<div class="ghd-tool webui">

1. На GitHubперейдите на главную страницу репозитория.
2. Справа от списка файлов щелкните **Выпуски**.

   ![Снимок экрана: главная страница репозитория. Ссылка, помеченная как "Выпуски", выделена оранжевым контуром.](/assets/images/help/releases/release-link.png)
3. Рядом с выпуском, который вы хотите изменить, щелкните <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>.

   ![Снимок экрана: выпуск в списке выпусков. Значок карандаша выделен оранжевым контуром.](/assets/images/help/releases/edit-release-pencil.png)
4. Измените сведения о выпуске в форме, а затем нажмите кнопку **"Обновить выпуск**". Если вы добавите или удалите любого @mentions GitHub пользователей в описании, эти пользователи будут добавлены или удалены из списка аватаров в разделе **Contributors** релиза.

</div>

<div class="ghd-tool cli">

1. Чтобы изменить выпуск, используйте `gh release edit` подкоманда. Замените `TAG` тегом, представляющим выпуск, который вы хотите изменить. Например, чтобы изменить название выпуска, используйте следующий код, заменив `NEW-TITLE` обновленный заголовок:

   ```shell
   gh release edit TAG -t "NEW-TITLE"
   ```

   Для получения дополнительной информации о возможных аргументах см. [GitHub CLI руководство](https://cli.github.com/manual/gh_release_edit).

</div>

## Удаление выпуска

<div class="ghd-tool webui">

1. На GitHubперейдите на главную страницу репозитория.
2. Справа от списка файлов щелкните **Выпуски**.

   ![Снимок экрана: главная страница репозитория. Ссылка, помеченная как "Выпуски", выделена оранжевым контуром.](/assets/images/help/releases/release-link.png)
3. Справа на странице, рядом с релизом, который вы хотите удалить, нажмите <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-trash" aria-label="Delete" role="img"><path d="M11 1.75V3h2.25a.75.75 0 0 1 0 1.5H2.75a.75.75 0 0 1 0-1.5H5V1.75C5 .784 5.784 0 6.75 0h2.5C10.216 0 11 .784 11 1.75ZM4.496 6.675l.66 6.6a.25.25 0 0 0 .249.225h5.19a.25.25 0 0 0 .249-.225l.66-6.6a.75.75 0 0 1 1.492.149l-.66 6.6A1.748 1.748 0 0 1 10.595 15h-5.19a1.75 1.75 0 0 1-1.741-1.575l-.66-6.6a.75.75 0 1 1 1.492-.15ZM6.5 1.75V3h3V1.75a.25.25 0 0 0-.25-.25h-2.5a.25.25 0 0 0-.25.25Z"></path></svg>.

   ![Снимок экрана: выпуск в списке выпусков. Значок корзины выделен оранжевым контуром.](/assets/images/help/releases/delete-release-trash.png)
4. Нажмите кнопку **Удалить этот выпуск**.

</div>

<div class="ghd-tool cli">

1. Чтобы удалить выпуск, используйте подкоманду `gh release delete`. Замените `tag` на тег удаляемого выпуска. Чтобы пропустить подтверждение, используйте флаг `-y`.

   ```shell
   gh release delete TAG -y
   ```

</div>