خيارات Swarm ووجهات السجلات

كل إعدادات Docker Swarm التي يمكن أن يملكها التطبيق إلى جانب حجمه وأمره، وأيها يحتاج عنقودك الخاص، وكيف ترسل السجلات إلى Loki أو Elastic أو Graylog أو Splunk.

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

اضبطها في لوحة التحكم (صفحة التطبيق، خيارات Swarm)، أو بالأمر isogrid apps options <app>، أو في ملف stack حيث تُقرأ مفاتيح compose المعتادة.

ما يمكنك ضبطه

المجال	الخيارات	مفاتيح compose
التوزيع	توزيع النسخ حسب تسمية عقدة، أقصى عدد من النسخ لكل جهاز، وحدات المعالجة المحجوزة لكل نسخة	`deploy.placement.preferences` و`max_replicas_per_node` و`deploy.resources.reservations.cpus`
الحاوي	دليل العمل، اسم المضيف، إشارة الإيقاف، عملية init، نظام ملفات للقراءة فقط، TTY، حدود ulimit، حد العمليات، مجموعات إضافية، صلاحيات مُزالة	`working_dir` و`hostname` و`stop_signal` و`init` و`read_only` و`tty` و`ulimits` و`group_add` و`cap_drop`
الملفات	ملفات إعداد تُصنع من نص (Swarm configs)	`configs` مع `content:` مكتوب مباشرة
الشبكة	أسطر `/etc/hosts` إضافية، خوادم DNS ونطاقات البحث وخياراته، عنوان لكل نسخة (`dnsrr`)	`extra_hosts` و`dns` و`dns_search` و`dns_opt` و`deploy.endpoint_mode`
السجلات	وجهة المخرجات	`logging.driver` و`logging.options`

الملفات للإعدادات غير السرية. أما الأسرار فمكانها الخزنة، وتصل إلى الحاوي كملفات أو متغيرات.

الخيارات التي تحتاج عنقودك الخاص

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

الصلاحيات المضافة (cap_add) وإعدادات النواة (sysctls)
درجة OOM (oom_score_adj)
شبكة الجهاز (network_mode: host): يغادر التطبيق حينها شبكته الخاصة
أدلة الجهاز (bind mounts)
المنافذ المنشورة على الأجهزة (ports مع mode: host أو mode: ingress)
موارد العقدة مثل وحدات GPU (generic_resources)
نسخة على كل جهاز (deploy.mode: global). الانتقال إلى هذا الوضع أو منه يعيد إنشاء الخدمة مع انقطاع قصير، ولا يمكن تغيير عدد نسخ مثل هذا التطبيق يدويًا ولا تلقائيًا.
رفع أي حد غير nofile، أو جعله بلا حد

على عنقود يديره وكيل Nomad، تحتاج الخيارات التي تمنح صلاحيات الجذر على الجهاز (الصلاحيات، sysctls، درجة OOM، شبكة الجهاز، bind mounts) إلى موافقة الوكيل أيضًا: اضبط ISOGRID_NOMAD_ALLOW_PRIVILEGED=true على الوكيل. من دونها يرفضها الوكيل مهما طلبت ISOGrid.

أين تذهب السجلات

افتراضيًا تبقى المخرجات على الجهاز، حيث تقرؤها لوحة التحكم والبحث في السجلات. ويمكنك إرسالها إلى مكان آخر:

مشغّلات Docker نفسها: syslog وgelf (Graylog وLogstash) وfluentd وsplunk، وعلى عنقودك الخاص فقط awslogs وgcplogs وjournald، التي تستخدم هوية الجهاز أو سجله.
إضافات السجلات: Grafana Loki وElastic. تُثبَّت الإضافة أولًا على كل جهاز في المنطقة: isogrid regions log-plugins <region> --install loki، أو بالزر في لوحة خيارات Swarm. تعمل الإضافة بصلاحيات الجذر على كل جهاز، لذا تثبّتها على عنقود هو ملكك؛ وفي المنطقة المشتركة يقرر مشغّلو ISOGrid.

isogrid apps options shop --log-driver loki \
  --log-secret-opt loki-url=https://USER:TOKEN@logs.example.com/loki/api/v1/push --deploy

تواصل لوحة التحكم عرض المخرجات أيًّا كانت الوجهة: يحتفظ Docker بنسخة محلية بحجم سجلاتك المحفوظة. والوجهة البطيئة أو المتوقفة لا تعطّل التطبيق أبدًا: تُخزَّن المخرجات مؤقتًا (4 ميغابايت) ويُترك ما يتجاوز ذلك.

الرمز أو كلمة المرور في خيار سجل مكانهما الخيارات السرية: يُحفظان في مخزن الأسرار ولا يُعرضان مرة أخرى. وعلى عنقود يديره وكيل Nomad الخاص بك، اكتب القيمة بصيغة {{secret:<reference>}} بدلًا من ذلك، لتبقى في Vault الخاص بك.

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

البحث في سجلات JSON

عندما يكتب تطبيقك أسطر JSON، يقرؤها البحث كحقول. المستوى هو مستوى أداة التسجيل نفسها (level وseverity وأرقام pino)، والرسالة هي msg، وتُصفّى الحقول بـ @:

الاستعلام	ما يطابقه
`@status>=500`	مقارنة رقم (`>` و`>=` و`<` و`<=`)
`@http.method:GET`	مساواة دون مراعاة حالة الأحرف؛ الحقول المتداخلة بالنقاط
`@user.id:*`	وجود الحقل
`@path:/api/*`	يبدأ بـ
`@msg~timeout`	يحتوي على
`-@env:dev`	ليس ذلك

وتُجمع كما من قبل مع الكلمات والعبارات وlevel: وreplica:.

الدليل

ما هي ISOGrid — منصّة سحابية بُنيت في الجزائر، لفرق تريد إطلاق منتجاتها دون إدارة خوادم.

البداية — من حساب إلى شيء يعمل على الإنترنت.

مستوى خبرتك — ثلاثة أسئلة عند أول تسجيل دخول تحدد تنظيم صفحتك الرئيسية وطريقة حديث المساعد معك - ولا شيء غير ذلك.

نشر تطبيق — من مستودع إلى عنوان يعمل، وما يحدث في كل خطوة.

كيف يُكتشف البناء — أيّ الملفات تُعدّ Dockerfile أو ملف Compose، وكيف يُعثر على المنفذ، وما يحدث حين يوجد أكثر من مرشّح أو لا يوجد أيّ مرشّح.

ملفات Compose وملفات stack — نشر ملف Docker Compose أو ملف stack خاص بـ Swarm - ما يُطبَّق، وما لا يُطبَّق، وما يفعله تطبيق الملف مرة أخرى.

خيارات Swarm ووجهات السجلات — كل إعدادات Docker Swarm التي يمكن أن يملكها التطبيق إلى جانب حجمه وأمره، وأيها يحتاج عنقودك الخاص، وكيف ترسل السجلات إلى Loki أو Elastic أو Graylog أو Splunk.

مستودعات Git — ربط GitHub أو GitLab، وتحديد من في المؤسّسة يجوز له البناء من مستودعاتك، وما يحدث حين تغادر.

العناوين والنطاقات — العنوان الذي يحصل عليه كل تطبيق، واستخدام اسمك الخاص بدلًا منه، وما الذي يتعطّل حين تكون إعدادات DNS خاطئة.

اربط شبكتك الخاصة (بوابة VPN) — اصِل إلى خدمات شبكة خاصة من حاسوبك المحمول أو مكتبك أو سحابة أخرى، بالاسم المستعار، عبر بوابة WireGuard تفتحها من صفحة الشبكات.

قواعد البيانات — طلب قاعدة بيانات، وما ينجو منه كل ترتيب، ولماذا لا يُعدّ النسخ المتماثل نسخة احتياطية.

البحث المتّجهي والذكاء الاصطناعي مع pgvector — خزّن التضمينات (embeddings) في قاعدة بيانات PostgreSQL الخاصة بك وابحث فيها بالمعنى - تفعيل pgvector، ومثال يعمل، والفهارس، وما ينبغي التحقّق منه أولًا.

تخزين الكائنات — المخازن والحاويات، وما تنجو منه العقدة الواحدة والعقد المتعدّدة، والمفاتيح المحدودة بحاويات معيّنة، والاتصال عبر S3.

وحدات التخزين — قرص يعمّر أطول من النسخة. من أين يأتي، وما ينجو منه، وكيف تتصفّحه وتأخذ منه نسخًا احتياطية.

الخدمات المُدارة — Kafka و RabbitMQ و Redis و Keycloak - ما تحصل عليه، وما ينجو منه كل ترتيب، وكيف يتّصل بها التطبيق.

عناقيد خاصة دون ارتهان لمزوّد — ما يعمل على أجهزتك هو Docker Swarm أو Kubernetes قياسي، ويستمر في العمل إن غادرت.

Supabase — خلفية برمجية كاملة على PostgreSQL بنشر واحد - ما الذي تحصل عليه، وأيّ قاعدة تختار، وأين مفاتيحك.

عنقودك الخاص مع وكيل Nomad — انشر من لوحة ISOGrid على Docker Swarm أو Kubernetes تديره بنفسك، دون منح ISOGrid أي وصول إلى أجهزتك أو أسرارك.

Wazuh (مراقبة الأمان) — نظام SIEM و XDR مفتوح المصدر في عملية نشر واحدة - ما الذي تحصل عليه، وكيف تربط أجهزتك به، وما الذي يبقى على عاتقك.

الأدوار ومجموعات الصلاحيات والوصول — الطبقات الثلاث التي تحدّد ما يجوز لكل عضو فعله، والمجموعات التي تبدأ بها كل مؤسّسة، والقواعد التي تمنع أي أحد من الترقّي بنفسه.

البيئة المعزولة في استوديو الذكاء الاصطناعي — مساحة العمل خلف كل مشروع في الاستوديو - تشغيلها وإيقافها مؤقتًا وإعادة تشغيلها، وما يحدث حين تُترك دون استخدام، وكيف تعود ملفاتك.

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

واجهة REST API — العنوان، وكيف يسجّل سكربت الدخول، وكيف تُختار المؤسّسة، وكيف تبدو الأخطاء، مع أمثلة كاملة بـ curl.

الأسعار والفوترة — أسعار الاشتراك، ولماذا تُحدَّد أسعار الموارد لكل منطقة، وما يُدفع مسبقًا وما يُدفع بالساعة، وما يحدث حين ينفد الرصيد، وكيف تحصل على فاتورة.

حين تسوء الأمور — الأعطال التي يُرجَّح أن تصادفها، وما يعنيه كل منها فعلًا، وما العمل.

سطر الأوامر

تثبيت واجهة سطر الأوامر — أمر واحد على Linux أو macOS أو Windows، وبصمة تحقّق لكل تنزيل، وطريقة التحديث والإزالة.

مرجع الأوامر — كل مجموعة أوامر، وما تفعله، وأين يُشرح كل منها بالتفصيل.

أتمتة التطبيقات — أنشئ التطبيقات واضبطها وانشرها واحذفها من الطرفية أو من سكربت، مع شرح كل خيار.

النشر من CI/CD — انشر عند كل دفع من GitHub Actions أو GitLab CI/CD، ببيانات اعتماد محدودة ومهمّة تفشل حين يفشل النشر.

المستودعات والمجموعات والصلاحيات — حدّد من يستطيع البناء من مستودع، وأدِر مجموعات الصلاحيات، واعرف من يملك ماذا، من الطرفية.

دروس تطبيقية

نشرك الأول — من مستودع إلى عنوان يعمل، مع التنبيه إلى الأخطاء قبل أن تقع فيها.

تطبيق مع قاعدة بيانات — واجهة API وقاعدة PostgreSQL مُدارة، يربط بينهما سرّ، تعملان بنسختين، مع نسخة احتياطية استعدتها مرة واحدة.

انشر عند كل دفع — من نشر أول يدوي إلى نشر عند كل دفع، من GitHub Actions أو GitLab CI/CD، ببيانات اعتماد لا تستطيع أكثر من ذلك، وما يحدث حين يفشل إصدار.

السياسات

التوافرية والدعم — ما تلتزم به المنصّة، وما لا تلتزم به، وكيف تصل إلى إنسان.

الاستخدام المقبول — ما يجوز لك تشغيله، وما لا يجوز، وما يحدث إن تجاوزت حدًّا.

الخصوصية — البيانات الشخصية التي تحتفظ بها ISOGrid، ولماذا، ومن يطّلع عليها غيرنا، وكم تُحفظ، وكيف تحذف حسابك.