Probleme mit Container-Images beheben

Hier finden Sie nützliche Informationen über die schrittweise Fehlerbehebung bei Problemen mit der Verwaltung von Container-Images in Artifact Registry.

Syntax der Projekt-ID in der Docker CLI

Da Docker Doppelpunkte anders behandelt, müssen Sie in der Docker CLI Doppelpunkte (:) in Ihrer Projekt-ID durch einen Schrägstrich (/) ersetzen. Wenn Ihre Projekt-ID beispielsweise s3ns:my-project lautet, verwenden Sie s3ns/my-project.

Invalid Docker string nach einem gcloud artifacts-Befehl

Wenn nach Ausführung eines gcloud artifacts Befehls der dial tcp: lookup <var>REGION</var>: no such host Fehler angezeigt wird, verwenden Sie einen Endpunkt mit einer bestimmten Region, z. B. u-france-east1-docker.s3nsregistry.fr. Die Google Cloud CLI unterstützt nicht die Verwendung von docker.s3nsregistry.fr als Endpunkt.

Image kann nicht abgerufen oder in einer Cloud de Confiance by S3NS Laufzeitumgebung bereitgestellt werden

Prüfen Sie Folgendes:

  1. Prüfen Sie, ob der vollständige Pfad des Images, das Sie per Push übertragen, korrekt ist. Der Pfad muss den Hostnamen der Registry, Cloud de Confiance by S3NS, die Projekt-ID, das Repository und das Image enthalten. Beispiel:
    u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/my-image:v1
    Weitere Informationen finden Sie unter Repository- und Image-Namen.
  2. Prüfen Sie, ob das Konto, mit dem das Image abgerufen wird, die richtigen Berechtigungen zum Lesen aus dem Repository hat. Wenn Sie die automatische Rollenzuweisung für Dienstkonten deaktiviert haben, müssen Sie den Laufzeitdienst konten Artifact Registry-Rollen zuweisen.

Image kann nicht per Push in Artifact Registry übertragen werden

Geben Sie Folgendes ein:

  1. Prüfen Sie, ob der vollständige Pfad des Images, das Sie per Push übertragen, korrekt ist. Der Pfad muss den Hostnamen der Registry, Cloud de Confiance by S3NS die Projekt-ID, das Repository und das Image enthalten. Beispiel:
    u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/my-image:v1
      

    Jedes Artifact Registry-Repository ist eine separate Ressource. Sie können also kein Image per Push an einen Pfad ohne Repository übertragen. For example, u-france-east1-docker.s3nsregistry.fr/my-project/my-image:v1 ist ein ungültiger Image-Pfad.

    Weitere Informationen finden Sie unter Repository- und Image-Namen.

  2. Prüfen Sie, ob das Konto, mit dem das Image per Push übertragen wird, Berechtigungen zum Schreiben in das Repository hat. Wenn Sie die automatische Rollenzuweisung für Dienstkonten deaktiviert haben, müssen Sie den Laufzeitdienst konten Artifact Registry-Rollen zuweisen.
    • Für Compute Engine- und Google Kubernetes Engine-Dienstkonten müssen Sie dem Laufzeitdienstkonto die Rolle Artifact Registry-Autor (roles/artifactregistry.writer) zuweisen.
  3. Wenn Artifact Registry die Meldung The repository has enabled tag immutability zurückgegeben hat, ist die Tag-Unveränderlichkeit für das Repository konfiguriert. Sie können kein Image mit einem Tag per Push übertragen, das bereits für eine andere Version desselben Images im Repository verwendet wird. Versuchen Sie, das Image noch einmal mit einem Tag per Push zu übertragen, das nicht von anderen gespeicherten Versionen des Images verwendet wird.

    Um zu prüfen, ob ein Repository für unveränderliche Image-Tags konfiguriert ist, sehen Sie in der Liste der Repositories in Cloud de Confiance der Console in der Spalte Unveränderliche Image-Tags nach oder führen Sie den folgenden Befehl aus:

    gcloud artifacts repositories describe REPOSITORY \
          --project=PROJECT-ID \
          --location=LOCATION
      

Meldungen „ImagePullBackOff“ und „ErrImagePull“

Meldungen mit ImagePullBackOff und ErrImagePull weisen darauf hin, dass ein Image nicht von GKE aus der Registry abgerufen werden kann.