Allgemeine Fehlerbehebung

Informationen zur Fehlerbehebung für alle Artefaktformate bei der Arbeit mit Artifact Registry. 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 mit ungültigen Repository-Standorten oder ungültigen Repository-Namen zu diagnostizieren.

Standardeinstellungen für Speicherort und Repository für gcloud

Wenn Sie in der Google Cloud CLI ein Standard-Repository und einen Speicherort festgelegt haben, sodass Sie die Flags --location und --repository in den gcloud artifacts-Befehlen weglassen können, versuchen Sie, den Befehl auszuführen, der mit den Flags und den entsprechenden Werten fehlgeschlagen ist. Wenn Sie weitere Informationen zur Syntax eines bestimmten Befehls wünschen, führen Sie den Befehl mit dem Flag --help aus.

Die Standardeinstellung für das Repository gilt nicht für gcloud artifacts-Befehle, bei denen Sie einen Repository-Namen ohne das Flag --repository angeben. Beispiel: Sie müssen den Namen des Repositorys in einem Befehl von gcloudartefiziere beschreiben angeben, wie im folgenden Beispiel gezeigt:

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

Wenn der Befehl immer noch fehlschlägt, müssen Sie möglicherweise prüfen, ob Sie gültige Werte für das Repository oder den Standort 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 umfassen. Artifact Registry erzwingt diese Einschränkungen zum Zeitpunkt der Repository-Erstellung. Artifact Registry erzwingt keine Richtlinie 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 in 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 Repository-Speicherort.

Der Befehl gibt für jedes Repository Informationen 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 Drittanbieter-Clients

Für Drittanbieter-Clients verwenden Sie in der Regel einen vollständigen Repository-Pfad, wenn Sie Clients wie us-east1-docker.pkg.dev/my-project/my-repo konfigurieren. Folgen Sie dann den Konventionen des Clients für das Hoch- und Herunterladen von Paketen. Details zur Clientkonfiguration und -nutzung finden Sie in der Dokumentation zum Format, mit dem Sie arbeiten.

Wenn Sie von Container Registry umstellen, müssen alle Image-Pfade einen Artifact Registry-Repository-Namen enthalten. 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

Nicht gelöschte Repositories können nicht per Push oder Pull abgerufen werden

Repositories funktionieren nach dem Wiederherstellen eines Google Cloud-Projekts nicht mehr richtig. Alternativ aktivieren Sie die Artifact Registry API nach der Deaktivierung.

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 7 Tagen.

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