Risoluzione dei problemi generali

Scopri i passaggi per la risoluzione dei problemi che si applicano a tutti i formati degli artefatti quando utilizzi Artifact Registry. Per problemi specifici relativi a un formato dell'elemento, fai riferimento alla pagina specifica del formato.

Repository o posizione non validi nei comandi

Utilizza le seguenti informazioni per diagnosticare più facilmente gli errori di località del repository o nomi di repository non validi.

Impostazioni predefinite per località e repository per gcloud

Se imposti un repository e una località predefiniti in Google Cloud CLI in modo da omettere i flag --location e --repository dai comandi gcloud artifacts, prova a eseguire il comando non riuscito con i flag e i valori corrispondenti. Per maggiori dettagli sulla sintassi di un determinato comando, esegui il comando con il flag --help.

L'impostazione predefinita del repository non si applica ai comandi gcloud artifacts in cui specifichi un nome repository senza il flag --repository. Ad esempio, devi specificare il nome del repository in un comando gcloud artefatti repository describe come nell'esempio seguente:

gcloud artifacts repositories describe my-repo --location=us-west1

Se il comando continua a non riuscire, potresti dover verificare di aver specificato valori validi per il repository o la località.

Località repository

Per elencare tutte le località di Artifact Registry supportate, esegui il comando:

gcloud artifacts locations list

Il criterio dell'organizzazione potrebbe includere limitazioni relative alla località. Artifact Registry applica queste limitazioni al momento della creazione del repository. Artifact Registry non applica i criteri in modo retroattivo ai repository anteceduti alle limitazioni di località.

Nomi dei repository nei comandi gcloud

Puoi elencare i repository per visualizzare i nomi in un progetto o una località specificati.

Per elencare tutti i repository in un progetto, esegui questo comando:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=all

Per elencare tutti i repository in una località, esegui il comando:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=LOCATION

Sostituisci PROJECT-ID con l'ID progetto Google Cloud e LOCATION con la località del repository.

Il comando restituisce informazioni per ogni repository simili al seguente esempio:

REPOSITORY: my-repo
FORMAT: MAVEN
DESCRIPTION:
LOCATION: us-east1
LABELS:
ENCRYPTION: Google-managed key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10

Il valore di REPOSITORY è il valore che utilizzi con i comandi gcloud artifacts che includono il nome del repository come parametro.

Ad esempio, questo comando utilizza il flag --repository:

gcloud artifacts packages list --location=us-east1 --repository=my-repo

Questo comando utilizza il nome del repository solo senza un flag:

gcloud artifacts repositories describe my-repo --location=us-west1

Nomi dei repository con client di terze parti

Per i client di terze parti, in genere utilizzi un percorso completo per il repository durante la configurazione dei client, ad esempio us-east1-docker.pkg.dev/my-project/my-repo. Successivamente, segui le convenzioni del client per il caricamento e il download dei pacchetti. Per i dettagli di utilizzo e configurazione del client, consulta la documentazione relativa al formato che stai utilizzando.

Se stai passando da Container Registry, tieni presente che tutti i percorsi delle immagini devono includere il nome di un repository Artifact Registry. Non puoi specificare un percorso immagine che includa solo un ID progetto.

  • Percorso non valido: us-east1-docker.pkg.dev/my-project/my-image
  • Percorso valido: us-east1-docker.pkg.dev/my-project/my-repo/my-image

Impossibile eseguire il push o il pull da repository non eliminati

I repository non funzionano più correttamente dopo l'annullamento dell'eliminazione di un progetto Google Cloud o l'abilitazione dell'API Artifact Registry dopo la disabilitazione.

Se disabiliti l'API Artifact Registry o elimini il progetto, i servizi Artifact Registry diventeranno non disponibili. Artifact Registry elimina i dati del repository dopo 7 giorni.

Scopri di più sull'eliminazione dei dati su Google Cloud.