Comment corriger lerreur « Docker : format de référence non valide »

Docker simplifie la création, l'exécution et la gestion des conteneurs. Cependant, vous pouvez rencontrer une erreur « Format de référence non valide » lors de l'exécution ou de la création d'une image. Dans la plupart des cas, cela est dû à une erreur de formatage mineure dans le nom ou la balise de l'image. Par exemple, l'erreur peut être due à des majuscules, des caractères spéciaux ou des valeurs manquantes. Ce guide explique les causes courantes de cette erreur et comment la corriger pour éviter qu'elle ne se reproduise.

Correction de l'erreur « Format de référence non valide »

Découvrons les causes les plus courantes de l'erreur « Format de référence non valide » et comment les corriger :

Lettres majuscules dans les noms d'images

Docker exige que les noms d'images soient en minuscules. Une seule majuscule peut entraîner des erreurs de formatage. Par exemple, l'exécution de la commande suivante entraînera une erreur :

docker pull NGINX

Comment corriger l'erreur « Docker : format de référence non valide » — Les noms d'archives doivent être en minuscules

Pour éviter cette erreur, vérifiez toujours que le nom de votre image est en minuscules avant d'exécuter la commande.

docker pull nginx

Caractère spécial ou invalide

Il arrive que les utilisateurs ajoutent accidentellement des caractères non autorisés par Docker. Il s'agit notamment de signes @, d'espaces ou de caractères copiés d'un site web ou d'un document qui semblent normaux, mais qui ne le sont pas.

Par exemple, la commande suivante contient le caractère spécial @, ce qui provoquera l'erreur suivante :

docker run ubuntu@:latest

Pour corriger cette erreur, assurez-vous qu'il n'y a pas de caractères supplémentaires ni de problèmes de formatage dans la commande. Vous pouvez utiliser un éditeur de texte brut pour vérifier et nettoyer la commande (si nécessaire) :

docker run ubuntu:latest

Deux points sans étiquette

L'une des erreurs les plus courantes consiste à ajouter deux points à la fin du nom de l'image sans inclure la balise. Par exemple, essayons la commande suivante pour extraire Node :

docker pull node:

Docker attend une valeur après les deux points, telle que latest, 18-alpine ou toute autre balise valide. Si aucune valeur n'est fournie, le nom de l'image est considéré comme incomplet et génère une erreur « Format de référence non valide » :

Pour corriger cette erreur, ajoutez une balise appropriée après les deux points pour rendre le nom de l'image complet et valide :

docker pull node:latest

Le chemin du fichier ou le montage du volume contient des espaces

Lorsque vous incluez un chemin de fichier contenant des espaces, notamment avec des options comme -v (montage de volume), Docker peut interpréter à tort certaines parties du chemin comme des arguments distincts, voire comme une partie du nom de l'image. Vous risquez alors d'obtenir des résultats inattendus, comme celui illustré ci-dessous :

docker run -v /home/user/My Folder:/app ubuntu

Pour éviter cela, entourez toujours le chemin du fichier d'espaces entre guillemets, comme indiqué ci-dessous :

docker run -v "/home/user/My Folder:/app" ubuntu

Remplacez « /home/user/My Folder » par le chemin réel vers le répertoire que vous souhaitez monter dans le conteneur.

Utilisation inappropriée des variables

Avec Docker, il est courant d'utiliser des variables dans les commandes, notamment pour spécifier les versions d'images. Cependant, si une variable comme $VERSION n'est pas définie correctement, Docker peut rencontrer des problèmes tels que l'erreur « Format de référence non valide ».

Par exemple, exécutez la commande suivante pour extraire Ubuntu de Docker Hub :

docker pull ubuntu:$VERSION

Ici, $VERSION est censé représenter la version de l'image Ubuntu à extraire. Cependant, si vous ne lui attribuez pas de valeur, Docker interprétera la commande comme « docker pull ubuntu: ». Le nom de l'image sera alors invalide, car il se termine par deux points et ne contient pas la balise de version requise.

Pour éviter cela, assurez-vous que toutes les variables utilisées dans la commande sont correctement définies. Sous Linux, vous pouvez définir une variable en utilisant la syntaxe suivante.

$VERSION=latest

Ensuite, extrayez la version spécifiée en exécutant la commande suivante.

docker pull ubuntu:$VERSION

Dans Windows CMD, vous devez utiliser le mot-clé set pour définir une variable (comme la version), puis utiliser la syntaxe %VARIABLE% pour y faire référence dans des commandes telles que docker pull.

set VERSION=latest
docker pull ubuntu:%VERSION%

Ici, $VERSION contient la valeur la plus récente ; Docker récupère donc l' image ubuntu:latest sans problème. Vous pouvez également attribuer une version spécifique, par exemple 18.04, si nécessaire.

Problème de copier-coller

Il arrive que des utilisateurs copient des commandes à partir de tutoriels ou de documentations en ligne. Ces commandes copiées peuvent contenir des caractères cachés, tels que des espaces invisibles, des signes de ponctuation non anglais ou des guillemets spéciaux. Ces caractères peuvent corrompre vos commandes Docker de manière involontaire.

Pour éviter cela, il est préférable de saisir la commande vous-même lorsque cela est possible, ou de coller d'abord la commande dans un éditeur de texte brut pour supprimer le formatage indésirable.

Maintenant que vous connaissez les causes courantes de l'erreur « Format de référence invalide » dans Docker et comment la corriger, vous serez sur la bonne voie pour éviter ce problème à l'avenir. De la vérification de la casse à la définition correcte de vos variables, ces conseils simples peuvent vous faire gagner beaucoup de temps et vous éviter bien des frustrations. Si vous souhaitez aller plus loin, vous pourriez également apprendre à baliser et à transférer vos images Docker personnalisées vers le registre, ou à nettoyer les images inutilisées pour maintenir votre système propre.

Tags: #System

Comment afficher lhorloge sur lécran de Windows 11

En plus d'afficher l'horloge sur la barre des tâches, sous Windows 11, vous pouvez régler l'affichage de l'horloge sur l'écran de l'ordinateur.

Comment corriger lerreur de la carte mère affichant une lumière rouge

Il est effrayant de voir un voyant rouge sur votre carte mère alors que votre système ne démarre pas, surtout si votre carte mère refuse de vous dire pourquoi le voyant est allumé.

Résumé de quelques méthodes simples pour désactiver les ports USB sur les ordinateurs Windows

Déverrouiller les ports USB dans le BIOS n'est pas difficile. Mais comment verrouiller les ports USB d'un ordinateur ? Découvrons-le avec Quantrimang.com !

Comment corriger lerreur « Informations de configuration système incorrectes » dans Windows 10

Les informations de configuration système incorrectes sont une erreur courante lors de la vérification des bogues sur les systèmes Windows 10. Examinons quelques solutions pour résoudre ce problème.

Comment inverser les couleurs de lécran à laide de la loupe Windows 11

L’utilisation de la fonction d’inversion de la loupe sur Windows 11 peut améliorer la lisibilité du texte, en particulier pour les personnes sensibles à la lumière.

Activer XMP pour optimiser la vitesse de la RAM

Si vous souhaitez créer votre propre système PC et décidez d'investir dans de la RAM haute vitesse, comment vous assurer que votre RAM peut fonctionner aux vitesses annoncées ?

10 paramètres Windows que vous ne devriez jamais laisser par défaut

Windows n'est pas livré avec une sécurité configurée par défaut, ce qui signifie que vous devez modifier certains paramètres par défaut.

6 meilleurs fournisseurs DNS dynamiques gratuits

Le DNS dynamique (également appelé DDNS ou DynDNS) est un service permettant d'associer un nom de domaine Internet à un ordinateur doté d'une adresse IP dynamique. La plupart des ordinateurs se connectent à un routeur via DHCP, ce qui signifie que le routeur attribue aléatoirement une adresse IP à l'ordinateur.

Comment libérer 48 Go sur un PC Windows 11 sans perdre de données importantes

Entre les fichiers temporaires, les sauvegardes obsolètes, les données en double et les applications inutilisées, il existe de nombreuses façons de récupérer de l'espace sans toucher à vos fichiers personnels.

Vérifiez MD5 et SHA1 pour vérifier lintégrité du fichier

Nous utiliserons un programme spécialisé pour vérifier les codes MD5 et SHA1 du fichier afin de détecter d'éventuelles erreurs. Le logiciel de vérification MD5 HashCalc est un outil très utile pour vérifier ces codes.

7 façons intelligentes dutiliser votre moniteur sans ordinateur

Lorsqu'on pense à un moniteur, on l'imagine souvent connecté à un PC ou un ordinateur portable. Pourtant, ce moniteur peut en réalité fonctionner avec de nombreux autres appareils.

Pourquoi y a-t-il une icône de verrouillage sur le lecteur et comment la supprimer ?

Vous vous demandez pourquoi il y a une icône de cadenas sur un lecteur dans l'Explorateur de fichiers ? Cet article explique ce que c'est et comment supprimer l'icône de cadenas d'un lecteur sous Windows 10.

Comment modifier le format des nombres dans Windows 11

Les formats numériques déterminent l'affichage des nombres, notamment le choix du séparateur décimal (comme un point ou une virgule) et du séparateur de milliers. Voici comment modifier le format des nombres sous Windows 11.

Comment vérifier lhistorique de lordinateur pour voir si quelquun a accédé à votre ordinateur et la utilisé ?

Si vous pensez que quelqu'un accède à votre ordinateur et l'utilise sans autorisation, vous pouvez appliquer certaines des astuces ci-dessous pour vérifier l'historique d'activation/désactivation de l'ordinateur, afficher les activités récentes sur l'ordinateur pour confirmer et réaffirmer cela.