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 Registro de Artefatos armazena imagens de contêineres como ativos governados no Unity Catalog. Use-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 compatíveis do Databricks.

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. Use: Users reference an image when they create supported Databricks workloads, such as jobs that run custom container images.

Limitações

Aplicam-se as seguintes limitações:

• Availability :

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

    • ap-northeast-1
    • ap-northeast-2
    • ap-south-1
    • ap-southeast-1
    • ap-southeast-2
    • ca-central-1
    • eu-central-1
    • eu-north-1
    • eu-west-1
    • eu-west-2
    • eu-west-3
    • sa-east-1
    • us-east-1
    • us-east-2
    • us-west-2

• Uso compatível :

  • Você pode usar imagens no Artifact Registry somente com 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.