---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/releases-work.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/releases-work.md
  - href: ru/sourcecraft/operations/releases-work.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt

# Работа с релизами в SourceCraft

<!-- source: ru/_includes/sourcecraft/releases-intro.md -->
_Релиз_ — это зафиксированная версия программного продукта, включающая определенный набор изменений, тег, описание и дополнительные ресурсы, например бинарные файлы или архивы, предназначенные для пользователей или других разработчиков.

С помощью релизов вы можете обеспечить удобный доступ к конкретным состояниям репозитория и их сравнению, готовым сборкам продукта для пользователей, а также представить наглядную историю развития проекта и управления версиями.
<!-- endsource: ru/_includes/sourcecraft/releases-intro.md -->

<!-- source: ru/_includes/sourcecraft/releases-tags.md -->
Релизы в SourceCraft привязываются к _тегу_ репозитория — маркировке важной точки в истории проекта. К одному тегу может быть привязан только один релиз.
<!-- endsource: ru/_includes/sourcecraft/releases-tags.md -->

Подробнее на странице [Релизы в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/releases.md).

<iframe width="640" height="360" src="https://runtime.strm.yandex.ru/player/video/vplvaddxgkpodelejt7k?autoplay=0&mute=0" allow="autoplay; fullscreen; picture-in-picture; encrypted-media" frameborder="0" scrolling="no"></iframe>

## Создать релиз {#create-release}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
1. В разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/rocket.svg) **Релизы**.
1. В правом верхнем углу нажмите **Новый релиз**.
1. В блоке **Общая информация**:
    1. Выберите тег, на основе которого будет создан релиз.

        {% note info %}

        Можно выбрать только тот тег, на основе которого еще не был создан ни один релиз.
        
        Вы можете использовать [заранее созданный тег](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/tag-create.md) или создать новый.

        {% endnote %}

        Чтобы создать новый тег:
        1. В поле выбора тега нажмите ![image](../../_assets/console-icons/plus.svg).
        1. В поле **Тег** введите название тега.
        1. В поле **Цель** выберите ветку, на основе которой будет создан тег.
        1. Нажмите **Сохранить**.
    1. Введите название релиза.
1. (опционально) В блоке **Примечания к релизу**:
    * выберите предыдущий релиз;
    * введите описание релиза, например укажите, что изменилось, было исправлено или улучшено, а также уточните особенности обновления.
1. (опционально) В блоке **Ресурсы релиза** нажмите ![image](../../_assets/console-icons/plus.svg) **Добавить ресурс** и выберите тип ресурса:
    * **Файл** — нажмите **Обзор** и загрузите файл с локального компьютера.

      <!-- source: ru/_includes/sourcecraft/releases-limits.md -->
      {% note warning "Ограничения" %}

      В SourceCraft установлены [лимиты](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/limits.md#common-limits) на объем загружаемых в релиз файлов.

      {% endnote %}
      <!-- endsource: ru/_includes/sourcecraft/releases-limits.md -->

    * **Ссылка** — введите ссылку на внешний ресурс и отображаемое название.

    Чтобы добавить еще ресурс, нажмите ![image](../../_assets/console-icons/plus.svg) **Добавить ресурс**.

    Чтобы удалить ресурс, напротив него нажмите ![image](../../_assets/console-icons/trash-bin.svg).

1. Нажмите **Опубликовать релиз**.

    {% note tip %}

    Также вы можете не публиковать релиз, а сохранить его черновик, чтобы доработать позже. Для этого нажмите **Сохранить черновик**.

    Описание и содержимое черновика релиза доступны пользователям с [ролью](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#src-repositories-admin) `Администратор репозитория` и [ролью](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#src-repositories-maintainer) `Ответственный за репозиторий`.

    {% endnote %}

## Посмотреть релиз {#view-release}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
1. В разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/rocket.svg) **Релизы**.

    На странице будет выведен список релизов с указанием авторов, дат и времени публикации, тегов, коммитов, описаний и приложенных ресурсов.

    Также в списке будет отмечен последний релиз.

1. Выберите релиз, который вы хотите просмотреть.

## Скачать ресурсы релиза {#download-assets}

Каждый опубликованный релиз содержит в блоке **Ресурсы релиза**:

* автоматически сгенерированные архивы с исходным кодом релиза в форматах `.zip` и `.tar.gz`;
* файлы, приложенные к релизу при его [создании](#create-release) или [редактировании](#edit-release);
* ссылки на внешние ресурсы.

Скачать их можно через интерфейс SourceCraft или с помощью [REST API](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/api-start.md).

{% list tabs group=instructions %}

- Интерфейс SourceCraft {#src}

  1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
  1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
  1. В разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/rocket.svg) **Релизы**.
  1. В карточке нужного релиза в блоке **Ресурсы релиза** выберите ресурс:

      * **Исходный код (zip)** — скачать архив с исходным кодом релиза в формате `.zip`.
      * **Исходный код (tar.gz)** — скачать архив с исходным кодом релиза в формате `.tar.gz`.
      * `<название_файла>` — скачать файл, прикрепленный к релизу.
      * `<ссылка>` — открыть внешний ресурс.

- REST API {#api}

  Получить ссылки на ресурсы релиза можно с помощью метода [Get Release (By Tag)](https://sourcecraft.dev/portal/docs/ru/api-ref/Repository-or-Releases/GetByTag.md) REST API SourceCraft. В ответе на запрос в поле `assets` будет приведен список ресурсов релиза. В каждом ресурсе ссылка для скачивания доступна в одном из полей:

  * `archive_link.link` — ссылка на архив с исходным кодом релиза;
  * `link` — ссылка на приложенный файл или на внешний ресурс.

  Чтобы получить ссылки на ресурсы релиза:

  1. Получите [персональный токен (PAT)](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/pat.md) для аутентификации в API.
  1. Выполните запрос:

      ```bash
      export PAT=<персональный_токен>
      curl \
          --request GET \
          --header "Authorization: Bearer $PAT" \
          --url "https://api.sourcecraft.tech/repos/<слаг_организации>/<слаг_репозитория>/releases/tag/<тег_релиза>" | jq
      ```

      Где:

      * `<слаг_организации>` — слаг организации, которой принадлежит репозиторий;
      * `<слаг_репозитория>` — слаг репозитория, в котором опубликован релиз;
      * `<тег_релиза>` — тег, на основе которого создан релиз.

  1. Скачайте архив с исходным кодом релиза с помощью утилиты `wget`, используя ссылку из поля `archive_link.link`:

      ```bash
      wget "<ссылка_из_поля_archive_link.link>" --output-document=<имя_файла>.tar.gz
      ```

      Чтобы скачать приложенный к релизу файл или открыть внешнюю ссылку, используйте значение поля `link`.

  Подробнее об аутентификации и работе с SourceCraft REST API смотрите на странице [Работа с REST API SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/api-start.md).

{% endlist %}

## Редактировать релиз {#edit-release}

{% note warning %}

Отредактировать можно только черновик релиза.

{% endnote %}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
1. В разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/rocket.svg) **Релизы**.
1. Напротив черновика релиза, который вы хотите изменить, нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите ![image](../../_assets/console-icons/pencil.svg) **Редактировать**.
1. Измените параметры релиза и нажмите **Обновить релиз**.

## Отменить и удалить релиз {#cancel-release}

{% note info %}

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

{% endnote %}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
1. В разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/rocket.svg) **Релизы**.
1. Напротив релиза, который вы хотите отменить, нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите ![image](../../_assets/console-icons/arrow-uturn-ccw-left.svg) **Отменить релиз**.

    При этом описание и содержимое отмененного релиза остаются доступны пользователям с [ролью](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#src-repositories-admin) `Администратор репозитория` и [ролью](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#src-repositories-maintainer) `Ответственный за репозиторий`.

1. Чтобы удалить релиз из репозитория, напротив релиза нажмите ![image](../../_assets/console-icons/ellipsis.svg), выберите ![image](../../_assets/console-icons/trash-bin.svg) **Удалить** и подтвердите удаление.

## Сравнить релизы {#compare-releases}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
1. В разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/rocket.svg) **Релизы**.
1. Напротив релиза, который вы хотите сравнить с другим, нажмите ![image](../../_assets/console-icons/code-compare.svg) **Сравнить** ![image](../../_assets/console-icons/chevron-down.svg) и выберите релиз для сравнения.

#### Полезные ссылки {#see-also}

* [Создать тег в репозитории SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/tag-create.md)
* [Скачать архив с репозиторием SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/repo-download-archive.md)
* [Релизы в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/releases.md)
* [Взаимосвязь ресурсов SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md)
* [Как начать работать с SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/quickstart.md)