كيفية إصلاح خطأ Docker: تنسيق مرجعي غير صالح

سجل واكسب 1000 دولار في اليوم ⋙

يُسهّل Docker بناء الحاويات وتشغيلها وإدارتها. ومع ذلك، قد تواجه خطأ "تنسيق مرجع غير صالح" عند تشغيل أو بناء صورة. في معظم الحالات، يكون السبب خطأً بسيطًا في تنسيق اسم الصورة أو وسمها. على سبيل المثال، قد يكون الخطأ بسبب أحرف كبيرة أو أحرف خاصة أو قيم مفقودة. سيشرح هذا الدليل الأسباب الشائعة لهذا الخطأ وكيفية إصلاحه لمنع تكراره.

إصلاح خطأ "تنسيق المرجع غير صالح"

دعونا نتعرف على الأسباب الأكثر شيوعًا لخطأ "تنسيق المرجع غير صالح" وكيفية إصلاحه:

الأحرف الكبيرة في أسماء الصور

يتطلب Docker كتابة أسماء الصور بأحرف صغيرة. حتى حرف كبير واحد قد يُسبب أخطاءً في التنسيق. على سبيل المثال، سيؤدي تشغيل الأمر التالي إلى حدوث خطأ:

docker pull NGINX
كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
يجب أن تكون أسماء الأرشيف بأحرف صغيرة

لتجنب هذا الخطأ، تأكد دائمًا من أن اسم صورتك مكتوب بأحرف صغيرة قبل تشغيل الأمر.

docker pull nginx
كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
استخدم الأحرف الصغيرة

حرف خاص أو غير صالح

أحيانًا يُضيف المستخدمون عن طريق الخطأ أحرفًا لا يسمح بها Docker. تشمل هذه الأحرف علامات @ والمسافات أو الأحرف المنسوخة من موقع ويب أو مستند تبدو طبيعية ولكنها ليست كذلك.

على سبيل المثال، يحتوي الأمر التالي على الحرف الخاص @، والذي سيؤدي إلى الخطأ التالي:

docker run ubuntu@:latest
كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
خطأ في الأحرف الخاصة

لإصلاح هذا الخطأ، تأكد من عدم وجود أحرف إضافية أو مشاكل في التنسيق في الأمر. يمكنك استخدام محرر نصوص عادي للتحقق من الأمر وتصحيحه (إذا لزم الأمر):

docker run ubuntu:latest
كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
تجنب الأحرف الخاصة

القولون بدون علامة

من أكثر الأخطاء شيوعًا وضع علامة نقطتين في نهاية اسم الصورة دون تضمين الوسم. على سبيل المثال، لنجرب الأمر التالي لسحب Node:

docker pull node:

يتوقع Docker قيمة بعد النقطتين، مثل latest أو 18-alpine أو أي وسم صالح آخر. في حال عدم تقديم أي قيمة، يُعتبر اسم الصورة غير مكتمل وسيؤدي إلى خطأ "تنسيق مرجع غير صالح".

كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
القولون بدون علامة

لإصلاح هذا الخطأ، أضف علامة مناسبة بعد النقطتين لجعل اسم الصورة كاملاً وصالحًا:

docker pull node:latest
كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
أضف علامات بعد النقطتين

يحتوي مسار الملف أو تحميل وحدة التخزين على مسافات

عند تضمين مسار ملف يحتوي على مسافات، خاصةً مع خيارات مثل -v (تركيب وحدة التخزين)، قد يُسيء Docker تفسير أجزاء من المسار كوسائط منفصلة أو حتى كجزء من اسم الصورة. نتيجةً لذلك، قد تواجه نتائج غير متوقعة، مثل تلك الموضحة أدناه:

docker run -v /home/user/My Folder:/app ubuntu
كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
المسافات في أسماء الملفات

لتجنب ذلك، قم دائمًا بإحاطة مسار الملف بمسافات بين علامتي اقتباس مزدوجتين، كما هو موضح أدناه:

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

استبدل "/home/user/My Folder" بالمسار الفعلي إلى الدليل الذي تريد تحميله في الحاوية.

الاستخدام غير المناسب للمتغيرات

عند العمل مع Docker، من الشائع استخدام متغيرات في الأوامر، خاصةً عند تحديد إصدارات الصور. مع ذلك، إذا لم يتم ضبط متغير مثل $VERSION بشكل صحيح، فقد يواجه Docker مشاكل مثل خطأ "تنسيق مرجع غير صالح".

على سبيل المثال، قم بتشغيل الأمر التالي لسحب Ubuntu من Docker Hub:

docker pull ubuntu:$VERSION

هنا، يُفترض أن يُمثل $VERSION إصدار نسخة أوبونتو التي تريد سحبها. ولكن إذا لم تُعيّن قيمةً له، فسيُفسّر Docker الأمر على أنه "docker pull ubuntu:". ينتج عن هذا اسم نسخة غير صالح لأنه ينتهي بنقطتين رأسيتين ويفتقر إلى وسم الإصدار المطلوب.

كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
الاستخدام غير الصحيح للمتغيرات

لتجنب ذلك، تأكد من تعريف جميع المتغيرات المستخدمة في الأمر بشكل صحيح. في لينكس، يمكنك تعيين متغير باستخدام الصيغة التالية.

$VERSION=latest

ثم قم بسحب الإصدار المحدد عن طريق تنفيذ الأمر التالي.

docker pull ubuntu:$VERSION

في Windows CMD، تحتاج إلى استخدام الكلمة الأساسية set لتحديد متغير (مثل version)، ثم استخدام صيغة %VARIABLE% للإشارة إليه في أوامر مثل docker pull.

set VERSION=latest
docker pull ubuntu:%VERSION%

هنا، يحتفظ $VERSION بأحدث قيمة، لذا يستخرج Docker نسخة ubuntu:latest دون أي مشاكل. يمكنك أيضًا تعيين إصدار محدد، مثل 18.04، إذا لزم الأمر.

كيفية إصلاح خطأ "Docker: تنسيق مرجعي غير صالح"
تعريف المتغيرات بشكل صحيح

مشكلة النسخ واللصق

أحيانًا ينسخ المستخدمون أوامر من دروس تعليمية أو وثائق عبر الإنترنت. قد تحتوي هذه الأوامر المنسوخة على أحرف مخفية، مثل المسافات غير المرئية، أو علامات الترقيم غير الإنجليزية، أو علامات الاقتباس الخاصة. قد تُفسد هذه الأحرف أوامر Docker الخاصة بك دون علمك.

لتجنب ذلك، من الأفضل أن تكتب الأمر بنفسك عندما يكون ذلك ممكنًا، أو أن تلصق الأمر في محرر نص عادي أولاً لإزالة التنسيق غير المرغوب فيه.

الآن بعد أن تعرفت على الأسباب الشائعة لخطأ "تنسيق مرجع غير صالح" في Docker وكيفية إصلاحه، ستكون على الطريق الصحيح لتجنب هذه المشكلة مستقبلًا. بدءًا من التحقق من الأحرف الكبيرة وصولًا إلى التأكد من ضبط متغيراتك بشكل صحيح، ستوفر عليك هذه النصائح البسيطة الكثير من الوقت والجهد. إذا كنت مستعدًا لمزيد من الاستكشاف، فقد ترغب أيضًا في تعلم كيفية وضع علامات على صور Docker المخصصة وإرسالها إلى سجل النظام، أو كيفية تنظيف الصور غير المستخدمة للحفاظ على نظافة نظامك.

Tags: #System
Sign up and earn $1000 a day ⋙

Leave a Comment

ما هي شبكة VPN؟ مزايا وعيوب شبكة VPN الافتراضية الخاصة

ما هي شبكة VPN؟ مزايا وعيوب شبكة VPN الافتراضية الخاصة

ما هو VPN، وما هي مزاياه وعيوبه؟ لنناقش مع WebTech360 تعريف VPN، وكيفية تطبيق هذا النموذج والنظام في العمل.

لا يستخدم معظم الأشخاص هذه الميزات المخفية في أمان Windows.

لا يستخدم معظم الأشخاص هذه الميزات المخفية في أمان Windows.

لا يقتصر أمان Windows على الحماية من الفيروسات البسيطة فحسب، بل يحمي أيضًا من التصيد الاحتيالي، ويحظر برامج الفدية، ويمنع تشغيل التطبيقات الضارة. مع ذلك، يصعب اكتشاف هذه الميزات، فهي مخفية خلف طبقات من القوائم.

البرمجة ليست صعبة كما تعتقد

البرمجة ليست صعبة كما تعتقد

بمجرد أن تتعلمه وتجربه بنفسك، ستجد أن التشفير سهل الاستخدام بشكل لا يصدق وعملي بشكل لا يصدق للحياة اليومية.

استعادة البيانات المحذوفة باستخدام برنامج Recuva Portable في نظام التشغيل Windows 7

استعادة البيانات المحذوفة باستخدام برنامج Recuva Portable في نظام التشغيل Windows 7

في المقالة التالية، سنقدم العمليات الأساسية لاستعادة البيانات المحذوفة في نظام التشغيل Windows 7 باستخدام أداة الدعم Recuva Portable. مع Recuva Portable، يمكنك تخزينها على أي وحدة تخزين USB مناسبة، واستخدامها وقتما تشاء. تتميز الأداة بصغر حجمها وبساطتها وسهولة استخدامها، مع بعض الميزات التالية:

كيفية حذف الملفات المكررة لتوفير ذاكرة الكمبيوتر باستخدام CCleaner

كيفية حذف الملفات المكررة لتوفير ذاكرة الكمبيوتر باستخدام CCleaner

يقوم برنامج CCleaner بالبحث عن الملفات المكررة في بضع دقائق فقط، ثم يسمح لك بتحديد الملفات الآمنة للحذف.

لماذا تغيير موقع التنزيل الافتراضي في Windows 11؟

لماذا تغيير موقع التنزيل الافتراضي في Windows 11؟

سيساعدك نقل مجلد التنزيل من محرك الأقراص C إلى محرك أقراص آخر على نظام التشغيل Windows 11 على تقليل سعة محرك الأقراص C وسيساعد جهاز الكمبيوتر الخاص بك على العمل بسلاسة أكبر.

كيفية إيقاف تحديثات Windows على جهاز الكمبيوتر

كيفية إيقاف تحديثات Windows على جهاز الكمبيوتر

هذه طريقة لتقوية نظامك وضبطه بحيث تحدث التحديثات وفقًا لجدولك الخاص، وليس وفقًا لجدول Microsoft.

كيفية إظهار امتدادات الملفات، عرض امتدادات الملفات على نظام التشغيل Windows

كيفية إظهار امتدادات الملفات، عرض امتدادات الملفات على نظام التشغيل Windows

يوفر مستكشف ملفات Windows خيارات متعددة لتغيير طريقة عرض الملفات. ما قد لا تعرفه هو أن أحد الخيارات المهمة مُعطّل افتراضيًا، مع أنه ضروري لأمان نظامك.

5 أدوات مجانية للعثور على برامج التجسس والإعلانات على جهاز الكمبيوتر الخاص بك

5 أدوات مجانية للعثور على برامج التجسس والإعلانات على جهاز الكمبيوتر الخاص بك

باستخدام الأدوات المناسبة، يمكنك فحص نظامك وإزالة برامج التجسس والبرامج الإعلانية والبرامج الضارة الأخرى التي قد تكون مختبئة في نظامك.

14 تطبيقًا وبرنامجًا لنظام Windows تحتاجها على جهاز الكمبيوتر الجديد الخاص بك

14 تطبيقًا وبرنامجًا لنظام Windows تحتاجها على جهاز الكمبيوتر الجديد الخاص بك

فيما يلي قائمة بالبرامج الموصى بها عند تثبيت جهاز كمبيوتر جديد، حتى تتمكن من اختيار التطبيقات الأكثر ضرورة والأفضل على جهاز الكمبيوتر الخاص بك!

كيفية استنساخ إعدادات Windows لنقل سير عملك إلى أي مكان

كيفية استنساخ إعدادات Windows لنقل سير عملك إلى أي مكان

قد يكون من المفيد جدًا حفظ نظام تشغيل كامل على ذاكرة فلاش، خاصةً إذا لم يكن لديك جهاز كمبيوتر محمول. ولكن لا تظن أن هذه الميزة تقتصر على توزيعات لينكس - فقد حان الوقت لتجربة استنساخ نظام ويندوز المُثبّت لديك.

قم بإيقاف تشغيل هذه الخدمات السبعة في Windows لإطالة عمر البطارية!

قم بإيقاف تشغيل هذه الخدمات السبعة في Windows لإطالة عمر البطارية!

إن إيقاف تشغيل بعض هذه الخدمات قد يوفر لك قدرًا كبيرًا من عمر البطارية دون التأثير على استخدامك اليومي.

ما فائدة اختصار Ctrl + Z في ويندوز؟ ربما أكثر مما تظن.

ما فائدة اختصار Ctrl + Z في ويندوز؟ ربما أكثر مما تظن.

Ctrl + Z هو مزيج مفاتيح شائع جدًا في ويندوز. يتيح لك Ctrl + Z التراجع عن إجراءات في جميع أقسام ويندوز.

لا تضغط على أي رابط مختصر حتى تتأكد من أنه آمن!

لا تضغط على أي رابط مختصر حتى تتأكد من أنه آمن!

تُعدّ الروابط المختصرة مفيدةً لإزالة الروابط الطويلة، لكنها تُخفي أيضًا وجهتها الحقيقية. إذا كنت ترغب في تجنّب البرامج الضارة أو التصيّد الاحتيالي، فإنّ النقر العشوائي على هذا الرابط ليس خيارًا حكيمًا.

Windows 11 22H2: تحديث Moment 1 مع العديد من الميزات البارزة

Windows 11 22H2: تحديث Moment 1 مع العديد من الميزات البارزة

بعد انتظار طويل، تم إطلاق التحديث الرئيسي الأول لنظام التشغيل Windows 11 رسميًا.

ما هي شبكة VPN؟ مزايا وعيوب شبكة VPN الافتراضية الخاصة

ما هي شبكة VPN؟ مزايا وعيوب شبكة VPN الافتراضية الخاصة

ما هو VPN، وما هي مزاياه وعيوبه؟ لنناقش مع WebTech360 تعريف VPN، وكيفية تطبيق هذا النموذج والنظام في العمل.

لا يستخدم معظم الأشخاص هذه الميزات المخفية في أمان Windows.

لا يستخدم معظم الأشخاص هذه الميزات المخفية في أمان Windows.

لا يقتصر أمان Windows على الحماية من الفيروسات البسيطة فحسب، بل يحمي أيضًا من التصيد الاحتيالي، ويحظر برامج الفدية، ويمنع تشغيل التطبيقات الضارة. مع ذلك، يصعب اكتشاف هذه الميزات، فهي مخفية خلف طبقات من القوائم.

البرمجة ليست صعبة كما تعتقد

البرمجة ليست صعبة كما تعتقد

بمجرد أن تتعلمه وتجربه بنفسك، ستجد أن التشفير سهل الاستخدام بشكل لا يصدق وعملي بشكل لا يصدق للحياة اليومية.

استعادة البيانات المحذوفة باستخدام برنامج Recuva Portable في نظام التشغيل Windows 7

استعادة البيانات المحذوفة باستخدام برنامج Recuva Portable في نظام التشغيل Windows 7

في المقالة التالية، سنقدم العمليات الأساسية لاستعادة البيانات المحذوفة في نظام التشغيل Windows 7 باستخدام أداة الدعم Recuva Portable. مع Recuva Portable، يمكنك تخزينها على أي وحدة تخزين USB مناسبة، واستخدامها وقتما تشاء. تتميز الأداة بصغر حجمها وبساطتها وسهولة استخدامها، مع بعض الميزات التالية:

كيفية حذف الملفات المكررة لتوفير ذاكرة الكمبيوتر باستخدام CCleaner

كيفية حذف الملفات المكررة لتوفير ذاكرة الكمبيوتر باستخدام CCleaner

يقوم برنامج CCleaner بالبحث عن الملفات المكررة في بضع دقائق فقط، ثم يسمح لك بتحديد الملفات الآمنة للحذف.

لماذا تغيير موقع التنزيل الافتراضي في Windows 11؟

لماذا تغيير موقع التنزيل الافتراضي في Windows 11؟

سيساعدك نقل مجلد التنزيل من محرك الأقراص C إلى محرك أقراص آخر على نظام التشغيل Windows 11 على تقليل سعة محرك الأقراص C وسيساعد جهاز الكمبيوتر الخاص بك على العمل بسلاسة أكبر.

كيفية إيقاف تحديثات Windows على جهاز الكمبيوتر

كيفية إيقاف تحديثات Windows على جهاز الكمبيوتر

هذه طريقة لتقوية نظامك وضبطه بحيث تحدث التحديثات وفقًا لجدولك الخاص، وليس وفقًا لجدول Microsoft.

كيفية إظهار امتدادات الملفات، عرض امتدادات الملفات على نظام التشغيل Windows

كيفية إظهار امتدادات الملفات، عرض امتدادات الملفات على نظام التشغيل Windows

يوفر مستكشف ملفات Windows خيارات متعددة لتغيير طريقة عرض الملفات. ما قد لا تعرفه هو أن أحد الخيارات المهمة مُعطّل افتراضيًا، مع أنه ضروري لأمان نظامك.

5 أدوات مجانية للعثور على برامج التجسس والإعلانات على جهاز الكمبيوتر الخاص بك

5 أدوات مجانية للعثور على برامج التجسس والإعلانات على جهاز الكمبيوتر الخاص بك

باستخدام الأدوات المناسبة، يمكنك فحص نظامك وإزالة برامج التجسس والبرامج الإعلانية والبرامج الضارة الأخرى التي قد تكون مختبئة في نظامك.

14 تطبيقًا وبرنامجًا لنظام Windows تحتاجها على جهاز الكمبيوتر الجديد الخاص بك

14 تطبيقًا وبرنامجًا لنظام Windows تحتاجها على جهاز الكمبيوتر الجديد الخاص بك

فيما يلي قائمة بالبرامج الموصى بها عند تثبيت جهاز كمبيوتر جديد، حتى تتمكن من اختيار التطبيقات الأكثر ضرورة والأفضل على جهاز الكمبيوتر الخاص بك!

كيفية استنساخ إعدادات Windows لنقل سير عملك إلى أي مكان

كيفية استنساخ إعدادات Windows لنقل سير عملك إلى أي مكان

قد يكون من المفيد جدًا حفظ نظام تشغيل كامل على ذاكرة فلاش، خاصةً إذا لم يكن لديك جهاز كمبيوتر محمول. ولكن لا تظن أن هذه الميزة تقتصر على توزيعات لينكس - فقد حان الوقت لتجربة استنساخ نظام ويندوز المُثبّت لديك.

قم بإيقاف تشغيل هذه الخدمات السبعة في Windows لإطالة عمر البطارية!

قم بإيقاف تشغيل هذه الخدمات السبعة في Windows لإطالة عمر البطارية!

إن إيقاف تشغيل بعض هذه الخدمات قد يوفر لك قدرًا كبيرًا من عمر البطارية دون التأثير على استخدامك اليومي.

ما فائدة اختصار Ctrl + Z في ويندوز؟ ربما أكثر مما تظن.

ما فائدة اختصار Ctrl + Z في ويندوز؟ ربما أكثر مما تظن.

Ctrl + Z هو مزيج مفاتيح شائع جدًا في ويندوز. يتيح لك Ctrl + Z التراجع عن إجراءات في جميع أقسام ويندوز.

لا تضغط على أي رابط مختصر حتى تتأكد من أنه آمن!

لا تضغط على أي رابط مختصر حتى تتأكد من أنه آمن!

تُعدّ الروابط المختصرة مفيدةً لإزالة الروابط الطويلة، لكنها تُخفي أيضًا وجهتها الحقيقية. إذا كنت ترغب في تجنّب البرامج الضارة أو التصيّد الاحتيالي، فإنّ النقر العشوائي على هذا الرابط ليس خيارًا حكيمًا.

Windows 11 22H2: تحديث Moment 1 مع العديد من الميزات البارزة

Windows 11 22H2: تحديث Moment 1 مع العديد من الميزات البارزة

بعد انتظار طويل، تم إطلاق التحديث الرئيسي الأول لنظام التشغيل Windows 11 رسميًا.