Реестр артефактов

Important

Эта функция доступна в бета-версии. Чтобы использовать эту функцию, администратор рабочей области должен включить Databricks Artifact Registry на странице Previews. См. статью "Управление предварительными версиями Azure Databricks". Databricks объявит цены на Artifact Registry, когда он станет доступен в общем доступе.

Реестр артефактов хранит изображения контейнеров как управляемые активы в каталоге Unity. Изображения хранятся в том же регионе, что и метастор Unity Catalog. Используйте его для отправки образов с помощью стандартных команд Docker, управления доступом с помощью привилегий Unity Catalog и предоставления образов для поддерживаемых рабочих нагрузок Azure Databricks.

Ключевые понятия

• Артефакт: Именованный контейнерный образ, хранящийся в Unity Catalog, идентифицируемый трёхуровневым именем в формате catalog.schema.artifact.
• Тег: Изменяемый псевдоним, указывающий на версию артефакта с использованием формата catalog.schema.artifact:tag. Повторная отправка тега может изменить версию, на которую указывает этот тег. Для повторяемых развертываний избегайте изменяемых тегов, таких как latest, и используйте ссылку на дайджест, если рабочая нагрузка поддерживает ссылки по дайджесту.
• Изображенный дайджест: Неизменный идентификатор с адресом содержания для конкретной версии артефакта.
• Ускорение изображения: Оптимизация, которую Azure Databricks применяет автоматически после отправки подходящего изображения в Реестр артефактов. Этот процесс преобразует изображение в формат, предназначенный для снижения задержки pull для поддерживаемых нагрузок. Чтобы проверить статус ускорения изображения версии артефакта, см. статью «Проверить статус ускорения изображения».

Как работает Реестр артефактов

Издатели и пользователи работают с изображениями контейнеров в Реестре артефактов на протяжении следующего жизненного цикла:

1. Сборка и публикация: Издатель создаёт образ, присваивает ему трёхуровневое имя Unity Catalog в формате catalog.schema.artifact:tag и отправляет его в реестр рабочей области. Смотрите требования к названию артефактов и отправку образа.
2. Управление: Реестр артефактов хранит изображение в указанном каталоге и схеме Unity Catalog. Привилегии Unity Catalog определяют, кто может публиковать, находить и читать образ. См. раздел Предоставление разрешений.
3. Узнайте: Пользователи вызывают API Software Artifacts, чтобы найти доступные изображения и версии, а также проверить статус ускорения изображений. См. Просмотр образов и версий.
4. Использование: Пользователи ссылаются на изображение при создании поддерживаемых рабочих нагрузок Azure Databricks, например, заданий, запускающих кастомные образы контейнеров.

Ограничения

Действительны следующие ограничения.

Availability

• Ваше рабочее пространство и его метахранилище Unity Catalog должны находиться в одном регионе. Если регионы различаются, вы не можете использовать Реестр артефактов из этого рабочего пространства.

• Реестр артефактов доступен в следующих регионах:

  • australiaeast
  • brazilsouth
  • canadacentral
  • centralindia
  • centralus
  • eastasia
  • eastus
  • eastus2
  • francecentral
  • germanywestcentral
  • japaneast
  • koreacentral
  • northcentralus
  • northeurope
  • southcentralus
  • southeastasia
  • swedencentral
  • switzerlandnorth
  • uaenorth
  • uksouth
  • ukwest
  • westcentralus
  • westeurope
  • westus
  • westus2
  • westus3

Поддерживаемое использование

• Вы можете использовать изображения только в Artifact Registry с поддерживаемыми рабочими нагрузками Azure Databricks.
• Нельзя использовать Docker или другой клиент реестра для прямого извлечения этих изображений или скачивания изображений.

Authentication

• Токен доступа рабочего пространства OAuth, используемый для аутентификации Docker, истекает через один час. Пуш, который длится дольше, может провалить авторизацию для слоя, загруженного после истечения срока действия. Повторите отправку, чтобы вспомогательная программа учетных данных Docker запросила новый токен.

Ускорение изображения

• Изображения размером более 30 ГБ нельзя конвертировать для ускорения изображения.
• Ускорение изображения не выявляет состояние неудачного преобразования. См. Проверить статус ускорения изображения.

Открытие и управление

• Catalog Explorer не предоставляет интерфейс для изображений.
• Конечная точка реестра не поддерживает запросы на список тегов Open Container Initiative (OCI) или запросы на удаление.
• API Software Artifacts возвращает не более 10 тегов для версии, если более 10 тегов указывают на один и тот же дайджест.

Названия артефактов

• Имена артефактов имеют ограничения по характеру и форматированию. См. требования к названию артефактов.

Дополнительные ресурсы

• Чтобы настроить аутентификацию, предоставить доступ, отправить изображение и узнать его версии, смотрите раздел «Начать с реестра артефактов».
• Чтобы устранить типичные проблемы с доступом к бета-версии, аутентификацией, отправкой, поиском и ускорением загрузки образов, см. Устранение неполадок в Artifact Registry.