Allgemeine Fehlerbehebung

Informationen zu Schritten zur Fehlerbehebung, die für alle Artefaktformate bei der Arbeit mit Artifact Registry gelten. Informationen zu Problemen, die sich auf ein bestimmtes Artefaktformat beziehen, finden Sie auf der entsprechenden Seite.

Ungültiges Repository oder ungültiger Speicherort in Befehlen

Anhand der folgenden Informationen können Sie Fehler bei ungültigem Repository-Speicherort oder ungültigem Repository-Namen diagnostizieren.

Standardspeicherort und -repository für gcloud

Wenn Sie in der Google Cloud CLI ein standardmäßiges Repository und einen standardmäßigen Speicherort festgelegt haben, sodass Sie die Flags --location und --repository bei gcloud artifacts-Befehlen weglassen können, führen Sie den fehlgeschlagenen Befehl mit den Flags und den entsprechenden Werten aus. Wenn Sie Details zur Syntax eines bestimmten Befehls benötigen, führen Sie den Befehl mit dem Flag --help aus.

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

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

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

Speicherort des Repositories

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

gcloud artifacts locations list

Ihre Organisationsrichtlinien enthalten möglicherweise Standorteinschränkungen. Diese Einschränkungen werden von Artifact Registry beim Erstellen des Repositories erzwungen. In Artifact Registry werden Richtlinien nicht rückwirkend auf Repositories angewendet, die vor den Standortbeschränkungen erstellt wurden.

Repository-Namen in gcloud-Befehlen

Sie können Repositories auflisten, um die Repository-Namen in einem bestimmten Projekt oder an einem bestimmten Speicherort aufzurufen.

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 Speicherort 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 Repositories.

Der Befehl gibt Informationen für jedes Repository zurück, die in etwa so aussehen:

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

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-west1 --repository=my-repo

Bei diesem Befehl wird nur der Repository-Name ohne Flag verwendet:

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

Repository-Namen mit Drittanbieter-Clients

Bei Drittanbieterclients verwenden Sie beim Konfigurieren von Clients in der Regel einen vollständigen Repositorypfad, z. B. us-west1-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 Verwendung finden Sie in der Dokumentation für das verwendete Format.

Wenn Sie von Container Registry migrieren, müssen alle Imagepfade den Namen eines Artifact Registry-Repositories enthalten. Sie können keinen Bildpfad 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

Push- oder Pull-Vorgänge von nicht gelöschten Repositories sind nicht möglich

Repositories funktionieren nicht mehr richtig, wenn Sie die Wiederherstellung eines Google Cloud Projekts rückgängig machen oder die Artifact Registry API nach der Deaktivierung wieder aktivieren.

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

Weitere Informationen zum Löschen von Daten in Google Cloud