Registro de Artefatos

Importante

Esse recurso está em Beta. Para usá-lo, um administrador de espaço de trabalho deve ativar o Registro de Artefatos Databricks a partir da página de Prévias . Consulte Gerenciar visualizações do Azure Databricks. A Databricks anunciará os preços do Registro de Artefatos assim que ele estiver disponível de forma geral.

O Registro de Artefatos armazena imagens de contêineres como ativos governados no Unity Catalog. As imagens são armazenadas na mesma região da metastore do Unity Catalog. Use-o para enviar imagens com comandos padrão do Docker, controlar o acesso com privilégios do Catálogo Unity e disponibilizar imagens para cargas de trabalho suportadas pelo Azure Databricks.

Conceitos principais

• Artefato: Uma imagem de contêiner com nome armazenada no Unity Catalog, identificada por um nome de três níveis no formato catalog.schema.artifact.
• Tag: Um alias mutável que aponta para uma versão de artefato no formato catalog.schema.artifact:tag. Empurrar uma tag novamente pode mudar a versão para a qual a tag se resolve. Para implantações repetíveis, evite tags mutáveis, como latest, e faça referência a um digest quando a carga de trabalho oferecer suporte a referências por digest.
• Resumo da imagem: Um identificador imutável, endereçado ao conteúdo, para uma versão específica de um artefato.
• Aceleração de imagens: Uma otimização que o Azure Databricks aplica automaticamente após você enviar uma imagem elegível para o Artifact Registry. Este processo converte a imagem para um formato projetado para reduzir a latência de extração para cargas de trabalho compatíveis. Para verificar o status de aceleração de imagem de uma versão de artefato, veja Verificar status de aceleração de imagem.

Como funciona o Registro de Artefatos

Editoras e usuários trabalham com imagens de contêineres no Registro de Artefatos ao longo do seguinte ciclo de vida:

1. Compilar e enviar: Um publicador cria uma imagem, atribui a ela um nome de três níveis do Unity Catalog no formato catalog.schema.artifact:tag e a envia para o registro do espaço de trabalho. Consulte Requisitos de nomenclatura do artefato e Enviar uma imagem.
2. Governança: O Artifact Registry armazena a imagem no catálogo e esquema especificados no Unity Catalog. O Unity Catalog privilegia o controle de quem pode publicar, descobrir e ler a imagem. Veja Conceder permissões.
3. Descubra: Os usuários ligam à API de Artefatos de Software para descobrir imagens e versões disponíveis e para verificar o status da aceleração de imagens. Consulte Descobrir imagens e versões.
4. Uso: Os usuários referenciam uma imagem ao criar cargas de trabalho suportadas no Azure Databricks, como tarefas que executam imagens de contêineres personalizadas. Veja Usar imagens em cargas de trabalho suportadas do Azure Databricks.

Limitações

As seguintes limitações se aplicam:

Disponibilidade

• Seu espaço de trabalho e sua metastore do Unity Catalog devem estar na mesma região. Se as regiões forem diferentes, você não pode usar o Registro de Artefatos desse workspace.

• O Registro de Artefatos está disponível nas seguintes regiões:

  • 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

Uso suportado

• Você pode usar imagens no Artifact Registry apenas com cargas de trabalho suportadas pelo Azure Databricks. Veja Usar imagens em cargas de trabalho suportadas do Azure Databricks.
• Você não pode usar o Docker ou outro cliente de registro para puxar essas imagens ou baixar blobs de imagens diretamente.

Autenticação

• O token de acesso OAuth do workspace usado para autenticação no Docker expira após uma hora. Um push que demora mais pode falhar na autorização de uma camada carregada após a expiração. Tente novamente o push para que o assistente de credenciais Docker solicite um novo token.

Aceleração de imagem

• Imagens maiores que 30 GB não podem ser convertidas para aceleração de imagem.
• A aceleração de imagem não expõe um estado de conversão falhado. Veja Verificar o status da aceleração da imagem.

Descoberta e gestão

• O Explorador de Catálogos não fornece uma interface para imagens.
• O endpoint do registro não suporta solicitações de lista de tags ou requisições de exclusão da Open Container Initiative (OCI).
• A API de Artefatos de Software retorna no máximo 10 tags para uma versão quando mais de 10 tags apontam para o mesmo resumo.

Nomes de artefatos

• Nomes de artefatos têm restrições de caracteres e formatação. Veja Requisitos de nome de artefato.

Recursos adicionais

• Para configurar autenticação, conceder acesso, enviar uma imagem e descobrir suas versões, veja Comece com o Registro de Artefatos.
• Para resolver problemas comuns de acesso Beta, autenticação, push, descoberta e aceleração de imagens, consulte Solucionar problemas do Artifact Registry.