Репозитории формата raw хранят произвольные файлы: архивы релизов, модели, документы. В примерах используется условное имя raw-hosted.

Публикация

Загрузите файл запросом PUT по нужному пути:

curl -u <USERNAME>:<PASSWORD> -T release.tar.gz \
  https://<GALLEON_HOST>/repository/raw-hosted/releases/v1.0.0/release.tar.gz

В ответе возвращаются заголовки с контрольными суммами (X-Checksum-Sha256 и другие). Загрузка доступна и через веб-интерфейс — раздел «Загрузка».

Скачивание и удаление

Скачивание и удаление файла:

curl -u <USERNAME>:<PASSWORD> -O https://<GALLEON_HOST>/repository/raw-hosted/releases/v1.0.0/release.tar.gz
curl -u <USERNAME>:<PASSWORD> -X DELETE https://<GALLEON_HOST>/repository/raw-hosted/releases/v1.0.0/release.tar.gz

Контрольные суммы возвращаются в заголовках X-Checksum-* при скачивании и загрузке. Отдельный checksum-файл (например, file.tar.gz.sha256) доступен, только если он был загружен как самостоятельный файл.

Proxy-репозитории

Raw-репозиторий может быть и кеширующим зеркалом внешнего HTTP-источника: файлы скачиваются теми же путями GET, а загрузка и удаление недоступны. Пример из стартового набора — go-sumdb, proxy-репозиторий базы контрольных сумм Go.

Особенности

Особенности формата:

  • Поведение браузера при открытии файлов (показать или сохранить) задаёт администратор настройкой репозитория. В репозиториях с режимом показа inline публикация HTML-, SVG- и JavaScript-файлов отклоняется из соображений безопасности.
  • Если политика записи репозитория запрещает перезапись, повторная загрузка по существующему пути отклоняется с кодом 409.
  • В путях отклоняются конструкции вида .., управляющие символы и ряд специальных символов.
←
Форматы / Cargo