Analizzi un riferimento Docker: registro, repository, tag o digest

Il parser separa un registro esplicito, compresa un’eventuale porta, dal percorso del repository e da un tag o digest del contenuto facoltativo. Distingue i due punti di registry.example.com:5000, che appartengono alla porta, da quelli dopo il nome di un’immagine, che introducono un tag. I riferimenti non validi generano un errore chiaro, non campi parziali fuorvianti. Non viene contattato alcun registro e non vengono inventati valori predefiniti omessi come Docker Hub o latest.

Separi ogni parte senza ipotizzare valori predefiniti nascosti

Un riferimento immagine Docker può essere breve come alpine oppure dettagliato come registry.example.com:5000/platform/api:2026.07. A prima vista, sia la porta del registro sia il tag dell’immagine utilizzano i due punti, quindi una semplice divisione in base alla punteggiatura produce risultati errati. Questo parser isola innanzitutto il digest, poi esamina soltanto l’ultimo segmento del percorso per individuare un tag. Riconosce il primo componente delimitato da una barra come registro esplicito se equivale a localhost, contiene un punto, include i due punti di una porta o è un indirizzo IPv6 racchiuso tra parentesi quadre. Tutti i componenti successivi formano il percorso del repository. L’output conserva esclusivamente ciò che l’input dichiara. Per alpine, il repository è alpine e non sono presenti campi per registro o tag. Il parser non sostituisce docker.io, non aggiunge il namespace convenzionale library e non presume latest. Il risultato è quindi adatto ad analisi di configurazione, controlli delle policy e strumenti di migrazione nei quali un valore esplicito deve rimanere distinguibile da un’impostazione predefinita del client.

Gestisca correttamente tag, digest, porte e percorsi

Tag e digest identificano le immagini in modi differenti. Un tag è un’etichetta modificabile come stable, 1.4.2 o release_candidate, mentre un digest è un identificatore basato sul contenuto, scritto dopo una chiocciola come algoritmo e valore. Il parser restituisce questi dati in campi separati e accetta anche un riferimento che li contenga entrambi, perché gli strumenti Docker possono qualificare con un digest un nome già provvisto di tag. I percorsi dei repository possono comprendere più componenti minuscoli, con i separatori ammessi dalle consuete regole di denominazione Docker. Gli host dei registri vengono convalidati separatamente, incluse le porte numeriche da 1 a 65535 e le forme IPv6 minuscole tra parentesi quadre. Algoritmi e valori dei digest devono rispettare la rispettiva sintassi, mentre il valore deve avere una lunghezza significativa. Il parser non tenta di risolvere un tag, verificare l’esistenza di un digest o controllare se le credenziali consentono il download. Si tratta unicamente di analisi sintattica, quindi i risultati restano deterministici, privati e disponibili senza accesso alla rete.

Rifiuti input ambigui prima di automatizzarli

Un parser troppo permissivo può essere rischioso nell’automazione dei deployment, perché un refuso potrebbe indicare un’immagine diversa da quella prevista. Questa capacità rifiuta valori vuoti, spazi iniziali, finali o interni, schemi URL, separatori di digest ripetuti, segmenti di percorso vuoti, tag non validi, porte di registro errate, nomi di repository con maiuscole ed espressioni digest malformate. Limita inoltre la lunghezza dell’intero riferimento e del repository, così il lavoro rimane circoscritto. La convalida restituisce un unico errore chiaro di input non valido, anziché un oggetto parziale che potrebbe sembrare affidabile. Utilizzi questo comportamento all’ingresso di un processo CI, un editor di manifesti, un importatore di inventari di immagini o un ausilio per policy di ammissione. Un risultato valido può essere instradato in base alla presenza di registro, tag o digest; un valore non valido interrompe subito il flusso. Una sintassi valida non garantisce che il repository o l’immagine esistano: tale controllo richiede accesso e autenticazione al registro, volutamente esclusi da questo strumento. L’esecuzione nel browser è locale e l’API costa $0.002 per riferimento.