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

يُسهّل 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

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 رسميًا.

كيفية إصلاح خطأ 0x80070020 (الملف قيد الاستخدام) في نظام التشغيل ويندوز 11

كيفية إصلاح خطأ 0x80070020 (الملف قيد الاستخدام) في نظام التشغيل ويندوز 11

هل تواجه مشكلة الخطأ المزعج 0x80070020 (ملف قيد الاستخدام) في نظام ويندوز 11؟ اكتشف حلولاً مجربة وفعّالة خطوة بخطوة لحل هذه المشكلة بسرعة واستعادة سلاسة عمل نظامك. لا حاجة لأي خبرة تقنية!

كيفية إصلاح خطأ رفض راحة اليد في لوحة اللمس في نظام التشغيل ويندوز 11

كيفية إصلاح خطأ رفض راحة اليد في لوحة اللمس في نظام التشغيل ويندوز 11

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

حل مشكلة عدم ظهور تأثيرات الأكريليك والميكا في نظام التشغيل ويندوز 11

حل مشكلة عدم ظهور تأثيرات الأكريليك والميكا في نظام التشغيل ويندوز 11

هل تواجه مشكلة في عدم ظهور تأثيرات الأكريليك والميكا في نظام التشغيل ويندوز 11؟ اكتشف حلولاً مجربة لاستعادة هذه الميزات البصرية الرائعة وتحسين تجربة سطح المكتب بسهولة.

كيفية إصلاح مشكلة الشبكة في الوضع الآمن لنظام التشغيل ويندوز 11

كيفية إصلاح مشكلة الشبكة في الوضع الآمن لنظام التشغيل ويندوز 11

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

كيفية إصلاح خطأ تحديد موضع واجهة برنامج Rainmeter في نظام التشغيل Windows 11

كيفية إصلاح خطأ تحديد موضع واجهة برنامج Rainmeter في نظام التشغيل Windows 11

هل تواجه مشاكل في ضبط موضع واجهة Rainmeter على نظام ويندوز 11؟ اكتشف حلولاً مجربة لمشاكل عدم المحاذاة، وسحب العناصر، واختلالات DPI. دليل خطوة بخطوة لاستعادة سطح مكتبك المثالي.

حل مشكلة عدم تعيين محرك أقراص WebDAV في نظام التشغيل Windows 11

حل مشكلة عدم تعيين محرك أقراص WebDAV في نظام التشغيل Windows 11

هل تواجه مشكلة في عدم ربط محرك أقراص WebDAV على نظام التشغيل Windows 11؟ اكتشف حلولاً مجربة وفعّالة خطوة بخطوة لإصلاح خطأ عدم ربط محرك أقراص WebDAV بسرعة واستعادة الوصول السلس إلى محركات أقراص الشبكة. تم تحديث هذه الحلول بأحدث نصائح استكشاف الأخطاء وإصلاحها لتحقيق أفضل أداء.

حل مشاكل إعدادات Winaero Tweaker في نظام التشغيل Windows 11

حل مشاكل إعدادات Winaero Tweaker في نظام التشغيل Windows 11

هل تواجه صعوبة في ضبط إعدادات Winaero Tweaker في نظام التشغيل Windows 11؟ يقدم لك هذا الدليل الشامل لحل المشكلات حلولاً خطوة بخطوة للمشاكل الشائعة، مما يضمن عمل تخصيصاتك بسلاسة تامة. اكتشف نصائح الخبراء لتحسين تجربتك اليوم.

حل مشكلة ذاكرة الرسومات المدمجة في نظام التشغيل ويندوز 11

حل مشكلة ذاكرة الرسومات المدمجة في نظام التشغيل ويندوز 11

هل تواجه مشكلة في ذاكرة الرسومات المدمجة في نظام التشغيل ويندوز 11؟ اكتشف خطوات مجربة لحل هذه المشكلة المزعجة، وتحسين أداء نظامك، والعودة إلى تجربة ألعاب سلسة وتعدد مهام سلس دون أي عناء.

حل مشكلة عدم تفعيل تقنية Dolby Vision في نظام التشغيل Windows 11

حل مشكلة عدم تفعيل تقنية Dolby Vision في نظام التشغيل Windows 11

هل تواجه مشكلة في تفعيل تقنية Dolby Vision على نظام Windows 11؟ اكتشف حلولاً خطوة بخطوة، ونصائح لحل المشكلات، وحلولاً من الخبراء للحصول على صور HDR نابضة بالحياة بسلاسة. ودّع الشاشات الباهتة إلى الأبد.

حل مشكلة برنامج تشغيل واجهة الصوت ASIO في نظام التشغيل Windows 11

حل مشكلة برنامج تشغيل واجهة الصوت ASIO في نظام التشغيل Windows 11

هل تواجه مشاكل مع برنامج تشغيل واجهة الصوت ASIO في نظام ويندوز 11؟ اكتشف حلولاً مجربة لاستعادة إنتاج صوتي سلس. حلول خطوة بخطوة للموسيقيين والمنتجين.

حل مشكلة تباطؤ سرعة محرك الأقراص ذي الحالة الصلبة (SSD) في نظام التشغيل ويندوز 11

حل مشكلة تباطؤ سرعة محرك الأقراص ذي الحالة الصلبة (SSD) في نظام التشغيل ويندوز 11

هل تعاني من بطء سرعة محرك الأقراص ذي الحالة الصلبة (SSD) على نظام التشغيل ويندوز 11؟ اكتشف حلولاً مجربة وفعّالة لمشكلة تباطؤ سرعة محرك الأقراص ذي الحالة الصلبة (SSD) لاستعادة الأداء فائق السرعة وتعزيز أداء جهاز الكمبيوتر الخاص بك.

حل مشكلة تغيير حساسية الماوس (DPI) تلقائيًا في نظام التشغيل ويندوز 11

حل مشكلة تغيير حساسية الماوس (DPI) تلقائيًا في نظام التشغيل ويندوز 11

هل تواجه مشكلة في تغيير حساسية الماوس (DPI) بشكل غير متوقع في نظام التشغيل ويندوز 11؟ اكتشف حلولاً مجربة لمشكلة تغيير حساسية الماوس (DPI) تلقائيًا، بدءًا من التعديلات البسيطة وصولاً إلى الحلول المتقدمة، لاستعادة التحكم السلس.

حل مشكلة عدم وجود إشارة في بطاقة التقاط الفيديو في ويندوز 11 (إصلاح مشكلة 60 إطارًا في الثانية)

حل مشكلة عدم وجود إشارة في بطاقة التقاط الفيديو في ويندوز 11 (إصلاح مشكلة 60 إطارًا في الثانية)

هل تواجه مشكلة انقطاع الإشارة عند استخدام بطاقة التقاط الفيديو في ويندوز 11 بمعدل 60 إطارًا في الثانية؟ اكتشف حلولًا مجربة لاستعادة سلاسة البث المباشر وتسجيل اللعب. حلول خطوة بخطوة لأداء سلس.

كيفية إصلاح مشكلة عدم العثور على قارئ البطاقات الذكية في نظام التشغيل ويندوز 11

كيفية إصلاح مشكلة عدم العثور على قارئ البطاقات الذكية في نظام التشغيل ويندوز 11

هل تواجه مشكلة في قارئ البطاقات الذكية في ويندوز 11؟ اكتشف حلولاً مجربة وفعّالة خطوة بخطوة لتشغيل قارئ البطاقات الذكية بسلاسة. لا حاجة لأي خبرة تقنية - عزز إنتاجيتك اليوم!

كيفية إصلاح خطأ توقف فهرسة البحث في ويندوز 11

كيفية إصلاح خطأ توقف فهرسة البحث في ويندوز 11

هل تواجه مشكلة في إيقاف فهرسة البحث في ويندوز 11؟ اكتشف خطوات مجربة لإصلاحها بسرعة، واستعادة البحث السلس، وتحسين أداء جهاز الكمبيوتر الخاص بك دون مشاكل تقنية.