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.
- Container-Images: Container-Images, Helm-Diagramme
- Sprachpakete: Java, Node.js, Python
- Betriebssystempakete
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.
- Container-Images: Docker, Helm
- Sprachpakete: Java, Node.js, Python, Go
- Betriebssystempakete: Debian, RPM
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.