الإجاباتمنشور13 المصادر
كيف تحدّث خدمة Docker من دون تعريض البريد للتوقف؟
التصميم المقترح يجمع بين مؤقّت أصلي في النظام، وصورة مثبتة بملخصها، وحالة معاملات محفوظة، ونسخة محلية صالحة للتراجع. التحديث يستهدف خدمة البوابة وحدها؛ إبقاء حاوية البريد دون إعادة تشغيل شرط أساسي لأن تخزينها في الذاكرة.
نشر بواسطةتم إنشاء الصور باستخدام GPT Image 2
إجابة البحث
الوجبات السريعة الرئيسية
- التصميم المقترح يجمع بين مؤقّت أصلي في النظام، وصورة مثبتة بملخصها، وحالة معاملات محفوظة، ونسخة محلية صالحة للتراجع.
- التحديث يستهدف خدمة البوابة وحدها؛ إبقاء حاوية البريد دون إعادة تشغيل شرط أساسي لأن تخزينها في الذاكرة.
- لا يمكن ضمان فحص عبر الإنترنت يستغرق أقل من ثانية في كل مرة، ولا يضمن استبدال الحاوية الواحدة انقطاعاً صفرياً أو حفظ كل الطلبات الجارية.
- هذه خطة تنفيذ وليست نظاماً جرى تثبيته أو اختباره؛ لم تُشغّل على خادمي VPS ولم تُكتب ملفات إلى البيئة.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/B3egknR1IVfeJSaXyo3fOaAAn3A2/images/3347EE210CC13BD84006/B94F72DF9F7393927186.png)
موجّه الذكاء الاصطناعي
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"建议采用“宿主机原生定时器＋摘要固定部署＋持久事务状态＋本地镜像回滚”，不引入更新容器。本方案条件可行：跨公网检查远端摘要无法保证每次亚秒级完成；当前单实例网关重建也不能保证零停机或在途请求无损。\n\n 本次交付仅为会话草案与实现契约，没有写入文件、运行测试或操作两台异地 VPS。\n 对于正常运行的宿主机与 . Topic tags: general web, llm, agents, ai, workflow. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with
الخلاصة: تحديث محافظ، لا وعد بانقطاع صفري
النهج الأنسب لهذه الحالة هو تشغيل التحديث من المضيف نفسه عبر مؤقّت أصلي مثل systemd، مع تثبيت صورة Docker بملخصها (digest)، وحفظ حالة كل عملية على القرص، والاحتفاظ بصورة محلية يمكن الرجوع إليها. لا حاجة إلى إضافة حاوية مخصّصة للتحديث.
لكن لهذا النهج حدوداً مهمة: لا يمكن ضمان أن يفحص الاتصال عبر الإنترنت ملخص الصورة في أقل من ثانية في كل مرة. كما أن إعادة إنشاء حاوية بوابة واحدة لا تضمن انقطاعاً صفرياً، ولا تضمن إكمال الطلبات المتدفقة أو الجارية. والخطة أدناه مقترح تنفيذ فقط؛ لم تُنشأ الملفات المذكورة، ولم تُشغّل اختبارات، ولم يُجرَ أي تغيير على الخادمين.
ما نعرفه عن التطبيق الحالي
- مسار النشر يَقبل وسوماً مثل
v3.12، وينشرlatestو3.12وv3.12ووسم commit قصيراً. لا يظهر فيه إنشاء وسم متحرك باسمv3.x، كما أن تعريف معماريات متعددة في سير العمل لا يثبت وحده نجاح إصدار بعينه. المرجع:.github/workflows/build_docker.yml:19. - إعداد الخدمة الحالي يبني البوابة من المصدر، ويربط المنفذ المحلي
8080، ويُبقي مجلد الإعدادات للقراءة فقط. ويستخدم البريد تخزيناً في الذاكرة؛ لذلك ينبغي أن يبقى حاوي البريد خارج أي عملية إعادة إنشاء. المرجع:docker-compose.yml:1. - صورة الإصدار تشغّل نقطة الدخول في جذر المشروع، بينما يعتمد بدء التطبيق على إعداد محلي لسجل النماذج لا تنسخه الصورة. لذلك لا يكفي توفير الصورة وحدها؛ يجب أن تظل ملفات الإعداد اللازمة موجودة على الخادم. المراجع:
Dockerfile:13وmain.go:21. - معالج قائمة النماذج في نقطة الدخول الحالية يقرأ لقطة من السجل ولا ينفّذ طلب محادثة حقيقياً. كما أن نقطة الصحة الحالية تعطي إشارة بقاء ثابتة؛ ولا يثبت أيٌّ منهما وحده أن الحسابات جاهزة أو أن المحادثة تعمل فعلياً. المراجع:
internal/api/models.go:23وinternal/api/chat.go:2078. - عند تلقي إشارة الإنهاء، يلغي التطبيق سياق الخدمة، ويمنح إغلاق HTTP مهلة خمس ثوانٍ. لذلك فإن زيادة مهلة إيقاف الحاوية لا تكفي وحدها لحماية كل طلب طويل أو تدفّق جارٍ. المرجع:
main.go:233.
حدود النطاق: لا تعديل للبريد، ولا نقل لحالة الحسابات أثناء التشغيل، ولا ترقية للاعتماديات، ولا جلب للمصدر من الخادم، ولا تغيير لطريقة بناء نسخة التطوير المحلية. كما لا تتضمن الخطة ترحيلاً غير متوافق للإعدادات ما لم تُصمَّم له آلية قابلة للعكس.
آلية التحديث والتراجع
ينبغي أن يعمل التحديث من المضيف، بحساب محمي يملك صلاحية إدارة Docker، لا من داخل حاوية تحصل على مقبس Docker أو بيانات دخول المستودع. وهذا لا يلغي مخاطر صلاحيات المضيف: الحساب الذي يدير Docker يظل حساباً حساساً.
1. اكتشاف الإصدار وتثبيته
يُستخدم وسم مثل latest لاكتشاف ما إذا كان هناك إصدار جديد، لكن التشغيل الفعلي يكون دائماً بعنوان صورة مثبت بملخصها. يدعم Docker Compose تحديد الصورة بملخص (digest) 1. ويجب التمييز بين ملخص الفهرس متعدد المنصات، وملخص بيان المنصة، ومعرّف الصورة المحلي؛ فهي قيم مختلفة ولا يصح مقارنتها مباشرة.
قبل التحديث، تُسجّل الأداة صورة الحاوية العاملة ومعرّفها، وتحتفظ بوسم محلي مخصص للصورة المقبولة حالياً. بهذه الطريقة، لا يعتمد التراجع على نجاح اتصال جديد بالمستودع.
2. معاملة محفوظة قبل إعادة الإنشاء
تُحفظ حالة كل عملية في ملف بيانات يُحلّل بصيغة صارمة ولا يُنفّذ كنص برمجي. تُكتب الحالة أولاً إلى ملف مؤقت في المجلد نفسه، ثم تُستبدل ذرياً؛ وينبغي أيضاً تنفيذ ما يلزم لحفظ البيانات على القرص. إعادة تسمية الملف وحدها ليست ضماناً كافياً للنجاة من انقطاع الطاقة.
يحتوي سجل المعاملة، على الأقل، على الإصدارين القديم والجديد، ومعرّفات الصور والحاوية السابقة، وبصمة الإعدادات، والمرحلة التي وصلت إليها العملية. إذا أعيد تشغيل المضيف أو انقطع التنفيذ، تفحص الأداة المعاملة غير المكتملة وتتعامل معها قبل محاولة تحديث جديد.
3. خطوات التحديث
- طلب قفل حصري مشترك للتحديث والتراجع والتهيئة والتنظيف. إذا كان القفل مشغولاً، يخرج التشغيل الجديد بهدوء.
- فحص أي معاملة غير مكتملة، ثم التحقق من اسم مشروع Compose، ومن وجود حاوية بوابة واحدة، ومن بصمة الإعدادات وهوية حاوية البريد. إذا اكتشفت الأداة تغييرات يدوية غير متوقعة، تتوقف بدلاً من الاستيلاء عليها.
- فحص بيان الصورة البعيد فقط، من دون تنزيل طبقات الصورة. فشل الشبكة أو المصادقة أو تحليل البيان يعني الإبقاء على الخدمة الحالية؛ ولا يجوز اعتبار ملخص فارغ إصداراً جديداً.
- إذا كان الملخص مطابقاً للإصدار المقبول، لا تنزيل ولا إعادة إنشاء ولا سجل تحديث. ويُعزل الملخص الذي فشل سابقاً لتجنب إعادة نشر الصورة المعطوبة في كل دورة، إلى أن يظهر ملخص جديد أو يرفع مسؤول العزل يدوياً.
- تنزيل الصورة المثبتة بملخصها، والتحقق من توافر صورة المنصة المحلية ومن مساحة القرص، مع إبقاء البوابة القديمة تعمل طوال التنزيل.
- حفظ صورة التراجع وتسجيل مرحلة الاستعداد على القرص، ثم إعادة إنشاء خدمة البوابة وحدها.
- التحقق من أن الحاوية الجديدة تستخدم الصورة المقصودة، وأنها تعمل وتنجح في اختبار الصحة. لا يُسجّل الإصدار الجديد على أنه مقبول قبل اجتياز هذه الخطوة.
- عند فشل الإنشاء أو انتهاء مهلة الصحة، تُعاد خدمة البوابة باستخدام صورة التراجع المحلية والإعدادات الأصلية، ثم يُعاد اختبار الصحة.
- إذا نجح التراجع، تُستعاد إشارة الإصدار المنشور ويُعزل الملخص الفاشل مع تسجيل النتيجة. وإذا فشل، تُحفظ مواد الاستعادة ويصدر إنذار؛ لا تبدأ الأداة حلقة إعادة تشغيل غير محدودة.
في أمر Compose، يمكن توجيه إعادة الإنشاء إلى خدمة بعينها، مع --no-deps و--no-build و--pull never لمنع تشغيل الخدمات المرتبطة أو بناء صورة أو سحبها أثناء هذه الخطوة 2. ويجب ألا تستخدم العملية أمراً يعيد تشغيل المشروع كله أو يحذف الخدمات اليتيمة.
انتهاء مهلة الأمر لا يعني أن عملية Docker الخلفية توقفت. عند انتهاء المهلة، يلزم فحص حالة الحاويات أولاً ومنع عمليتي تبديل متنافستين. كما لا يمكن الاعتماد على معالج الخروج عند انقطاع الطاقة أو الإنهاء القسري؛ لذلك يعتمد التعافي على المعاملة المحفوظة واستعادتها عند التشغيل التالي.
4. اختبار صحة لا يعطي نجاحاً زائفاً
يمكن اعتماد نافذة أولية مقدارها 60 ثانية، ومهلة اتصال ثانية واحدة، وحد أقصى ثلاث ثوانٍ للطلب، واستطلاع كل ثانيتين، مع اشتراط ثلاث نتائج ناجحة متتالية قبل اعتماد الصورة. هذه قيم مقترحة وليست نتائج قياس.
ينبغي أن يطلب الاختبار قائمة النماذج محلياً، ويتحقق من استجابة HTTP 200 ومن بنية JSON المتوقعة، من دون اتباع التحويلات. كما يجب التأكد من أن الحاوية التي تجيب هي الحاوية الجديدة وأن عدّاد إعادة تشغيلها لا يتصاعد. لا ينبغي اعتبار نقطة الصحة الثابتة وحدها دليلاً على جاهزية الخدمة، ولا تثبيت عدد تاريخي معين من النماذج كشرط نجاح من دون سند في عقد السجل الحالي.
ولا تقترح الخطة إرسال طلب محادثة حقيقي تلقائياً، إذ قد يستهلك ذلك رصيداً أو مورداً. اختبار إتاحة المحادثة الفعلية يظل مرحلة تحقق مستقلة.
إعداد الخادمين والمستودع الخاص
يُعدّل ملف نشر كل خادم بعيد فقط لتحديد مصدر الصورة، مع الإبقاء على المنافذ وحدود الذاكرة والسجلات ومتغيرات البيئة ومجلد الإعدادات للقراءة فقط وإعداد البريد. لا ينبغي استبدال ملف التطوير المحلي docker-compose.yml؛ موضع تعديل مصدر بناء البوابة هو docker-compose.yml:26.
services:
app:
image: "${APP_IMAGE:?يجب تحديد عنوان صورة مثبت وموثوق}"
pull_policy: never
هذا مقطع استبدال لا ملف Compose كاملاً. يجب أن يحتوي مجلد النشر على تعريفات الخدمات الكاملة، وأن يُزال حقل بناء البوابة منه. كما يجب أن يشير المتغير المحفوظ إلى ملخص إصدار مقبول أو وسم محلي للتراجع، لا إلى latest عند إعادة التشغيل اليدوية.
ينبغي تثبيت اسم مشروع Compose الفعلي والتحقق منه على كل خادم، لا افتراض أنه واحد على الخادمين أو مطابق لاسم المشروع المحلي. كذلك يجب الحفاظ على متغيرات البيئة البعيدة كما هي؛ فملف استبدال متغيرات Compose ليس هو نفسه بيئة الحاوية، ولا يعني وضع قيمة في أحدهما أنها تصل تلقائياً إلى الآخر. ويجب مراجعة مفاتيح الميزات التجريبية في الإعداد البعيد بدلاً من نسخ إعداد التطوير المحلي عليه، لا سيما أن حدود المشروع الأساسية تُبقيها مغلقة افتراضياً. المراجع: docker-compose.yml:38 و_bmad-output/project-context.md:246.
للسحب من GHCR، يحتاج الخادم إلى بيانات اعتماد قراءة لحزمة خاصة. توثّق GitHub استخدام رمز وصول شخصي من النوع classic لمصادقة Container Registry؛ ويُمنح الرمز نطاق read:packages مع التحقق من أن الحساب يستطيع قراءة الحزمة، واستكمال تفويض SSO إذا كانت المؤسسة تشترطه 9. يُفضّل استخدام رمز مستقل قابل للإلغاء لكل خادم، وإدخاله عبر الإدخال القياسي بدلاً من وضعه في معاملات الأوامر أو السجلات. تُحفظ بيانات المصادقة في مجلد خاص لا يقرأه إلا المسؤول وأداة التحديث، ولا تُمرر إلى حاوية البوابة أو البريد. فشل المصادقة يوقف التحديث من دون المساس بالخدمة القائمة.
الجدولة عبر systemd
يمكن أن يكون systemd الخيار الأصلي للمضيف: خدمة لمرة واحدة تنفّذ التحديث، ومؤقّت يعيد تشغيلها بعد انقضاء فترة من انتهاء آخر تشغيل. المثال التالي تصور أولي لمكوّني خدمة ومؤقّت، وليس إعداداً مثبتاً على الخادمين:
[Service]
Type=oneshot
User=root
WorkingDirectory=/opt/aurora
Environment=DOCKER_CONFIG=/etc/aurora-updater/docker
ExecStart=/opt/aurora/scripts/auto-update.sh
TimeoutStartSec=20min
UMask=0077
Nice=10
IOSchedulingClass=idle
NoNewPrivileges=yes
StandardOutput=journal
StandardError=journal
[Timer]
OnBootSec=1min
OnUnitInactiveSec=5min
RandomizedDelaySec=30s
AccuracySec=1s
Unit=aurora-update.service
هذه المواعيد أمثلة قابلة للمراجعة وليست قيماً اختُبرت على الخادمين. قبل تفعيل المؤقّت، يلزم التحقق من الأدوات والإعدادات، وبناء نقطة تراجع صحية، وتجربة سيناريوهات الاستعادة في بيئة معتمدة. ويمكن إزاحة مواعيد الخادمين لتجنب بدء التنزيل والتحديث عليهما في اللحظة نفسها.
التدرّج بين الخادمين يحقق تقارباً نهائياً في الإصدارات، لا تبديلًا ذرياً متزامناً. فإذا تراجعت إحدى العقدتين بسبب إصدار معطوب، فبقاؤها مؤقتاً على الإصدار السابق أكثر أماناً من إعادة محاولة الإصدار نفسه تلقائياً. كما أن تخفيض أولوية أداة التحديث لا يضمن خفض ذروة استخدام CPU التي قد يسببها فك ضغط الصورة بواسطة Docker؛ وهذا يحتاج إلى قياس على الأجهزة الفعلية.
السجلات وتنظيف الصور
تُسجّل الأداة وقت الحدث بتوقيت UTC، ومعرّف الخادم والمعاملة، والملخصين القديم والجديد، والمرحلة والمدة ونتيجة اختبار الصحة والتراجع. ولا تسجل كلمات المرور أو كامل متغيرات البيئة أو حسابات البريد أو نص الاستجابة. ويمكن وضع سياسة أولية لتدوير سجل الأداة أسبوعياً، أو عند بلوغه 1 ميغابايت، مع ضغط 26 نسخة؛ لكنها سياسة مقترحة تحتاج إلى تأكيد ولا ينبغي أن تغيّر سياسة سجلات المضيف العامة.
أما تنظيف الصور فيجب أن يقتصر على الصور التي سجّلها نظام التحديث بوصفها ملكاً له، وأن يستخدم القفل نفسه. تُحمى دائماً الصورة الحالية، وآخر صورة مقبولة، وكل صورة مرتبطة بمعاملة غير مكتملة. وقبل حذف أي صورة، يجب التحقق من أن حاوية قائمة لا تستخدمها، ومن أنها ليست موسومة لاستخدام آخر. حتى الصورة غير الموسومة لا تُحذف تلقائياً لمجرد أنها تبدو غير مستخدمة؛ فقد تكون مادة تراجع يدوية. وإذا لم تكفِ المساحة قبل تنزيل إصدار جديد، يتوقف التحديث بدلاً من حذف آخر نسخة تراجع.
خطة التنفيذ والتحقق
- جرد الخادمين: التحقق من المنصة وإصدارات الأدوات واسم مشروع Compose والإعدادات المثبتة وصلاحيات بيانات الدخول والصورة الصحية الحالية، ثم حفظ نقطة تراجع أولية.
- إنشاء أداة التحديث: تنفيذ اكتشاف الملخصات، والمعاملات المحفوظة، وإعادة إنشاء خدمة واحدة، والتحقق الصحي، والتراجع، وعزل الصور الفاشلة. تُختبر أولاً في بيئة معتمدة لا على الإنتاج.
- إضافة الجدولة والصيانة: توصيل الخدمة بالمؤقّت، ومراجعة السجلات والتنظيف، واختبار التشغيل المتداخل وانتهاء المهلة والإيقاف غير المتوقع والتعافي بعد إعادة التشغيل.
- التدرّج: تفعيل التحديث على خادم واحد والتحقق عملياً من نجاح التحديث والتراجع، ثم الانتقال إلى الخادم الثاني.
تشمل معايير القبول: ألا يؤدي تطابق الملخص إلى سحب طبقات أو إعادة إنشاء أو كتابة سجل تحديث؛ وألا يتغير معرّف حاوية البريد أو وقت بدء تشغيلها أو محتوى اختبار البريد قبل التحديث وبعده؛ وأن يعيد كل من فشل الصورة أو فشل الصحة الخدمة إلى الصورة السابقة حتى عند تعذّر الاتصال بـ GHCR؛ وأن تتعافى المعاملات غير المكتملة من دون نشر الملخص المعزول مراراً؛ وألا يحدث بناء للصورة أو كشف لبيانات الدخول أو حذف لصورة محمية.
الحكم النهائي: الخطة مناسبة بشرط قبول نافذة تبديل قصيرة للبوابة، واعتبار الأداء عبر الإنترنت هدفاً يُقاس لا ضماناً دون الثانية، والتحقق أولاً من واقع إعداد الخادمين. لا توجد حالياً نتائج تشغيل تثبت التوافق أو زمن الفحص أو اكتمال مسار التراجع؛ ما سُلّم هنا هو تصميم ومواصفات تنفيذ، لا نظاماً جاهزاً أو تغييرات مطبقة.
Studio Global AI
مواصلة البحث الخاص بك
تتضمن هذه الصفحة إجابة مدعومة بالمصدر يمكنك المتابعة داخل Studio Global.
يسأل الناس أيضا
ما هي الإجابة المختصرة على "كيف تحدّث خدمة Docker من دون تعريض البريد للتوقف؟"؟
التصميم المقترح يجمع بين مؤقّت أصلي في النظام، وصورة مثبتة بملخصها، وحالة معاملات محفوظة، ونسخة محلية صالحة للتراجع.
ما هي النقاط الأساسية التي يجب التحقق منها أولاً؟
التصميم المقترح يجمع بين مؤقّت أصلي في النظام، وصورة مثبتة بملخصها، وحالة معاملات محفوظة، ونسخة محلية صالحة للتراجع. التحديث يستهدف خدمة البوابة وحدها؛ إبقاء حاوية البريد دون إعادة تشغيل شرط أساسي لأن تخزينها في الذاكرة.
ماذا يجب أن أفعل بعد ذلك في الممارسة العملية؟
لا يمكن ضمان فحص عبر الإنترنت يستغرق أقل من ثانية في كل مرة، ولا يضمن استبدال الحاوية الواحدة انقطاعاً صفرياً أو حفظ كل الطلبات الجارية.