Fehlerbehebung für geheime Schlüssel für Image-Pull-Operationen, die API-Schlüssel verwenden

Wenn Ihre Podkonfiguration einen geheimen Schlüssel für Image-Pull-Operationen hat, der einen API-Schlüssel verwendet, überprüfen Sie, ob die Berechtigungsnachweise des API-Schlüssels korrekt festgelegt sind.

In den folgenden Schritten wird davon ausgegangen, dass der API-Schlüssel die Berechtigungsnachweise für eine Service-ID speichert. Wenn Sie Ihren geheimen Schlüssel für Image-Pull-Operationen so eingerichtet haben, dass er einen API-Schlüssel eines einzelnen Benutzers verwendet, müssen Sie die IBM Cloud IAM-Berechtigungen und Berechtigungsnachweise dieses Benutzers überprüfen.

1. Suchen Sie die Service-ID, die der API-Schlüssel für den geheimen Schlüssel für Image-Pull-Operationen verwendet, indem Sie die Beschreibung (Description) prüfen. Die mit dem Cluster erstellte Service-ID hat den Namen cluster-<cluster_ID> und wird im default Red Hat OpenShift-Projekt verwendet. Wenn Sie eine andere Service-ID erstellt haben, z. B. um auf ein anderes Red Hat OpenShift-Projekt zuzugreifen oder um IBM Cloud IAM-Berechtigungen zu ändern, haben Sie die Beschreibung angepasst.

   ibmcloud iam service-ids
   

   Beispielausgabe

   UUID                Name               Created At              Last Updated            Description                                                                                                                                                                                         Locked
   ServiceId-aa11...   <service_ID_name>  2019-02-01T19:01+0000   2019-02-01T19:01+0000   ID for <cluster_name>                                                                                                                                         false
   ServiceId-bb22...   <service_ID_name>  2019-02-01T19:01+0000   2019-02-01T19:01+0000   Service ID for IBM Cloud Container Registry in Kubernetes cluster <cluster_name> namespace <project>                                                                                                                                         false
   

2. Stellen Sie sicher, dass der Service-ID mindestens eine IBM Cloud-Richtlinie für die IBM Cloud Container Registry IAM-Servicezugriffsrolle Leseberechtigter zugewiesen ist. Wenn die Service-ID nicht die Servicezugriffsrolle Leseberechtigter (Reader) hat, bearbeiten Sie die IAM-Richtlinien. Wenn die Richtlinien korrekt sind, fahren Sie mit dem nächsten Schritt fort, um zu prüfen, ob die Berechtigungsnachweise gültig sind.

   ibmcloud iam service-policies <service_ID_name>
   

   Beispielausgabe

   Policy ID:   a111a111-b22b-333c-d4dd-e555555555e5
   Roles:       Reader
   Resources:
                 Service Name       container-registry
                 Service Instance
                 Region
                 Resource Type      namespace
                 Resource           <registry_namespace>
   

3. Prüfen Sie, ob die Berechtigungsnachweise des geheimen Schlüssels für Image-Pull-Operationen gültig sind.

   1. Rufen Sie die Konfiguration des geheimen Schlüssels für Image-Pull-Operationen ab. Falls sich der Pod nicht im Projekt „ default “ befindet, fügen Sie die Option „ -n “ hinzu.

      oc get secret <image_pull_secret_name> -o yaml [-n <project>]
      

   2. Kopieren Sie in der Ausgabe den base64-codierten Wert des Felds .dockerconfigjson.

      apiVersion: v1
      kind: Secret
      data:
        .dockerconfigjson: eyJyZWdp...==
      ...
      

   3. Decodieren Sie die Base64-Zeichenfolge. Beispiel: Unter OS X können Sie den folgenden Befehl ausführen.

      echo -n "<base64_string>" | base64 --decode
      

      Beispielausgabe

      {"auths":{"<region>.icr.io":{"username":"iamapikey","password":"<password_string>","email":"<name@abc.com>","auth":"<auth_string>"}}}
      

   4. Vergleichen Sie den Domänennamen aus der regionalen Registry des geheimen Schlüssels für Image-Pull-Operationen mit dem Domänennamen, den Sie im Container-Image angegeben haben. Standardmäßig verfügen neue Cluster über geheime Schlüssel für Image-Pull-Operationen für jeden Domänennamen der regionalen Registry für Container, die im default Red Hat OpenShift-Projekt ausgeführt werden. Wenn Sie die Standardeinstellungen jedoch geändert haben oder ein anderes Red Hat OpenShift-Projekt verwenden, verfügen Sie möglicherweise nicht über einen geheimen Schlüssel für Image-Pull-Operationen für die regionale Registry. Kopieren Sie einen geheimen Schlüssel für Image-Pull-Operationen für den Domänennamen in der regionalen Registry.

   5. Melden Sie sich von Ihrem lokalen System aus bei der Registry mit den Werten für username und password aus Ihrem geheimen Schlüssel für Image-Pull-Operationen an. Wenn Sie sich nicht anmelden können, müssen Sie möglicherweise die Service-ID korrigieren.

      docker login -u iamapikey -p <password_string> <region>.icr.io
      

      1. Erstellen Sie die Cluster-Service-ID, IBM Cloud IAM-Richtlinien, den API-Schlüssel und die geheimen Schlüssel für Image-Pull-Operationen für Container, die im default Red Hat OpenShift-Projekt ausgeführt werden, erneut.

         ibmcloud oc cluster pull-secret apply --cluster <cluster_name_or_ID>
         

      2. Erstellen Sie Ihre Bereitstellung im default Red Hat OpenShift-Projekt erneut. Wenn weiterhin eine Berechtigungsfehlernachricht angezeigt wird, wiederholen Sie die Schritte 1 bis 5 mit den neuen geheimen Schlüsseln für Image-Pull-Operationen. Wenn Sie sich immer noch nicht anmelden können, öffnen Sie einen IBM Cloud-Supportfall.

   6. Wenn die Anmeldung erfolgreich ist, extrahieren Sie ein Image auf Ihre lokale Maschine. Schlägt der Befehl mit einem Fehler 'Zugriff verweigert' (access denied) fehl, handelt es sich bei dem Registry-Konto um ein anderes IBM Cloud-Konto als das, in dem sich Ihr Cluster befindet. Erstellen Sie einen geheimen Schlüssel für Image-Pull-Operationen (imagePullSecret), um auf Images in dem anderen Konto zuzugreifen. Wenn Sie ein Bild auf Ihren lokalen Rechner herunterladen können, verfügt Ihr API-Schlüssel über die richtigen Berechtigungen, aber die API-Konfiguration in Ihrem Cluster ist nicht korrekt.

      docker pull <region>icr.io/<namespace>/<image>:<tag>
      

   7. Überprüfen Sie, ob der geheime Schlüssel für die Pull-Operation entweder direkt von der Bereitstellung oder von dem Servicekonto, das die Bereitstellung verwendet, referenziert wird. Wenn Sie das Problem immer noch nicht lösen können, wenden Sie sich an den Support.