После создания кеширующего реестра вы можете:
управлять возможностью хранения артефактов в кеше;
задавать время хранения артефактов;
выбирать способ удаления артефактов после истечения срока хранения.
Использование реестра в режиме зеркала
В личном кабинете перейдите в раздел Artifact Registry → Реестры.
Выберите нужный реестр.
В строке реестра откройте меню
и выберите Настройки.Активируйте опцию Зеркало.
Нажмите Сохранить.
Режим начинает действовать сразу. Артефакты будут скачиваться напрямую из стороннего хранилища и в кеше реестра Artifact Registry храниться не будут. Если ранее в кеше были сохранены артефакты, они удалятся безвозвратно после истечения срока их хранения.
Использование реестра в режиме хранилища артефактов
В личном кабинете перейдите в раздел Artifact Registry → Реестры.
Выберите нужный реестр.
В строке реестра откройте меню
и выберите Настройки.Активируйте опцию TTL.
Укажите срок хранения артефактов:
Хранение изменяемых артефактов в кеше — для изменяемых артефактов, например, списки и метаданные значение по умолчанию 1 час.
Хранение неизменяемых артефактов в кеше — для неизменяемых артефактов, например, слои и пакеты значение по умолчанию 168 часов.
Выберите способ удаления артефактов:
Мягкое удаление — после истечения срока хранения артефакты будут помечены как устаревшие, но останутся в кеше.
Если при запросе артефакта стороннее хранилище окажется недоступным или артефакт будет удален из него, то этот артефакт загрузится из кеша даже после истечения срока хранения.
Жесткое удаление — после истечения срока хранения артефакты будут удалены из кеша безвозвратно.
Нажмите Сохранить.
Когда пользователь запрашивает артефакт, проверяется срок хранения артефакта (TTL) и его наличие в кеше:
Если срок хранения не истек и артефакт есть в кеше, пользователю отдается артефакт из кеша.
Если срок хранения истек и артефакт есть в кеше, запрашивается новая версия артефакта из стороннего хранилища:
Хранилище доступно — актуальная версия артефакта скачивается и обновляется в кеше реестра. Затем артефакт отдается пользователю.
Хранилище недоступно — пользователь получает артефакт из кеша реестра.
Если артефакта нет в кеше, артефакт скачивается из стороннего хранилища и сохраняется в кеше реестра. Затем артефакт отдается пользователю.
Если стороннее хранилище недоступно, пользователь получит в ответ ошибку.
Артефакт отдается с пометкой в HTTP-заголовке X-Artifact-Registry-Stale:
false — артефакт актуальный;
true — артефакт устарел, срок его хранения вышел и актуальность во внешнем хранилище не проверена.