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