Создание репозитория

Тип

Локальный, прокси или групповой (подробнее — в разделе Типы репозиториев)

—

Название

Уникальное имя репозитория. Используется в URL-адресе для доступа к репозиторию

—

Онлайн

Опция, которая включает доступ к репозиторию для систем сборки, CI/CD-систем и разработчиков

—

URL-адрес удаленного репозитория

URL-адрес удаленного репозитория

Только для прокси-репозиториев

Предзагрузка

Опция, которая включает предварительное скачивание артефактов из удаленного репозитория в прокси-репозиторий VK Registry. Проверка обновлений в удаленном репозитории и репликация артефактов выполняется автоматически

Только для прокси-репозиториев

Регулярное выражение для скачиваемых артефактов

Регулярное выражение для фильтрации артефактов в удаленном репозитории. VK Registry скачает только те артефакты, чьи пути совпадают с этим выражением.

Подробнее про регулярные выражения Java — в официальной документации Oracle

Только для прокси-репозиториев

Компоненты актуальны, мин

Время в минутах, в течение которого кешированный артефакт считается актуальным.

Когда VK Registry получает запрос на артефакт, он проверяет, истекло ли указанное для этого артефакта время:

• Если истекло — VK Registry проверяет наличие новой версии артефакта в удаленном репозитории и при обнаружении загружает ее.
• Если не истекло — артефакт возвращается из кеша без дополнительных проверок.

Специальные значения:

• -1 — отключить проверку.
• 0 — выполнять проверку при каждом запросе артефакта

Только для прокси-репозиториев

Метаданные актуальны, мин

Интервал обновления метаданных в минутах

Только для прокси-репозиториев

Blob-хранилище

Хранилище бинарных данных

—

Проверять, что MIME‑тип каждого загружаемого файла соответствует формату репозитория

Опция, которая включает проверку соответствия MIME-типов всех файлов в репозитории. VK Registry проверяет, разрешены ли обнаруженные типы для формата выбранного репозитория, и блокирует несоответствующие файлы

—

Политика развертывания

Разрешение или запрет на развертывание артефактов в репозитории.

Доступные значения:

• Запретить повторное развертывание — развертывание артефактов разрешено только один раз. Попытки перезаписать артефакты приведут к ошибке.
• Разрешить повторное развертывание — развертывание артефактов разрешено, допустима перезапись при следующих развертываниях.
• Только для чтения — развертывание артефактов запрещено

Только для локальных репозиториев

Политики очистки

Политики для управления дисковым пространством хранилища и автоматизированного удаления ненужных артефактов (подробнее — в разделе Политики очистки).

Репозиторию можно назначить несколько политик очистки

Только для локальных и прокси-репозиториев

Кешировать ответы об отсутствии контента в удаленном репозитории

Опция, которая включает кеширование ответа 404 Not Found от удаленного репозитория.

Отключение кеша снижает производительность

Только для прокси-репозиториев

TTL кеша для отсутствующего контента, мин

Время кеширования ответа 404 Not Found в минутах. В течение этого времени репозиторий будет кешировать ответ, прежде чем выполнит повторный запрос артефакта

Только для прокси-репозиториев

Блокировать запросы к удаленному репозиторию

Опция, которая запрещает прокси-репозиторию отправлять запросы удаленному репозиторию

Только для прокси-репозиториев

Автоматически блокировать запросы к удаленному репозиторию, если он недоступен

Опция, которая автоматически блокирует прокси-репозиторий при недоступности удаленного

Только для прокси-репозиториев

HTTP

Опция, которая позволяет настроить предоставление учетных данных удаленным репозиториям, в которых нужно проходить аутентификацию.

Параметры настройки:

• Тип аутентификации — тип аутентификации в удаленном репозитории.
• Имя пользователя и Пароль — учетные данные

Только для прокси-репозиториев

Настройки HTTP-запросов

Опция, которая позволяет настроить HTTP-запросы к удаленному репозиторию.

Параметры настройки:

• Повторные попытки подключения — количество попыток подключения после первоначального тайм-аута.
• Пользовательский фрагмент для добавления к заголовку User-Agent — пользовательский HTTP-заголовок.
• Тайм-аут подключения в секундах — интервал ожидания для HTTP-запросов в секундах.
• Разрешить циклические перенаправления — опция, которая разрешает прокси-репозиториям совершать перенаправления из удаленного репозитория, даже если они указывают на уже обработанный URL-адрес.
• Разрешить cookies — опция, которая сохраняет состояние аутентификации, благодаря использованию файлов cookie удаленного репозитория.
• Использовать хранилище доверенных сертификатов — опция, которая включает принудительное использование хранилища доверенных сертификатов VK Registry для получения SSL-сертификата удаленного репозитория

Только для прокси-репозиториев

Репозитории-участники

Список локальных и прокси-репозиториев, которые входят в состав группового репозитория.

Только для групповых репозиториев

Дистрибутив

Название дистрибутива в репозитории. Примеры: focal, bionic.

Только для репозиториев APT

Плоский репозиторий

Опция, которую нужно включить, если удаленный репозиторий не использует стандартную иерархию каталогов dists

Только для прокси-репозиториев APT

Закрытый ключ GPG и Парольная фраза

Закрытый ключ GPG и парольная фраза этого ключа

Только для:

• локальных репозиториев APT,

• групповых и прокси-репозиториев Yum

Версии артефактов

Тип артефактов, хранящихся в репозитории.

Доступные значения:

• RELEASE — для хранения артефактов релизных версий.
• SNAPSHOT — для хранения артефактов нестабильных или разрабатываемых версий.
• MIXED — для хранения артефактов всех типов версий

Только для локальных и прокси-репозиториев Maven

Проверять, что все пути относятся к артефактам или метаданным Maven

Опция, которую нужно включить, если структура каталогов и правила именования в этой структуре строго соответствуют стандарту Maven (подробнее — в официальной документации Maven).

Когда опция отключена, в репозитории допустимы нестандартные пути

Только для локальных и прокси-репозиториев Maven

Добавить заголовок Content-Disposition: attachment

Опция, которая включает скачивание контента в виде вложения.

Когда опция отключена, контент отображается непосредственно в окне просмотра браузера

Только для локальных и прокси-репозиториев Maven и RAW

Принудительная базовая аутентификация

Опция, которая включает аутентификацию для доступа к Docker Registry

Только для репозиториев Docker

Индекс Docker

URL-адрес каталога образов, который используется для поиска артефактов.

По умолчанию используется адрес из параметра URL-адрес удаленного репозитория. Если адрес каталога отличается, укажите его явно

Только для прокси-репозиториев Docker

Кеширование внешних слоев

Опция, которая включает кеширование внешних слоев образов Docker в репозитории VK Registry. Это позволяет клиенту Docker не взаимодействовать с другими репозиториями.

Подробнее о слоях образов — в официальной документации Docker

Только для прокси-репозиториев Docker

Разрешенные URL внешних слоев

Регулярное выражение, которое позволяет определить полные URL-адреса внешних слоев образов Docker. VK Registry разрешает загрузку только тех слоев, чьи URL-адреса соответствуют указанному выражению.

Символы .* в шаблоне обозначают переменную часть пути.

Примеры:

• https://.*\.azurecr\.io/.*,
• .* (любой URL-адрес)

Только для прокси-репозиториев Docker

Хранение кеша запросов метаданных, сек

Время в секундах, в течение которого результаты запросов к удаленному репозиторию хранятся в кеше.

При повторных идентичных запросах VK Registry использует кешированные метаданные

Только для прокси-репозиториев NuGet

Версия протокола

Версия протокола NuGet

Только для прокси-репозиториев NuGet

Глубина вложенности repodata

Уровень вложенности директории метаданных repodata и минимальная глубина вложенности соответствующих RPM-пакетов.

Если глубина вложенности RPM-пакета меньше, VK Registry отклонит его.

Пример:

• Уровень 1 — будут приняты пакеты /com/company/app/manager.rpm, /web/app/frontend-1.2.rpm и /utils/archiver.rpm.
• Уровень 2 — будут приняты пакеты /com/company/app/manager.rpm и /web/app/frontend-1.2.rpm, а пакет /utils/archiver.rpm будет отклонен

Только для локальных репозиториев Yum

Проверять, что все пути относятся к артефактам RPM или метаданным YUM

Опция, которая разрешает загрузку только тех файлов, которые относятся к Yum. Примеры: RPM-пакеты, comps.xml

Только для локальных репозиториев Yum