Troubleshoot Artifact Registry
Beta
Este recurso está em Beta. To use it, a workspace admin must turn on Databricks Artifact Registry from the Previews page. Consulte Gerenciar prévias do Databricks. A Databricks anunciará os preços do Artifact Registry quando ele estiver disponível de forma geral.
Use esta página para resolver problemas comuns com o Artifact Registry. Para obter instruções completas de configuração e o fluxo de trabalho de envio de imagem, consulte Get started with Artifact Registry.
Problemas de acesso ao Beta
O Artifact Registry não está habilitado
Solicite a um administrador do workspace que ative o Databricks Artifact Registry na página Pré-visualizações do workspace. Se a visualização não estiver disponível, verifique se o workspace está em uma região que oferece suporte ao Artifact Registry. Consulte Limitações.
O status de visualização está temporariamente indisponível
Retry the operation. If the error persists, collect the error details and request ID, if present, when you request help.
Problemas de autenticação do Docker
O comando de autenticação do Docker está indisponível
Instale ou atualize a CLI do Databricks (interface de linha de comando) para a versão mínima compatível em Prerequisites e, em seguida, execute databricks auth docker configure novamente.
O Docker não consegue obter as credenciais do registro
Crie ou refresh um perfil OAuth de workspace, configure o Docker para a região do registro e repita a operação do Docker. Execute os seguintes comandos:
databricks auth login --profile <profile>
databricks auth docker configure --profile <profile> --region <region>
Verify that <profile> points to the intended workspace. Se você usar o perfil default, omita --profile <profile> do comando de autenticação do Docker.
O auxiliar de credenciais do Docker não oferece suporte a perfis que usam personal access tokens, credenciais de máquina para máquina (M2M) do OAuth ou autenticação somente de account. Para ver os passos de autenticação completos, consulte Configurar a autenticação do Docker.
Uma operação de push de longa duração retorna um erro de autorização
O auxiliar de credenciais do Docker fornece um access token OAuth do workspace de curta duração. Se um push de longa execução retornar um erro de autorização, tente novamente docker push para que o auxiliar de credenciais solicite um novo token. Para obter a vida útil da credencial, consulte Limitações.
O hostname ou a região do registro não correspondem
Verifique se o hostname do registro corresponde à mesma cloud e região passadas para databricks auth docker configure. Verifique também se o perfil da CLI do Databricks selecionado aponta para o Workspace pretendido. Renomeie a tag da imagem com o hostname do registro correto antes de tentar um novo envio.
Problemas de envio de imagem
O push retorna um erro de permissão
Verify that the principal has the privileges required for the push operation. Consulte Conceder permissões.
O nome da imagem foi rejeitado
Use o formato <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>. Para os requisitos do segmento de artefatos, consulte Requisitos de nome de artefato.
O catálogo ou o esquema não existe
O Artifact Registry não cria catálogos ou esquemas. O catálogo e o esquema de destino já devem existir no Unity Catalog e estar acessíveis a partir do workspace. Crie o objeto ausente ou use um catálogo e esquema existentes e, em seguida, verifique os privilégios necessários antes de tentar o push novamente.
Problemas de descoberta de imagens
The image or version does not appear
Confirme se o envio (push) para o Docker foi concluído com êxito e se você está listando o mesmo catálogo, esquema e nome de artefato enviados. Use a API de artefatos de software (Software Artifacts API) em vez do endpoint de registro para listar artefatos e versões. Consulte Descobrir imagens e versões.
Uma operação de registry não é suportada
O endpoint do registro não é compatível com esta operação. Use a API de Software Artifacts para descobrir imagens e versões. Para ver as restrições, consulte Limitações.
Problemas de aceleração de imagem
A aceleração de imagem permanece UNSPECIFIED
UNSPECIFIED não identifica uma falha. See Limitations for image acceleration eligibility, including the image size limit. Imagens elegíveis maiores demoram mais para serem convertidas. Verifique o status novamente mais tarde. Se uma imagem elegível não alcançar SUCCESS após várias horas, entre em contato com o suporte do Databricks. Para ver as definições de status, consulte Verificar o status da aceleração de imagem.
Obter ajuda
Quando você solicitar ajuda, inclua a seguinte informação:
- O cloud, a região, o URL do workspace e a versão da CLI do Databricks.
- O comando que falhou e sua mensagem de erro completa.
- O hostname do registro e o nome de
catalog.schema.artifact:tag. - O resumo da imagem, o ID da solicitação da API e o Timestamp da operação, se disponíveis.
Compartilhe esta informação apenas por meio de um canal de suporte privado. Do not post workspace URLs, registry hostnames, artifact names, or complete errors in public forums.
Remova tokens, senhas e credenciais de registro das mensagens de erro, da saída de comandos e de outros diagnósticos antes de compartilhá-los.