YAML ↔ JSON

لصق

معاينة

لماذا تنسيق ملفات Docker Compose بعناية؟

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

كيفية ترتيب إنشاء YML

  1. إذا كنت تستخدم التجاوزات، فابدأ بالملف الأساسي، ثم أضف أجزاء التجاوز حتى لا تلصق وحشًا مدمجًا أولاً.
  2. قم بالتنسيق للحصول على مسافة بادئة متسقة، ثم تحقق من أسماء الخدمات، وقم ببناء السياقات، والمنافذ المنشورة في عملية فحص مدتها دقيقتان.
  3. اختبر محليًا باستخدام نسخة جديدة بعد المشاركة، وقم بتحديث التعليقات أو مؤشرات README حيث لا يزال البشر يعتمدون على المعرفة القبلية خارج الملف.

الأسئلة الشائعة حول Docker Compose YML

إنشاء اختلافات بين الملفات v1 وv2 — هل يمكن أن يساعد هذا؟
يساعد المنسق على سهولة القراءة وليس التوافق. تحقق من إصدار مواصفات الإنشاء في الملف ومن أن يقوم عامل الإرساء المحلي بإنشاء اسم الأمر الفرعي.
وماذا عن الأسرار في أقسام البيئة؟
لا ترتكب مفاتيح حقيقية. استخدم مراجع env_file للملفات المحلية فقط، أو المديرين السريين، أو أنماط الحقن السرية المضمنة في نظامك الأساسي.
كيف يمكنني الاحتفاظ بمسارات المضيف المحمولة عبر أنظمة التشغيل macOS وLinux وWSL؟
قم بتفضيل عمليات الربط المرتبطة بالمشروع حيث يمكنك، وتوثيق المسارات الخاصة بنظام التشغيل بوضوح، واختبارها على أبطأ كمبيوتر محمول للفريق، وليس أسرع جهاز تطوير تمتلكه بمفردك.
More versions