Erreur Docker : format de référence invalide : le nom du dépôt doit être en minuscules.

Question

J'ai rencontré cette erreur Docker avec l'un de mes projets :

invalid reference format: repository name must be lowercase

Quelles sont les différentes causes de ce message générique ?

J'ai déjà trouvé la solution après quelques efforts, je vais donc répondre à ma propre question afin de la documenter ici, car la solution n'apparaît pas immédiatement lors d'une recherche sur le Web et aussi parce que ce message d'erreur ne décrit pas le problème direct que rencontre Docker.

Answer 1

Une "référence" dans Docker est un pointeur vers une image. Il peut s'agir d'un nom d'image, d'un identifiant d'image, de l'inclusion d'un serveur de registre dans le nom, de l'utilisation d'une balise sha256 pour épingler l'image, et de tout ce qui peut être utilisé pour pointer vers l'image que vous souhaitez exécuter.

Le site invalid reference format Le message d'erreur signifie que Docker ne peut pas convertir la chaîne que vous avez fournie en une image. Il peut s'agir d'un nom invalide, ou d'une erreur d'analyse plus tôt dans le processus de conversion. docker run si c'est ainsi que vous exécutez l'image. Avec un fichier de composition, si vous développez une variable dans le nom de l'image, cette variable peut ne pas se développer correctement.

Avec le docker run Cela est souvent dû au fait que les paramètres ne sont pas cités avec des espaces et que l'ordre de la ligne de commande est erroné. La ligne de commande est ordonnée comme suit :

docker ${args_to_docker} run ${args_to_run} image_ref ${cmd_to_exec}

L'erreur la plus courante dans le passage d'arguments à l'exécution est un mappage de volume qui développe un nom de chemin d'accès contenant un espace, et qui ne cite pas le chemin d'accès ou n'échappe pas l'espace. Par exemple

docker run -v $(pwd):/data image_ref

Et la solution est aussi simple que :

docker run -v "$(pwd):/data" image_ref

Answer 2

Permettez-moi de souligner que Docker n'autorise même pas les caractères mixtes.

Bien : docker build -t myfirstechoimage:0.1 .

Mauvais : docker build -t myFirstEchoImage:0.1 .

Answer 3

Avait un espace dans le répertoire de travail actuel et en utilisant le signe $(pwd) pour mapper les volumes. N'aime pas les espaces dans les noms de répertoires.

Answer 4

Dans mon cas, le nom de l'image défini dans docker-compose.yml contenait des lettres majuscules. Le fait que le message d'erreur mentionne repository au lieu de image n'a pas aidé à décrire le problème et il a fallu un certain temps pour le résoudre.

Answer 5

Dans mon cas, le problème résidait dans la disposition des paramètres. Au départ, j'avais --name après les paramètres d'environnement, puis le volume et attach_dbs et l'image à la fin de la commande comme ci-dessous.

docker run -p 1433:1433 -e sa_password=myComplexPwd -e ACCEPT_EULA=Y --name sql1 -v c:/temp/:c:/temp/ attach_dbs="[{'dbName':'TestDb','dbFiles':['c:\\temp\\TestDb.mdf','c:\\temp\\TestDb_log.ldf']}]" -d microsoft/mssql-server-windows-express

Après avoir réarrangé les paramètres comme ci-dessous, tout a bien fonctionné (en mettant essentiellement --name suivi du nom de l'image).

docker run -d -p 1433:1433 -e sa_password=myComplexPwd -e ACCEPT_EULA=Y --name sql1 microsoft/mssql-server-windows-express -v C:/temp/:C:/temp/ attach_dbs="[{'dbName':'TestDb','dbFiles':['C:\\temp\\TestDb.mdf','C:\\temp\\TestDb_log.ldf']}]"