Risoluzione dei problemi di Artifact Registry

Importante

Questa funzionalità è in versione beta. Per usarlo, un amministratore dell’area di lavoro deve attivare Databricks Artifact Registry dalla pagina Previews. Vedere Gestire le anteprime di Azure Databricks. Databricks annuncierà i prezzi per Artefact Registry quando sarà generalmente disponibile.

Usa questa pagina per risolvere problemi comuni con Registro degli Artefatti. Per l'installazione completa e il flusso di lavoro di push delle immagini, vedi Inizia con Registro degli Artefacti.

Problemi di accesso alla beta

Registro degli Artefatti non è abilitato

Chiedi a un amministratore dell’area di lavoro di abilitare Databricks Artifact Registry nella pagina Previews dell’area di lavoro. Se l'anteprima non è disponibile, verifica che lo spazio di lavoro si trovi in una regione che supporti Registro degli Artefatti. Vedere Limitazioni.

Lo stato di anteprima è temporaneamente non disponibile

Ripetere l'operazione. Se l'errore persiste, raccogli i dettagli dell'errore e richiedi l'ID, se presente, quando richiedi aiuto.

Problemi di autenticazione Docker

Il comando di autenticazione Docker non è disponibile

Installa o aggiorna la CLI (interfaccia da riga di comando) Databricks alla versione minima supportata nei Prerequisiti, poi esegue di nuovo databricks auth docker configure .

Docker non può ottenere le credenziali del registro

Crea o aggiorna un profilo OAuth per il workspace, configura Docker per il registro workspace e riprova l'operazione Docker. Eseguire i comandi seguenti:

databricks auth login --profile <profile>
databricks auth docker configure --profile <profile>

Verifica che questo <profile> indichi lo spazio di lavoro previsto. Se usi il profilo predefinito, ometti --profile <profile> il comando di autenticazione Docker.

L'aiutante delle credenziali Docker non supporta profili che utilizzano token di accesso personale, credenziali OAuth machine-to-machine (M2M) o autenticazione solo account. Per i passaggi completi dell'autenticazione, vedi Configura autenticazione Docker.

Un push di lunga durata restituisce un errore di autorizzazione

L'aiutante delle credenziali Docker fornisce un token di accesso OAuth per uno spazio di lavoro di breve durata. Se un push di lunga durata restituisce un errore di autorizzazione, riprovare docker push in modo che l'aiutante delle credenziali richieda un nuovo token. Per la durata della credenziale, vedi Limitazioni.

Il nome host del registro non corrisponde

Esegui databricks auth docker host --profile <profile> per controllare il nome host del registro e lo stato dell'aiutante delle credenziali Docker per il profilo selezionato. Verifica che il profilo faccia riferimento allo spazio di lavoro previsto. Rietichetta l'immagine con il nome host corretto del registro prima di riprovare a eseguire un push.

Problemi di push dell'immagine

Il push restituisce un errore di permesso

Verifica che il principale abbia i privilegi necessari per l'operazione push. Vedi Concedere permessi.

Il nome dell'immagine non è accettato

Usa il formato <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>. Per i requisiti di segmento di artefatto, vedi Requisiti di nome di artefatto.

Il catalogo o lo schema non esiste

Artefact Registry non crea cataloghi o schemi. Il catalogo target e lo schema devono già esistere nel Catalogo Unity ed essere accessibili dall'area di lavoro. Crea l'oggetto mancante o usa un catalogo e uno schema esistenti, poi verifica i privilegi necessari prima di riprovare il push.

Problemi di scoperta di immagini

L'immagine o la versione non appare

Conferma che il push di Docker sia stato completato con successo e che stai elencando lo stesso catalogo, schema e nome di artefatto che hai pubblicato. Usa l'API Software Artifacts invece dell'endpoint del registro per elencare artefatti e versioni. Vedi immagini e versioni di Discover.

Un'operazione di registro non è supportata

L'endpoint del registro non supporta questa operazione. Usa l'API Software Artifacts per scoprire immagini e versioni. Per le restrizioni, vedi Limitazioni.

Problemi di accelerazione dell'immagine

L'accelerazione dell'immagine rimane UNSPECIFIED

UNSPECIFIED non indica un guasto. Vedi Limitazioni per l'idoneità all'accelerazione dell'immagine, incluso il limite di dimensione dell'immagine. Le immagini più grandi e idonee richiedono più tempo per essere convertite. Controlla di nuovo lo stato più tardi. Se un'immagine idonea non raggiunge SUCCESS dopo diverse ore, contatta l'assistenza Databricks. Per le definizioni di stato, consulta Verifica lo stato dell'accelerazione delle immagini.

Ottieni assistenza

Quando richiedi aiuto, includi le seguenti informazioni:

• Il cloud, la regione, l'URL dello spazio di lavoro e la versione della CLI di Databricks.
• Il comando che è fallito e il suo messaggio di errore completo.
• L'hostname del registro e il nome catalog.schema.artifact:tag.
• Il digest dell'immagine, l'ID della richiesta API e il timestamp dell'operazione, se disponibili.

Condividi queste informazioni solo tramite un canale di supporto privato. Non pubblicare gli URL dell'area di lavoro, i nomi host del registro, i nomi degli artefatti o gli errori completi nei forum pubblici.

Rimuovi token, password e credenziali del registro dai messaggi di errore, dall'output dei comandi e da altre diagnostiche prima di condividerli.