Risoluzione dei problemi generali

Scopri i passaggi per la risoluzione dei problemi che si applicano a tutti i formati degli elementi quando lavori con Artifact Registry. Per problemi specifici relativi a un formato dell'elemento, consulta la pagina specifica del formato.

Repository o posizione non validi nei comandi

Utilizza le seguenti informazioni per diagnosticare errori relativi alla posizione o al nome non validi del repository.

Valori predefiniti per località e repository per gcloud

Se imposti un repository e una posizione predefiniti in Google Cloud CLI in modo da poter omettere i flag --location e --repository dai comandi gcloud artifacts, prova a eseguire il comando che non è andato a buon fine con i flag e i valori corrispondenti. Per informazioni dettagliate sulla sintassi di un determinato comando, esegui il comando con il flag --help.

L'impostazione del repository predefinito non si applica ai comandi gcloud artifacts in cui specifichi un nome del repository senza il flag --repository. Ad esempio, devi specificare il nome del repository in un comando gcloud artifacts repositories 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 posizione.

Località repository

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

gcloud artifacts locations list

I criteri della tua organizzazione potrebbero includere limitazioni di località. Artifact Registry applica queste limitazioni al momento della creazione del repository. Artifact Registry non applica i criteri in modo retroattivo ai repository precedenti alle limitazioni relative alla località.

Nomi dei repository nei comandi gcloud

Puoi elencare i repository per visualizzare i relativi nomi in un progetto o in una posizione specifica.

Per elencare tutti i repository di un progetto, esegui il comando:

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

Per elencare tutti i repository in una posizione, 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 posizione del repository.

Il comando restituisce informazioni per ogni repository simili all'esempio seguente:

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

Il valore di REPOSITORY è quello 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-west1 --repository=my-repo

Questo comando utilizza solo il nome del repository 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 del repository durante la configurazione dei client, ad esempious-west1-docker.pkg.dev/my-project/my-repo. Poi, segui le convenzioni del client per il caricamento e il download dei pacchetti. Per informazioni dettagliate sulla configurazione e sull'utilizzo del client, consulta la documentazione relativa al formato con cui stai lavorando.

Se stai eseguendo la transizione da Container Registry, tieni presente che tutti i percorsi delle immagini devono includere un nome del repository Artifact Registry. Non puoi specificare un percorso dell'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 push o pull da repository non eliminati

I repository non funzionano più correttamente dopo aver annullato l'eliminazione di un progetto Google Cloudo aver abilitato l'API Artifact Registry dopo averlo disattivato.

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

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