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

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

Кто может использовать эту функцию?

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

Tool navigation

В этой статье

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

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

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

Совет

Если вы включили неизменяемые выпуски для репозитория, рекомендуется сначала создать выпуски в виде черновиков, прикрепить все ресурсы, а затем опубликовать. Это гарантирует, что все активы будут на месте до того, как релиз станет неизменяемым. Дополнительные сведения см. в разделе Неизменяемые выпуски.

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

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

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

  3. В верхней части страницы нажмите кнопку "Черновик" нового выпуска.

  4. Чтобы выбрать тег выпуска, выберите раскрывающееся меню " Выбрать тег ".

    • Чтобы использовать существующий тег, щелкните тег.
    • Чтобы создать новый тег, введите номер версии для выпуска и нажмите кнопку "Создать новый тег".

  5. Если вы создали новый тег, выберите раскрывающееся меню "Целевой объект", а затем щелкните ветвь, содержащую проект, который вы хотите освободить.

  6. При необходимости над полем описания выберите раскрывающееся меню "Предыдущий тег ", а затем выберите тег, определяющий предыдущий выпуск.

    Снимок экрана: форма "Новый выпуск". Раскрывающееся меню с надписью "Предыдущий тег: авто", выделено оранжевым контуром.

  7. В поле "Название выпуска" введите название выпуска.

  8. В поле "Описание этого выпуска" введите описание выпуска. Если вы @mention любой пользователь в описании, опубликованный выпуск будет включать раздел "Участники" со списком аватаров всех упомянутых пользователей. Кроме того, вы можете автоматически создавать заметки о выпуске, нажав кнопку "Создать заметки о выпуске".

  9. Если в выпуск необходимо включить двоичные файлы, например скомпилированные программы, перетащите или вручную выберите файлы в области двоичных файлов.

  10. При необходимости, чтобы уведомить пользователей о том, что выпуск не готов к рабочей среде и может быть неустойчивым, выберите это предварительная версия.

  11. При необходимости выберите "Задать в качестве последнего выпуска". Если этот параметр не выбран, последняя метка выпуска будет автоматически назначена на основе семантического управления версиями.

  12. При необходимости, если для репозитория включен параметр GitHub Discussions, создайте обсуждение выпуска.

    • Выберите " Создать обсуждение" для этого выпуска.
    • Выберите раскрывающееся меню "Категория", а затем выберите категорию для обсуждения выпуска.

  13. Если вы готовы опубликовать выпуск, нажмите кнопку Опубликовать выпуск. Чтобы поработать над релизом позже, нажмите «Сохранить черновик». Если вы включили иммутабельные релизы для репозитория, создание черновика сначала позволяет прикрепить все ассеты до того, как релиз станет неизменным.

Примечание.

Дополнительные сведения о GitHub CLIсм. в разделе О GitHub CLI.

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

    gh release create TAG

  2. Следуйте интерактивным инструкциям. Кроме того, можно указать аргументы, чтобы пропустить эти инструкции. Дополнительные сведения о возможных аргументах см. в руководстве по GitHub CLI. Например, эта команда создает предварительный выпуск с указанным названием и заметками.

gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a public preview release" --prerelease

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

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

Примечание.

Если вы включили неизменяемые выпуски для репозитория, вы можете изменить только заметки о заголовке и выпуске после публикации выпуска. См . раздел AUTOTITLE.

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

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

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

  3. Рядом с выпуском, который вы хотите изменить, щелкните .

    Снимок экрана: выпуск в списке выпусков. Значок карандаша выделен оранжевым контуром.

  4. Измените сведения о выпуске в форме, а затем нажмите кнопку "Обновить выпуск". Если вы добавите или удалите любого @mentions GitHub пользователей в описании, эти пользователи будут добавлены или удалены из списка аватаров в разделе Contributors релиза.

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

    gh release edit TAG -t "NEW-TITLE"

    Дополнительные сведения о возможных аргументах см. в руководстве по GitHub CLI.

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

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

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

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

  3. В правой части страницы рядом с выпуском, который вы хотите удалить, щелкните .

    Снимок экрана: выпуск в списке выпусков. Значок корзины выделен оранжевым контуром.

  4. Нажмите кнопку Удалить этот выпуск.

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

    gh release delete TAG -y