Docker-Image-Referenz in Registry, Repository, Tag oder Digest zerlegen

Der Parser trennt eine explizite Registry samt optionalem Port vom Repository-Pfad und einem optionalen Tag oder Inhalts-Digest. Er erkennt, warum der Doppelpunkt in registry.example.com:5000 keinen Tag einleitet, der Doppelpunkt nach einem Image-Namen dagegen schon. Fehlerhafte Referenzen führen zu einer eindeutigen Fehlermeldung statt zu irreführenden Teilfeldern. Es wird keine Registry kontaktiert, und ausgelassene Vorgaben wie Docker Hub oder latest werden nicht stillschweigend ergänzt.

Trennen Sie alle Bestandteile ohne versteckte Standardwerte

Eine Docker-Image-Referenz kann so kurz wie alpine oder so ausführlich wie registry.example.com:5000/platform/api:2026.07 sein. Sowohl der Registry-Port als auch der Image-Tag verwenden einen Doppelpunkt. Eine bloße Aufteilung anhand der Satzzeichen liefert deshalb falsche Ergebnisse. Dieser Parser isoliert zuerst den Digest und untersucht anschließend ausschließlich das letzte Pfadsegment auf einen Tag. Die erste durch einen Schrägstrich getrennte Komponente gilt als explizite Registry, wenn sie localhost lautet, einen Punkt enthält, einen Port-Doppelpunkt besitzt oder eine eingeklammerte IPv6-Adresse darstellt. Alle nachfolgenden Komponenten bilden den Repository-Pfad. Die Ausgabe enthält nur Angaben, die tatsächlich in der Eingabe stehen. Bei alpine lautet das Repository alpine; Registry- und Tag-Felder fehlen. Der Parser ersetzt nichts durch docker.io, ergänzt nicht den üblichen Namespace library und nimmt nicht latest an. Dadurch eignet sich das Ergebnis für Konfigurationsanalysen, Richtlinienprüfungen und Migrationen, bei denen ein ausdrücklich angegebener Wert von einer clientseitigen Vorgabe unterscheidbar bleiben muss.

Verarbeiten Sie Tags, Digests, Ports und Pfade korrekt

Tags und Digests kennzeichnen Images auf unterschiedliche Weise. Ein Tag ist eine veränderliche Bezeichnung wie stable, 1.4.2 oder release_candidate. Ein Digest ist dagegen eine inhaltsadressierte Kennung, die nach einem At-Zeichen aus Algorithmus und Wert besteht. Der Parser gibt beide Angaben in getrennten Feldern zurück und akzeptiert auch Referenzen, die beides enthalten, da Docker-Werkzeuge einen mit Tag versehenen Namen zusätzlich durch einen Digest qualifizieren können. Repository-Pfade dürfen mehrere kleingeschriebene Komponenten und die nach den vertrauten Docker-Namensregeln zulässigen Trennzeichen enthalten. Registry-Hosts werden unabhängig geprüft, einschließlich numerischer Ports von 1 bis 65535 und kleingeschriebener, eingeklammerter IPv6-Formen. Digest-Algorithmen und codierte Werte müssen ihrer jeweiligen Syntax entsprechen; außerdem muss der Wert eine aussagekräftige Mindestlänge besitzen. Es wird weder ein Tag aufgelöst noch die Existenz eines Digests oder eine Download-Berechtigung geprüft. Die rein syntaktische Verarbeitung bleibt deshalb deterministisch, vertraulich und ohne Netzwerkzugriff verfügbar.

Weisen Sie mehrdeutige Eingaben vor der Automatisierung ab

Ein zu großzügiger Parser kann in der Deployment-Automatisierung riskant sein, weil ein Tippfehler auf ein anderes Image als beabsichtigt verweisen könnte. Diese Fähigkeit weist leere Werte, führende, abschließende oder eingebettete Leerzeichen, URL-Schemata, wiederholte Digest-Trenner, leere Pfadsegmente, fehlerhafte Tags, ungültige Registry-Ports, großgeschriebene Repository-Namen und fehlerhafte Digest-Ausdrücke zurück. Sie begrenzt außerdem die Länge der gesamten Referenz und des Repository-Teils, damit der Aufwand beschränkt bleibt. Die Validierung liefert einen eindeutigen Fehler für ungültige Eingaben und niemals ein scheinbar verlässliches Teilobjekt. Nutzen Sie dieses Verhalten am Eingang eines CI-Auftrags, Manifest-Editors, Image-Inventarimports oder Hilfswerkzeugs für Zulassungsrichtlinien. Ein gültiges Ergebnis lässt sich danach abhängig von vorhandener Registry, vorhandenem Tag oder Digest weiterleiten; eine ungültige Eingabe beendet den Ablauf frühzeitig. Eine syntaktisch gültige Angabe beweist nicht, dass Repository oder Image existieren. Dafür wären Registry-Zugriff und Authentifizierung nötig, die bewusst nicht Bestandteil dieses Werkzeugs sind. Die Browser-Ausführung erfolgt lokal, und die API kostet $0.002 pro Referenz.