Lösen des Fehlers "No Matching Manifest for Linux/Arm/V7" in Docker

Grund und Behebung des Fehlers "No Matching Manifest for Linux/Arm/V7"

Der Fehler "No Matching Manifest for Linux/Arm/V7" tritt auf, wenn Docker kein geeignetes Manifest für ein ARMv7-System finden kann, auf dem du ein Image ausführen möchtest. Dies kann mehrere Gründe haben:

Überprüfe die unterstützten Architekturen in den Manifesten

Jedes Docker-Image besteht aus einem oder mehreren Manifesten, die Informationen über die unterstützten Architekturen enthalten. Überprüfe zunächst die Manifeste des Images, um sicherzustellen, dass sie die Architektur ARMv7 unterstützen.

• Verwende das Kommando "docker manifest inspect": Dieses Kommando listet alle Manifeste in einem Image auf und zeigt die unterstützten Architekturen an.
• Lies die Dockerfile: Wenn du das Image selbst erstellt hast, überprüfe die Dockerfile auf Hinweise zu unterstützten Architekturen.

Festlegen der Zielarchitektur für ARMv7

Wenn das Manifest die ARMv7-Architektur nicht unterstützt, kannst du die Zielarchitektur für das Image manuell auf ARMv7 festlegen.

• Verwende die Option "--platform": Führe den Docker-Befehl mit der Option "--platform=linux/arm/v7" aus. Beispiel:

docker run --platform=linux/arm/v7 <image-name>

Gründe für das Fehlen des ARMv7-Manifests

In einigen Fällen enthält das Image möglicherweise kein Manifest für ARMv7, weil:

• Das Image wurde nicht für ARMv7 erstellt: Überprüfe die Dokumentation des Images oder wende dich an den Hersteller des Images, um zu bestätigen, dass es die Architektur ARMv7 unterstützt.
• Das ARMv7-Manifest wurde gelöscht: Manchmal können manifeste versehentlich gelöscht oder beschädigt werden. Versuche, das Image erneut zu erstellen oder von einer anderen Quelle zu beziehen.

Problembehandlung bei nicht unterstützten Architekturen

Wenn die ARMv7-Architektur nicht für das Image unterstützt wird, kannst du alternative Lösungen in Betracht ziehen:

• Nutze eine Emulation: Du kannst versuchen, das Image auf einem System mit einer anderen Architektur auszuführen, indem du einen Emulator wie QEMU verwendest.
• Passe das Dockerfile an: Wenn du das Image selbst erstellst, kannst du das Dockerfile so anpassen, dass es ARMv7 unterstützt. Füge eine ARCH-Anweisung hinzu, um die Zielarchitektur festzulegen, und baue das Image neu.
• Verwende ein anderes Image: Suche nach einem alternativen Image, das explizit die ARMv7-Architektur unterstützt.

Überprüfen der unterstützten Architekturen in den Manifesten

Um den Fehler "No Matching Manifest for Linux/Arm/V7" zu beheben, musst du zunächst die unterstützten Architekturen in den Manifesten deiner Docker-Images überprüfen. Docker-Manifestdateien definieren die unterstützten Plattformen für jedes Image.

Docker Manifest Inspector nutzen

Du kannst das Docker Manifest Inspector-Tool verwenden, um die Manifestinformationen zu untersuchen. Führe dazu den folgenden Befehl aus:

docker manifest inspect [image-name]:[tag]

Diese Ausgabe enthält eine Liste der unterstützten Plattformen für das Image.

Portierbare Distribution definieren

Wenn dein Manifest keine ARMv7-Plattform enthält, musst du eine portierbare Distribution definieren. Dies ist eine Manifest-Variante, die eine Liste von Architekturen unterstützt, die das Image abdecken sollen. Führe dazu den folgenden Befehl aus:

docker manifest create [image-name]
docker manifest add [image-name] [child-image-name] --arch=[arch]

Ersetze [image-name] durch den Namen deines Images und [child-image-name] durch den Namen des Images mit der unterstützten ARMv7-Plattform. Ersetze [arch] durch "arm/v7".

Weitere Überlegungen

• Überprüfe die unterstützten Architekturen deiner Basis-Images: Stelle sicher, dass das Basis-Image, auf dem dein Image basiert, ARMv7 unterstützt.
• Überprüfe die Zielarchitektur deiner Anwendung: Vergewissere dich, dass die Zielarchitektur deiner Anwendung mit der unterstützten Architektur des Basis-Images übereinstimmt.
• Verwende Manifest-Anker: Manifest-Anker ermöglichen es dir, bestimmte Manifestvarianten für bestimmte Architekturen zu kennzeichnen. Weitere Informationen findest du in der Docker-Dokumentation zu Manifest-Ankern.

Festlegen der Zielarchitektur für ARMv7

Sobald du die Ursache des Fehlers "No Matching Manifest for Linux/Arm/V7" ermittelt hast, kannst du die Zielarchitektur in deinem Docker-Image explizit auf ARMv7 festlegen. Dies teilt Docker mit, dass du ein Image für ARMv7-Geräte erstellst und weist es an, nach dem entsprechenden Manifest zu suchen.

Festlegen der Zielarchitektur in Dockerfile

Füge die folgende Zeile zu deiner Dockerfile hinzu, um die Zielarchitektur auf ARMv7 festzulegen:

ARG TARGETARCH=armv7

Festlegen der Zielarchitektur mit docker build

Du kannst die Zielarchitektur auch beim Erstellen des Docker-Images mit dem Flag --target festlegen:

docker build --target $TARGETARCH .

Überprüfen der Zielarchitektur

Überprüfe nach dem Erstellen des Images die Zielarchitektur mit folgendem Befehl:

docker inspect --format='{{.Config.Architecture}}' <image-name>

Dieser Befehl sollte armv7 als Ausgabe anzeigen.

Problembehandlung

Wenn du nach dem Festlegen der Zielarchitektur immer noch den Fehler "No Matching Manifest" erhältst, überprüfe Folgendes:

• Überprüfe, ob dein Basis-Image ARMv7 unterstützt. Das Basis-Image muss für die von dir festgelegte Zielarchitektur geeignet sein.
• Überprüfe, ob du die neueste Version von Docker verwendest. Ältere Versionen von Docker unterstützen möglicherweise nicht die ARMv7-Architektur.
• Versuche, das Image mit der Option --pull zu erstellen. Dies zwingt Docker, alle fehlenden Manifeste herunterzuladen.

Gründe für das Fehlen des ARMv7-Manifests

Wenn du auf den Fehler "No Matching Manifest for Linux/Arm/V7" stößt, obwohl dein Image für ARMv7-Architekturen konzipiert ist, können verschiedene Gründe vorliegen, warum das ARMv7-Manifest nicht verfügbar ist:

Nicht veröffentlichtes Manifest

Manchmal veröffentlichen Container-Registry-Anbieter wie Docker Hub oder Google Container Registry (GCR) ARMv7-Manifeste nicht automatisch. Dies kann auf eingeschränkte Ressourcen, Kompatibilitätsprobleme oder andere technische Einschränkungen zurückzuführen sein.

Fehlende Architektur im Image

Stelle sicher, dass dein Container-Image explizit für die ARMv7-Architektur erstellt wurde. Überprüfe die Dockerfile-Anweisungen und stelle sicher, dass die FROM-Anweisung eine Basis-Image angibt, das ARMv7 unterstützt.

Zugriffsberechtigungen

Vergewissere dich, dass du die erforderlichen Zugriffsberechtigungen hast, um auf das ARMv7-Manifest zuzugreifen. Dies beinhaltet das Vérifizieren deiner Authentifizierungsinformationen und das Sicherstellen, dass du für den Zugriff auf die Registry autorisiert bist.

Veraltete Registrierung

Überprüfe, ob die Container-Registry, in der sich dein Image befindet, auf dem neuesten Stand ist. Veraltete Registrierungen unterstützen möglicherweise keine ARMv7-Architekturen.

Unterstützungsprobleme

Manche Container-Registries unterstützen möglicherweise grundsätzlich keine ARMv7-Architekturen. Überprüfe die Dokumentation der Registry, um sicherzustellen, dass ARMv7 unterstützt wird.

Problembehandlung bei nicht unterstützten Architekturen

Wenn du den Fehler "No Matching Manifest for Linux/Arm/V7" erhältst und die oben beschriebenen Lösungen nicht funktionieren, kann es sein, dass deine Zielarchitektur nicht unterstützt wird.

Überprüfe die unterstützten Architekturen

Überprüfe die unterstützten Architekturen für das von dir verwendete Docker-Image. Du kannst dies tun, indem du den Befehl docker manifest inspect verwendest:

$ docker manifest inspect [IMAGE_NAME]

Dies wird eine Liste der unterstützten Architekturen für das Image anzeigen. Wenn ARMv7 nicht in der Liste enthalten ist, bedeutet dies, dass das Image nicht für diese Architektur erstellt wurde.

Gründe für nicht unterstützte Architekturen

Es gibt mehrere Gründe, warum ein Docker-Image ARMv7 möglicherweise nicht unterstützt:

• Das Basisimage unterstützt ARMv7 nicht: Das Basisimage, auf dem dein Docker-Image basiert, unterstützt möglicherweise ARMv7 nicht. Überprüfe die Dokumentation des Basisimages, um die unterstützten Architekturen zu ermitteln.
• Das Image wurde nicht für ARMv7 erstellt: Das Docker-Image wurde möglicherweise nicht explizit für ARMv7 erstellt. In diesem Fall musst du das Image selbst für ARMv7 erstellen oder ein anderes Image verwenden.

Alternative Lösungen

Wenn das Docker-Image, das du verwendest, ARMv7 nicht unterstützt, kannst du Folgendes versuchen:

• Verwende ein anderes Docker-Image: Suche nach einem anderen Docker-Image, das für ARMv7 erstellt wurde.
• Erstelle dein eigenes Image: Du kannst dein eigenes Docker-Image erstellen, das auf einem ARMv7-Basisimage basiert. Weitere Informationen zum Erstellen von Docker-Images findest du in der Docker-Dokumentation.
• Verwende eine Emulationsschicht: Du kannst eine Emulationsschicht wie QEMU verwenden, um ARMv7-Code auf einer Nicht-ARMv7-Architektur auszuführen.

Alternative Lösungen für den Fehler "No Matching Manifest"

Plattformübergreifendes Docker-Image

Wenn das ARMv7-Manifest tatsächlich nicht für dein Docker-Image bereitgestellt wird, kannst du ein plattformübergreifendes Image in Betracht ziehen. Plattformen wie Buildx von Docker oder Kaniko ermöglichen es dir, Images für mehrere Architekturen aus einem einzigen Build-Kontext zu erstellen. Dies kann dir dabei helfen, die Kompatibilität mit ARMv7-Geräten zu gewährleisten, auch wenn das spezifische Basis-Image kein ARMv7-Manifest bereitstellt.

Manuelles Bereitstellen des Manifests

In einigen Fällen kannst du möglicherweise das fehlende ARMv7-Manifest manuell bereitstellen. Dies erfordert ein gewisses Maß an technischem Fachwissen und kann je nach verwendetem Registry-Anbieter variieren. Beispielsweise kannst du bei Docker Hub das ARMv7-Manifest in das Repository deines Images hochladen, um die Kompatibilität mit ARMv7-Geräten sicherzustellen.

Konvertieren des Images

Wenn alle anderen Optionen fehlschlagen, kannst du versuchen, dein Docker-Image in ein Format zu konvertieren, das von deinem Zielgerät unterstützt wird. Tools wie Docker Engine oder OCI Image Converter ermöglichen es dir, Images zwischen verschiedenen Formaten zu konvertieren. Dies kann eine praktikable Lösung sein, wenn du mit einem benutzerdefinierten Image arbeitest, für das kein ARMv7-Manifest bereitgestellt wird.