Allgemeine Fehlerbehebung

Informationen zu Schritten zur Fehlerbehebung, die bei der Arbeit mit Artifact Registry für alle Artefaktformate gelten. Informationen zu Problemen mit einem Artefaktformat finden Sie auf der formatspezifischen Seite.

Ungültiges Repository oder ungültiger Speicherort in Befehlen

Verwenden Sie die folgenden Informationen, um Fehler aufgrund von ungültigen Repository-Speicherorten oder ungültigen Repository-Namen zu diagnostizieren.

Standort- und Repository-Standardeinstellungen für gcloud

Wenn Sie in der Google Cloud CLI ein Standard-Repository und einen Speicherort festlegen, sodass Sie die Flags --location und --repository von gcloud artifacts-Befehlen weglassen können, versuchen Sie, den fehlgeschlagenen Befehl mit den Flags und den entsprechenden Werten auszuführen. Details zur Syntax eines bestimmten Befehls erhalten Sie, wenn Sie den Befehl mit dem Flag --help ausführen.

Die Standard-Repository-Einstellung gilt nicht für gcloud artifacts-Befehle, bei denen Sie einen Repository-Namen ohne das Flag --repository angeben. Beispielsweise müssen Sie den Repository-Namen wie im folgenden Beispiel in einem Befehl gcloudZulassende Repositories angeben angeben:

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

Wenn der Befehl weiterhin fehlschlägt, müssen Sie möglicherweise überprüfen, ob Sie für das Repository oder den Speicherort gültige Werte angegeben haben.

Speicherort des Repositories

Führen Sie den folgenden Befehl aus, um alle unterstützten Artifact Registry-Speicherorte aufzulisten:

gcloud artifacts locations list

Ihre Organisationsrichtlinie kann Standortbeschränkungen enthalten. Artifact Registry erzwingt diese Einschränkungen zum Zeitpunkt der Repository-Erstellung. Artifact Registry erzwingt Richtlinien nicht rückwirkend für Repositories, die vor den Standorteinschränkungen liegen.

Repository-Namen in gcloud-Befehlen

Sie können Repositories auflisten, um die Repository-Namen an einem bestimmten Projekt oder an einem bestimmten Standort anzusehen.

Führen Sie den folgenden Befehl aus, um alle Repositories in einem Projekt aufzulisten:

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

Führen Sie den folgenden Befehl aus, um alle Repositories an einem Standort aufzulisten:

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

Ersetzen Sie PROJECT-ID durch Ihre Google Cloud-Projekt-ID und LOCATION durch den Speicherort des Repositorys.

Der Befehl gibt Informationen für jedes Repository zurück, ähnlich wie im folgenden Beispiel:

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

Der Wert für REPOSITORY ist der Wert, den Sie mit gcloud artifacts-Befehlen verwenden, die den Repository-Namen als Parameter enthalten.

In diesem Befehl wird beispielsweise das Flag --repository verwendet:

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

Dieser Befehl verwendet den Repository-Namen nur ohne Flag:

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

Repository-Namen mit Drittanbieterclients

Bei Clients von Drittanbietern verwenden Sie in der Regel einen vollständigen Repository-Pfad, wenn Sie Clients konfigurieren, z. B. us-east1-docker.pkg.dev/my-project/my-repo. Anschließend folgen Sie den Konventionen des Clients zum Hoch- und Herunterladen von Paketen. Informationen zur Clientkonfiguration und zur Nutzung finden Sie in der Dokumentation für das Format, mit dem Sie arbeiten.

Beachten Sie bei der Umstellung von Container Registry, dass alle Image-Pfade einen Artifact Registry-Repository-Namen enthalten müssen. Sie können keinen Image-Pfad angeben, der nur eine Projekt-ID enthält.

  • Ungültiger Pfad: us-east1-docker.pkg.dev/my-project/my-image
  • Gültiger Pfad: us-east1-docker.pkg.dev/my-project/my-repo/my-image

Daten aus nicht gelöschten Repositories können nicht hoch- oder abgerufen werden

Repositories funktionieren nicht mehr ordnungsgemäß, wenn Sie ein Google Cloud-Projekt wiederherstellen oder die Artifact Registry API nach der Deaktivierung aktivieren.

Wenn Sie die Artifact Registry API deaktivieren oder das Projekt löschen, sind die Artifact Registry-Dienste nicht mehr verfügbar. Artifact Registry löscht Repository-Daten nach sieben Tagen.

Weitere Informationen zum Löschen von Daten in Google Cloud.