docker compose، واربط الخدمات بأسمائها عبر الشبكة الافتراضية التي ينشئها Compose.","html":"يحتاج notes-api إلى Postgres. تستطيع تشغيل الاثنين بأمرَي docker run، وشبكة مصنوعة يدويًا، وصفحة من الخيارات، ثم تشرح ذلك كله من جديد لأول شخص ينضمّ إلى الفريق. Compose يستبدل ذلك بملف واحد في المستودع يصف البيئة كاملة، وأمر واحد يحوّلها إلى واقع.
أنشئ compose.yaml بجوار الـ Dockerfile:
name: notes\n\nservices:\n api:\n build: .\n image: notes-api:dev\n ports:\n - \"8080:3000\"\n environment:\n PORT: \"3000\"\n DATABASE_URL: postgres://notes:notes@db:5432/notes\n\n db:\n image: postgres:17\n environment:\n POSTGRES_USER: notes\n POSTGRES_PASSWORD: notes\n POSTGRES_DB: notesخدمتان. api تُبنى من الـ Dockerfile في هذا المجلد وتحمل الـ tag notes-api:dev؛ وdb تستخدم الـ image الرسمية لـ Postgres 17، التي تنشئ نقطة دخولها المستخدم وقاعدة البيانات من هذه المتغيّرات الثلاثة عند أول تشغيل. وname: notes يضبط اسم المشروع، الذي يُضاف كبادئة إلى كل ما ينشئه Compose.
حين تحتوي الخدمة على build: وimage: معًا، يبني Compose من الـ Dockerfile ويعطي النتيجة الاسم الموجود في image:. هذا يمنح الـ image المحلية اسمًا متوقّعًا تستطيع تشغيله يدويًا أيضًا، بدلًا من الاسم الافتراضي الذي كان Compose سيولّده من اسمَي المشروع والخدمة.
لا يوجد سطر version:. Compose v2 يطبّق مواصفة Compose (Compose Specification)، وإذا نسخت ملفًا قديمًا يبدأ بـ version: "3.8"، فسيتجاهله Compose ويحذّر من أن الخاصية قديمة. احذفه.
الأمر هو docker compose، بمسافة. هذا Compose v2، إضافة لواجهة Docker CLI. أما docker-compose القديم المكتوب بـ Python والموصول بشرطة فقد تقاعد منذ سنوات، والدروس التي تستخدمه قديمة من نواحٍ أخرى أيضًا.
docker compose up -d --build\ndocker compose ps\ndocker compose logs -f api\ncurl localhost:8080/readyzالأمر up يبني الـ image إن لزم، وينشئ شبكة، ويشغّل كلا الـ containers، ثم يعود. و--build يفرض إعادة البناء حتى تُلتقط تغييرات الكود. والآن يجيب /readyz بـ ready، لأن الـ API يستطيع الوصول إلى قاعدة البيانات.
الأمر docker compose ps يعرض الـ containers التي أنشأها Compose، مسمّاة باسم المشروع والخدمة ورقم: notes-api-1 وnotes-db-1. الرقم موجود لأن الخدمة الواحدة قد تشغّل عدّة containers متطابقة. وكل الأوامر تأخذ أسماء الخدمات لا أسماء الـ containers، فنادرًا ما تكتب الاسم الكامل.
أوامر أخرى ستستخدمها يوميًا:
\ndocker compose exec db psql -U notes -d notes # SQL shell in the db container\ndocker compose restart api # restart one service\ndocker compose down # stop and remove containers and networkالأمر up تصريحي (declarative): يقارن الملف بما يعمل، ولا يغيّر إلا الفرق. عدّل متغيّرات بيئة الـ API وشغّل up -d مجددًا، فيعيد Compose إنشاء api بينما يستمر db في العمل. Kubernetes يعمل بالفكرة نفسها على نطاق أكبر بكثير؛ وستقابله في القسم الرابع.
ينشئ Compose شبكة للمشروع، notes_default، ويربط كل خدمة بها. على تلك الشبكة، يحلّ DNS الخاص بـ Docker كل اسم خدمة إلى الـ container الخاص بها. لهذا يقول DATABASE_URL @db:5432.
لاحظ أن db ليس فيه مدخل ports:. يصل إليه الـ API عبر شبكة المشروع؛ ولا يستطيع ذلك أي شيء على حاسوبك أو على شبكة مكتبك. إن أردت توجيه عميل SQL مكتبي إليه، فانشره على الـ loopback فقط: "127.0.0.1:5432:5432".
في البيئات الأكبر، تستطيع التصريح بالشبكات وربط كل خدمة بما يخصّها فقط. قاعدة البيانات على شبكة backend لا يمكن أن تصل إليها واجهة ويب أمامية لا تنضمّ إلا إلى frontend:
services:\n web:\n networks: [frontend]\n api:\n networks: [frontend, backend]\n db:\n networks: [backend]\n\nnetworks:\n frontend:\n backend:لـ notes-api تكفي الشبكة الافتراضية. الجأ إلى هذا حين تحتوي البيئة على مكوّنات يجب ألا يتحدّث بعضها إلى بعض أبدًا.
\nCompose ممتاز لثلاث مهام: التطوير المحلي، واختبارات التكامل في الـ CI (شغّل البيئة، ونفّذ الاختبارات، ثم فكّكها)، والخدمات الصغيرة التي تعيش على مضيف واحد. ما لا يفعله هو توزيع الـ containers على أجهزة متعدّدة، أو نقلها حين يموت جهاز، أو نشر إصدار جديد تدريجيًا مع مراقبة فحوص الصحة. هذه مهام المنسّق (orchestrator)، وهي ما يفعله Kubernetes في القسم الرابع. والعادات التي تبنيها هنا تنتقل معك مباشرة: صرّح بالحالة المرغوبة في ملف، ودع أداة تحقّقها، واربط الخدمات بأسمائها.
\nتبقى مشكلة واحدة. شغّل docker compose down، ثم up مجددًا، فتجد أن كل الملاحظات اختفت: خزّن Postgres بياناته في الـ layer القابلة للكتابة داخل الـ container، والتي حذفها down. الدرس التالي يعطي قاعدة البيانات مكانًا دائمًا تعيش فيه.
compose.yaml يصرّح بالخدمات والشبكات والـ volumes؛ والأمر docker compose up ينشئ كل ما هو ناقص ويترك الباقي كما هو.","Compose v2 هو الإضافة docker compose؛ والمفتاح version: في المستوى الأعلى قديم ويجب حذفه.","كل خدمة تنضمّ إلى الشبكة الافتراضية للمشروع ويمكن الوصول إليها باسمها، لذا يتّصل الـ API بـ db:5432 لا بـ localhost.","انشر على المضيف المنافذ التي تحتاج إليها فقط؛ وقاعدة البيانات التي لا يتحدّث معها إلا الـ API لا تحتاج إلى مدخل ports: إطلاقًا."],"further":[{"title":"How Compose works","url":"https://docs.docker.com/compose/intro/compose-application-model/"},{"title":"Networking in Compose","url":"https://docs.docker.com/compose/how-tos/networking/"},{"title":"Compose file reference","url":"https://docs.docker.com/reference/compose-file/"}],"quiz":[{"q":"داخل الـ container api، أي مضيف في DATABASE_URL يصل إلى خدمة Postgres المسمّاة db؟
db، اسم الخدمة، الذي يحلّه DNS شبكة Compose إلى container قاعدة البيانات.","why":"صحيح. الخدمات على شبكة Compose نفسها يجد بعضها بعضًا باسم الخدمة."},{"text":"localhost، لأن كلا الـ containers يعمل على الجهاز نفسه.","why":"لكل container network namespace خاصة به. localhost داخل api هو container الـ API نفسه، ولا شيء يستمع فيه على 5432."},{"text":"host.docker.internal، الذي يشير دائمًا إلى الـ containers الأخرى.","why":"هذا الاسم يشير إلى جهازك المضيف. لا يعمل إلا إذا كان منفذ قاعدة البيانات منشورًا هناك، ويربط التطبيق بحاسوبك."},{"text":"عنوان IP الخاص بـ container قاعدة البيانات من docker inspect.","why":"يعمل إلى أن يُعاد إنشاء الـ container ويحصل على IP جديد. الأسماء ثابتة؛ وعناوين IP ليست كذلك."}],"answer":0},{"q":"تضيف version: "3.8" في أعلى compose.yaml. ماذا يفعل Docker Compose الحالي بها؟
version قديمة.","why":"صحيح. احذف السطر؛ فهو لا يفعل شيئًا."},{"text":"ينزّل إصدار Compose المطابق.","why":"لا يجلب Compose نفسه أبدًا بناءً على الملف. الإضافة docker compose المثبّتة لديك هي التي تعمل."}],"answer":2},{"q":"قاعدة Postgres في بيئة Compose لديك لا يستخدمها إلا api. أي إعداد ports: يجب أن يكون لـ db؟
"5432:5432"، حتى يصل إليها الـ API.","why":"يصل إليها الـ API عبر شبكة Compose دون أي منفذ منشور. والنشر يعرضها على كل واجهات المضيف."},{"text":""0.0.0.0:5432:5432"، للتصريح بالاستماع في كل مكان.","why":"هذا مطابق للافتراضي، ويضع قاعدة بياناتك على شبكة Wi-Fi المكتب مع كلمة مرور تطوير."},{"text":""5432"، الذي ينشرها على منفذ عشوائي في المضيف.","why":"ما زال يمكن الوصول إليها من شبكة المضيف، فقط على منفذ أقل وضوحًا."},{"text":"لا شيء إطلاقًا؛ أضف "127.0.0.1:5432:5432" فقط إن احتجت إلى عميل رسومي محلي.","why":"صحيح. الحركة بين الـ containers لا تحتاج إلى منافذ منشورة، والنشر على الـ loopback فقط يُبقيها خارج الشبكة."}],"answer":3},{"q":"تغيّر متغيّرات البيئة لخدمة api فقط في compose.yaml وتشغّل docker compose up -d. ماذا يحدث للـ container db الذي يعمل؟
db لم يتغيّر، فلا يُمسّ."},{"text":"يستمر في العمل دون أن يُمسّ؛ لا يعيد Compose إنشاء إلا الخدمات التي تغيّرت إعداداتها.","why":"صحيح. up يوفّق كل خدمة مع الملف ويترك الخدمات غير المتغيّرة وشأنها."},{"text":"يتوقّف ويحتاج إلى docker compose start db منفصل.","why":"الأمر up لا يوقف الخدمات التي هي أصلًا في الحالة المرغوبة."},{"text":"يُعلَّق مؤقتًا بينما يُعاد تشغيل api، ثم يُستأنف.","why":"لا يعلّق Compose الاعتماديات أثناء إعادة الإنشاء."}],"answer":1}],"exercise":{"kind":"spot-bug","language":"yaml","code":"services:\n api:\n build: .\n ports:\n - \"8080:3000\"\n environment:\n DATABASE_URL: postgres://notes:notes@localhost:5432/notes\n db:\n image: postgres:17\n ports:\n - \"5432:5432\"\n environment:\n POSTGRES_USER: notes\n POSTGRES_PASSWORD: notes\n POSTGRES_DB: notes","bugLines":[7,11],"title":"خطآن في Compose، واتصال واحد","prompt":"مع ملف compose.yaml هذا، يكتب الـ API في سجلّه ECONNREFUSED 127.0.0.1:5432، وزميل على شبكة Wi-Fi المكتب اتّصل للتوّ بقاعدة بياناتك بكلمة المرور notes. اختر السطرين الاثنين المسؤولين.
api، إلى ماذا يشير localhost؟","هل يحتاج الـ API إلى منفذ منشور للوصول إلى قاعدة البيانات عبر شبكة Compose؟"],"explanation":"السطر 7 يوجّه الـ API إلى localhost، وlocalhost داخل container الـ API هو الـ API نفسه. استخدم اسم الخدمة: postgres://notes:notes@db:5432/notes.
السطر 11 ينشر Postgres على كل واجهات المضيف، فيستطيع أي شخص على شبكتك الوصول إليه. الـ API لا يحتاج إلى ذلك؛ فالـ containers تتحدّث عبر شبكة المشروع. احذف كتلة ports:، أو اربط على الـ loopback إن احتجت إلى عميل SQL محلي:
ports:\n - \"127.0.0.1:5432:5432\"