Artifact Registry

info

Beta

Este recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Databricks Artifact Registry na página Pré-visualizações . Consulte Gerenciar prévias do Databricks. A Databricks anunciará os preços do Artifact Registry quando ele estiver disponível de forma geral.

O Artifact Registry armazena imagens de contêiner como ativos governados no Unity Catalog. As imagens são armazenadas na mesma região que o metastore do Unity Catalog. Use-o para enviar imagens com comandos Docker padrão, controlar o acesso com privilégios do Unity Catalog e disponibilizar imagens para cargas de trabalho do Databricks compatíveis.

Conceitos-chave

• Artifact: uma imagem de contêiner nomeada 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 usando o formato catalog.schema.artifact:tag. Fazer push de uma tag novamente pode alterar a versão para a qual a tag é resolvida. Para implantações repetíveis, evite tags mutáveis como latest e faça referência a um resumo quando a carga de trabalho aceitar referências de resumo.
• Resumo da imagem: um identificador imutável endereçado por conteúdo para uma versão específica de um artefato.
• Aceleração de imagem: Uma otimização que o Databricks aplica automaticamente após você enviar uma imagem elegível para o Artifact Registry. Esse processo converte a imagem em um formato projetado para reduzir a latência de pull para cargas de trabalho suportadas. Para verificar o status de aceleração de imagem de uma versão de artefato, consulte Verificar o status de aceleração de imagem.

Como funciona o Artifact Registry

Editores e usuários trabalham com imagens de contêineres no Artifact Registry por meio do seguinte ciclo de vida:

1. Build and push: Um publisher cria uma imagem, adiciona tags a ela com um nome do Unity Catalog de três níveis no formato catalog.schema.artifact:tag e a envia para o registro do workspace. Consulte os Requisitos de nome de artefato e Enviar uma imagem.
2. Govern: O Artifact Registry armazena a imagem no catálogo e no esquema do Unity Catalog especificados. Os privilégios do Unity Catalog controlam quem pode publicar, descobrir e ler a imagem. Consulte Conceder permissões.
3. Discover: os usuários chamam a Software Artifacts API para descobrir imagens e versões disponíveis e para verificar o status de aceleração de imagem. Consulte Descobrir imagens e versões.
4. Uso: Os usuários fazem referência a uma imagem quando criam cargas de trabalho do Databricks compatíveis, como jobs com execução de imagens de contêiner personalizadas. Consulte Usar imagens em cargas de trabalho compatíveis do Databricks.

Limitações

Aplicam-se as seguintes limitações:

Disponibilidade

• O seu workspace e o metastore do Unity Catalog devem estar na mesma região. Se as regiões forem diferentes, não será possível usar o Artifact Registry a partir desse workspace.

• O Artifact Registry está disponível nas seguintes regiões:

  • asia-south1
  • asia-southeast1
  • europe-west1
  • europe-west2
  • europe-west3
  • us-central1
  • us-east1
  • us-east4
  • us-west1

Uso compatível

• Você pode usar imagens no Artifact Registry apenas com cargas de trabalho do Databricks compatíveis. Consulte Use imagens em cargas de trabalho do Databricks compatíveis.
• Não é possível usar o Docker ou outro cliente de registro para obter essas imagens ou fazer o download de blobs de imagem diretamente.

Autenticação

• O access token OAuth do workspace usado para a autenticação do Docker expira após uma hora. Um push que demorar mais pode falhar na autorização de uma camada enviada após a expiração. Tente fazer o push novamente para que o auxiliar de credenciais do Docker solicite um novo token.

Aceleração de imagem

• Imagens maiores que 30 GB não podem ser convertidas para aceleração de imagens.
• A aceleração de imagem não expõe um estado de conversão com falha. See Check image acceleration status.

Descoberta e gerenciamento

• O Catalog Explorer não fornece uma interface para imagens.
• O registro endpoint não é compatível com solicitações de lista de tags ou solicitações de exclusão do 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 digest.

Nomes de artefatos

• Os nomes de artefatos têm restrições de caracteres e formatação. Consulte Artifact name requirements.

Outros recursos

• To configure authentication, grant access, push an image, and discover its versions, see Get started with Artifact Registry.
• Para resolver problemas comuns de acesso Beta, autenticação, push, descoberta e aceleração de imagens, consulte Solucionar problemas do Artifact Registry.