Registo de Artefactos

Importante

Este recurso está em versão Beta. Para o utilizar, um administrador do espaço de trabalho deve ativar o Registo de Artefactos Databricks a partir da página de Pré-visualizações . Ver Gerir as pré-visualizações de Azure Databricks. A Databricks anunciará os preços do Registo de Artefactos assim que este estiver disponível de forma geral.

O Registo de Artefactos armazena imagens de contentores como ativos governados no Unity Catalog. As imagens são armazenadas na mesma região da metastore do Unity Catalog. Utilize-o para enviar imagens com comandos padrão do Docker, controlar o acesso com privilégios do Unity Catalog e disponibilizar imagens para cargas de trabalho suportadas no Azure Databricks.

Conceitos-chave

• Artefacto: Uma imagem de contentor nomeada armazenada no Unity Catalog, identificada por um nome de três níveis no formato catalog.schema.artifact.
• Etiqueta: Um alias mutável que aponta para uma versão de artefacto usando o formato catalog.schema.artifact:tag. Voltar a pressionar uma etiqueta pode alterar a versão para a qual a etiqueta se resolve. Para implementações repetíveis, evite etiquetas mutáveis como latest e referenciar um resumo quando a carga de trabalho aceitar referências de resumo.
• Resumo da imagem: Um identificador imutável, endereçado ao conteúdo, para uma versão específica de um artefacto.
• Aceleração de imagens: Uma otimização que o Azure Databricks aplica automaticamente depois de enviar uma imagem elegível para o Registo de Artefactos. Este processo converte a imagem para um formato concebido para reduzir a latência de pull para cargas de trabalho suportadas. Para verificar o estado de aceleração de imagem de uma versão de artefacto, consulte Verificar estado de aceleração de imagem.

Como funciona o Registo de Artefactos

Editores e utilizadores trabalham com imagens de contentores no Registo de Artefactos ao longo do seguinte ciclo de vida:

1. Construir e enviar: Um editor constrói uma imagem, etiqueta-a com um nome de Catálogo Unity de três níveis no formato catalog.schema.artifact:tage envia-a para o registo do workspace. Veja Requisitos de nome do artefacto e Enviar uma imagem.
2. Governação: O Artifact Registry armazena a imagem no catálogo e no schema especificados do Unity Catalog. O Unity Catalog privilegia o controlo de quem pode publicar, descobrir e ler a imagem. Ver Conceder permissões.
3. Descobrir: Os utilizadores recorrem à API de Artefactos de Software para descobrir imagens e versões disponíveis e para verificar o estado da aceleração da imagem. Ver imagens e versões do Discover.
4. Utilização: Os utilizadores referenciam uma imagem quando criam cargas de trabalho suportadas pelo Azure Databricks, como tarefas que executam imagens de contentores personalizadas. Veja Usar imagens em cargas de trabalho Azure Databricks suportadas.

Limitações

Aplicam-se as seguintes limitações:

Availability

• O seu espaço de trabalho e a metastore do Unity Catalog devem estar na mesma região. Se as regiões diferirem, não podes usar o Registo de Artefactos a partir desse espaço de trabalho.

• O Registo de Artefactos 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

Utilização suportada

• Podes usar imagens no Artifact Registry apenas com cargas de trabalho Azure Databricks suportadas. Veja Usar imagens em cargas de trabalho Azure Databricks suportadas.
• Não pode usar o Docker ou outro cliente de registo para extrair estas imagens ou descarregar blobs de imagens diretamente.

Authentication

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

Aceleração de imagem

• Imagens superiores a 30 GB não podem ser convertidas para aceleração de imagem.
• A aceleração da imagem não expõe um estado de conversão falhado. Ver Verificar o estado da aceleração da imagem.

Descoberta e gestão

• O Explorador de Catálogos não fornece uma interface para imagens.
• O endpoint do registo não suporta pedidos de lista de etiquetas da Open Container Initiative (OCI) nem pedidos de eliminação.
• A API Software Artifacts devolve no máximo 10 etiquetas para uma versão quando mais de 10 etiquetas apontam para o mesmo digest.

Nomes de artefactos

• Os nomes dos artefactos têm restrições de caracteres e formatação. Ver requisitos para nomes de artefactos.

Recursos adicionais

• Para configurar autenticação, conceder acesso, enviar uma imagem e descobrir as suas versões, consulte Começar com o Registo de Artefactos.
• Para resolver problemas comuns de acesso Beta, autenticação, push, descoberta e aceleração de imagens, consulte Troubleshoot Artifact Registry.