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 di un formato di artefatto, consulta la pagina specifica del formato.

Repository o posizione non validi nei comandi

Utilizza le seguenti informazioni per diagnosticare errori relativi a un percorso del repository non valido o a un nome del repository non valido.

Impostazioni predefinite di posizione e repository per gcloud

Se hai impostato un repository e una località predefiniti in Google Cloud CLI in modo da poter 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 informazioni dettagliate sulla sintassi di un comando specifico, esegui il comando con il flag --help.

L'impostazione predefinita del repository 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 il seguente:

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

Se il comando continua a non funzionare, potrebbe essere necessario verificare di aver specificato valori validi per il repository o la posizione.

Località repository

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

gcloud artifacts locations list

La policy della tua organizzazione potrebbe includere limitazioni della posizione. 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 della località.

Nomi dei repository nei comandi gcloud

Puoi elencare i repository per visualizzare i nomi dei repository in un progetto o in una posizione specifici.

Per elencare tutti i repository in un progetto, esegui il 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 posizione del repository.

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

REPOSITORY: my-repo
FORMAT: DOCKER
DESCRIPTION:
LOCATION: us-west1
LABELS:
ENCRYPTION: Google-owned and Google-managed encryption 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 quando configuri i client, ad esempio us-west1-docker.pkg.dev/my-project/my-repo. Segui poi le convenzioni del client per caricare e scaricare i pacchetti. Per informazioni dettagliate sulla configurazione e sull'utilizzo del client, consulta la documentazione relativa al formato con cui stai lavorando.

Se esegui 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 il push o il pull dai repository non eliminati

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

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

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

Errore durante il pull del file collaterale Prometheus per Cloud Run in un perimetro di servizio

Utilizzi Artifact Registry con i Controlli di servizio VPC e tenti di eseguire il pull dell'immagine del sidecar Prometheus per Cloud Run all'interno di un perimetro di servizio. Ricevi un errore 403 permission denied.

Per risolvere il problema, consenti l'uscita al progetto cloud-ops-agents-artifacts nella regola in uscita che hai configurato per utilizzare mirror.gcr.io nel perimetro di servizio. Per farlo, aggiungi projects/1042947621568 come risorsa nella regola in uscita.