Работать с реестром Binary

В реестре Binary можно хранить произвольные файлы: скрипты, исполняемые файлы, документы и другие артефакты. Для загрузки и скачивания файлов используйте cURL.

Подготовка к работе

  1. Создайте реестр типа Binary или подключите существующий.

  2. Создайте персональный токен (PAT).

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

    export REGISTRY_USERNAME="iam"
    export REGISTRY_PASSWORD="<персональный_токен_PAT>"
    

Совет

Слаг организации и идентификатор реестра вы можете узнать на странице реестра в интерфейсе SourceCraft.

Загрузить файл в реестр

Выполните HTTP-запрос методом PUT:

curl \
  --request PUT \
  --user "$REGISTRY_USERNAME:$REGISTRY_PASSWORD" \
  --upload-file "<локальный_путь_к_файлу>" \
  "https://pkg.sourcecraft.tech/binaries/<слаг_организации>/<идентификатор_реестра>/<имя_артефакта>/<версия_артефакта>/<имя_файла_в_реестре>"

В URL укажите имя и версию артефакта, а также имя, под которым файл будет храниться в реестре. Например: sample-package/1.0.0/installer.sh.

Чтобы сервис проверил целостность загруженного файла, добавьте к запросу параметр --header "X-Checksum-SHA256: <хеш_файла>". Получить хеш можно командой:

openssl dgst -sha256 "<локальный_путь_к_файлу>" | awk '{print $2}'

Скачать файл из реестра

Выполните HTTP-запрос методом GET:

curl \
  --request GET \
  --user "$REGISTRY_USERNAME:$REGISTRY_PASSWORD" \
  --location \
  --output "<локальный_путь_к_файлу>" \
  "https://pkg.sourcecraft.tech/binaries/<слаг_организации>/<идентификатор_реестра>/<имя_артефакта>/<версия_артефакта>"

В URL для скачивания укажите имя и версию артефакта без имени файла. Параметр --output задает путь и имя файла на вашем компьютере.

Полезные ссылки

Предыдущая
Следующая