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.

Standardeinstellungen für Speicherort und Repository für gcloud

Wenn Sie in der Google Cloud CLI ein Standard-Repository und einen Standardspeicherort festlegen damit Sie die Flags --location und --repository gcloud artifacts-Befehle verwenden können, versuchen Sie, den mit der Flags und entsprechende Werte. Einzelheiten zur Syntax für eine bestimmte 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 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 überprüfen, ob Sie einen gültigen für das Repository oder den Speicherort.

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 bei der Repository-Erstellung 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 anzusehen oder einen bestimmten Standort haben.

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

Der Befehl gibt Informationen für jedes Repository wie die folgenden zurück: 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

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 Drittanbieter-Clients verwenden Sie beim Konfigurieren von Clients in der Regel einen vollständigen Repository-Pfad, z. B. us-east1-docker.pkg.dev/my-project/my-repo. Ich und folgen dann den Client-Konventionen zum Hoch- und Herunterladen Pakete. Informationen zur Konfiguration und Nutzung von Clients finden Sie in der Dokumentation für das Format, mit dem Sie arbeiten.

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 nach dem Wiederherstellen einer Google Cloud Projekt erstellen oder die Artifact Registry API nach der Deaktivierung aktivieren.

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

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