الخدمات
تغطي هذه الصفحة نشر وإدارة الخدمات المحتوية، بما في ذلك ملفات Rediaccfile وشبكات الخدمات والتشغيل/الإيقاف والعمليات المجمّعة والتشغيل التلقائي.
ملف Rediaccfile
Rediaccfile هو سكريبت Bash يحدد كيف يتم تشغيل الخدمات وإيقافها. يتم استدعاؤه (وليس تنفيذه كعملية منفصلة)، لذا تشاركه الدوال نفس السياق الحد وتملك الوصول إلى جميع متغيرات البيئة المُصدّرة. يجب أن يكون اسمه Rediaccfile أو rediaccfile (غير حساس لحالة الأحرف) ويوضع داخل نظام ملفات المستودع المحمّل.
يتم اكتشاف ملفات Rediaccfile في موقعين:
- جذر مسار تحميل المستودع
- المجلدات الفرعية من المستوى الأول لمسار التحميل (غير تكراري)
يتم تخطي المجلدات المخفية (الأسماء التي تبدأ بـ .).
دوال دورة الحياة
ينفّذ renet دوال Rediaccfile التالية:
| الدالة | وقت التشغيل | الغرض | سلوك الخطأ |
|---|---|---|---|
up() | عند التشغيل | بدء الخدمات (مثل renet compose -- up -d) | فشل الجذر حرج (يوقف كل شيء). فشل المجلدات الفرعية غير حرج (يُسجّل ويستمر) |
down() | عند الإيقاف | إيقاف الخدمات (مثل renet compose -- down) | أفضل جهد — الأخطاء تُسجّل لكن تُنفّذ جميع ملفات Rediaccfile دائماً |
health() | عند rdc repo health وعند rdc machine health وفي فحص الصحة أثناء النشر | الإبلاغ عن صحة المستودع نفسه: رمز الخروج 0 سليم، 1 تحذير، 2 خطأ | تُنفَّذ health() في كل ملف Rediaccfile ويُعتدّ بأسوأ مستوى. يعني الرمز 75 أن المستودع ما زال في طور الإحماء (تحذير). أي رمز خروج آخر أو إشارة أو انتهاء المهلة يُعدّ خطأ (يقرأ فحص سلامة النشر انتهاء المهلة على أنه ما زال في طور الإحماء ويعيد المحاولة، انظر المهل الزمنية وترتيب الإيقاف). المستودع الذي لا يعرّف أي Rediaccfile فيه health() يُبلغ لا يوجد فحص ولا يُعدّ سليمًا أبدًا |
repair() | عند rdc repo repair وعند rdc machine repair لمستودع لا تكون health() فيه سليمة | إصلاح ما أبلغت عنه health() في الملف نفسه | لا تعمل إلا إذا كانت health() في ملفها غير سليمة وكان الصنف المعلن مسموحًا به (انظر أدناه). إذا خرجت health() بالرمز 75 (ما زال في طور الإحماء) فهذا يُعدّ تحذيرًا، ولذلك ينبغي أن يترك repair() المستودع الذي ما زال يبدأ وشأنه. بعد ذلك تعمل health() مرة أخرى. فشل repair() أو انتهاء مهلته يُعدّ خطأ |
كل دالة اختيارية. إذا لم تُعرّف دالة، يتم تخطيها بصمت.
إعلان صنف الإصلاح
تتلقى repair() المتغيرين REDIACC_HEALTH_LEVEL (warning أو error، وهو المستوى الذي أبلغت عنه health() في ملفها نفسه) وREDIACC_HEALTH_OUTPUT (ذيل مخرجات تلك health()). يعلن سطر تعليق مدى أمان الدالة:
# rediacc:repair class=auto-safe
# rediacc:repair class=auto-with-backup window=only
| الصنف | من ينفّذه |
|---|---|
auto-safe | ينفّذه rdc machine repair وrdc repo repair من تلقاء نفسيهما |
auto-with-backup | يعمل فقط مع --with-backup، بعد لقطة ناجحة للمستودع |
operator-only | لا يعمل من تلقاء نفسه أبدًا. يسأل rdc repo repair أولًا (أو يقبل --yes)؛ أما rdc machine repair فلا ينفّذه أبدًا |
repair() بلا إعلان تُعدّ operator-only، فلا تشغّل أي أداة شيفرة مستودع دون إشراف ما لم يصرّح المستودع بأنها آمنة. يضيف window=only شرطًا ثانيًا: تعمل الدالة فقط داخل نافذة الصيانة الخاصة بالجهاز (المراقبة) أو مع --window-override. وعندما تعلن عدة أسطر صنفًا، يُعتدّ بالأكثر تقييدًا.
ترتيب التنفيذ
- التشغيل (
up): Rediaccfile الجذر أولاً، ثم المجلدات الفرعية بـترتيب أبجدي (A إلى Z). - الإيقاف (
down): المجلدات الفرعية بـترتيب أبجدي عكسي (Z إلى A)، ثم الجذر أخيراً.
متغيرات البيئة
عند تنفيذ دالة Rediaccfile، تكون متغيرات البيئة التالية متاحة:
| المتغير | الوصف | مثال |
|---|---|---|
REDIACC_WORKING_DIR | مسار تحميل المستودع | /mnt/rediacc/mounts/abc123 |
REDIACC_REPOSITORY | معرّف GUID للمستودع | a1b2c3d4-e5f6-... |
REDIACC_NETWORK_ID | معرّف الشبكة (عدد صحيح) | 2816 |
DOCKER_HOST | مقبس Docker للعملية المعزولة لهذا المستودع | unix:///var/run/rediacc/net-2816/docker-2816.sock |
{SERVICE}_IP | عنوان IP الحلقي لكل خدمة معرّفة في .rediacc.json | POSTGRES_IP=127.0.11.2 |
يتم إنشاء متغيرات {SERVICE}_IP} تلقائياً من خلال تعيينات الفتحات في .rediacc.json وتُصدّر قبل تنفيذ دوال Rediaccfile. تحوّل قاعدة التسمية اسم الخدمة إلى أحرف كبيرة مع استبدال الشرطات بشرطات سفلية، ثم تضيف _IP. على سبيل المثال، الخدمة باسم listmonk-app مع فتحة 0 تصبح LISTMONK_APP_IP=127.0.11.2.
تحذير: لا تستخدم
sudo dockerفي ملفات Rediaccfile. أمرsudoيعيد تعيين متغيرات البيئة، مما يعني فقدانDOCKER_HOSTواستهداف أوامر Docker لعملية النظام بدلاً من العملية المعزولة للمستودع. هذا يكسر عزل الحاويات وقد يسبب تعارضات في المنافذ. سيمنع Rediacc التنفيذ إذا اكتشفsudo docker.استخدم
renet composeفي ملفات Rediaccfile، فهو يتعامل تلقائياً معDOCKER_HOSTويحقن تسميات الشبكة لاكتشاف المسارات ويهيئ شبكات الخدمات. راجع الشبكات لتفاصيل كيفية كشف الخدمات عبر الوكيل العكسي. إذا استدعيت Docker مباشرة، استخدمdockerبدونsudo: تصل دوال Rediaccfile إلى عملية Docker الخاصة بالمستودع بصفة المستخدم العام، دون root (انظر الامتيازات).
renetهي أداة منخفضة المستوى بعيدة. لسير العمل الطبيعي للمستخدم من محطة العمل، فضّل أوامرrdcمثلrdc repo upوrdc repo down. راجع rdc vs renet.
الامتيازات
تعمل up() وdown() بصفة المستخدم العام (rediacc)، لا root، داخل بيئة معزولة (sandbox) تقيّد المواضع التي يمكنها القراءة منها والكتابة إليها. تُبنى البيئة للدالة بدلاً من وراثتها، فتحمل المتغيرات المذكورة أعلاه وقيم REDIACC_SECRET_* الخاصة بالمستودع وPATH أدنى. لا يتوفر sudo في أي مستوى: تضبط البيئة المعزولة no_new_privs، فيفشل سطر في Rediaccfile يستخدم sudo ويجب حذفه. ترفض الآلة التي لا تدعم Landlock تشغيل up() وdown() بدلاً من تشغيلهما دون قيود.
السطر الذي يحتاج إلى أكثر من الإعداد الافتراضي يفشل بالخطأ الذي تعطيه البيئة المعزولة، ويطبع السجل (journal) وواجهة CLI السطر المطابق من Rediaccfile مع أمر الإذن.
| ما يفعله Rediaccfile | ما يظهر له | الحل |
|---|---|---|
sudo x | sudo: The "no new privileges" flag is set | احذف sudo. الخطوة إما لا تحتاج إلى root أو تحتاج إلى إذن |
chown 5050 ... أو rm -rf لمجلد تملكه حاوية | Operation not permitted / Permission denied | شغّل الخطوة في حاوية لمرة واحدة (جذر داخل الحاوية؛ ويرفض Docker daemon الخاص بالمستودع عمليات الربط خارج الجذور الخاصة بالمستودع نفسه): renet compose -- run --rm --no-deps --user 0 --entrypoint chown <service> -R 5050:5050 /data |
يكتب .env أو ملفات أخرى في نقطة التحميل | يعمل؛ الملفات تعود للمستخدم العام | لا شيء |
يقرأ /etc/rediacc/* أو /proc/kcore أو جهاز كتل | Permission denied | اطلب إذن مسار |
| يقرأ سرّ ملف مباشرة | Permission denied | استخدم secrets: في compose أو سرّاً بنمط env |
nvidia-smi دون إذن جهاز | الجهاز مفقود | امنح إذن الجهاز، انظر وحدات GPU |
sysctl -w | Permission denied | اضبطه مرة واحدة على الآلة بصفة مسؤول |
طلب إذن
يوسّع الإذن ما يمكن أن تصل إليه up() وdown(). لا يمنحه إلا المشغّل، من خارج المستودع:
rdc repo permission grant <repo-ref> --path /srv/data:rw
rdc repo permission grant <repo-ref> --root
rdc repo permission show <repo-ref>
rdc repo permission revoke <repo-ref> --path /srv/data
يضيف --path قاعدة Landlock واحدة، للقراءة فقط ما لم يُحدَّد :rw، وترفض الآلة أي مسار يصل إلى مستودع آخر أو مخزن البيانات (datastore) أو /etc/rediacc. يشغّل --root الدوال بصفة root دون إسقاط الامتيازات، ويرفض النسخ الاحتياطي البارد مستودعاً كهذا. لا يستطيع الوكلاء (agents) منح --root إلا إذا ضبط المشغّل REDIACC_ALLOW_GRAND_REPO قبل بدء الوكيل. للفرع (fork) معرّف شبكة جديد ويبدأ بلا إذن، ويُهمَل أي إذن يوجد تحت معرّف شبكة أُعيد استخدامه.
يمكن لـ Rediaccfile أن يعلن ما يحتاجه بسطر تعليق، بوصفه طلباً فقط:
# rediacc:needs root
# rediacc:needs path=/srv/data
# rediacc:needs device=nvidia.com/gpu=all
تقارن up() الإعلان بالإذن. عندما يغيب الإذن تُرفض up() قبل تشغيل أي سطر، وتطبع الرسالة أمر الإذن بالضبط. لا تفحص down() الإعلان أبداً، حتى لا يستطيع تعليق معدَّل داخل المستودع منع repo down الخاص بالمشغّل؛ أما down() التي تحتاج الإذن فعلاً فتفشل في خطوتها. يتخطى machine converge مستودعاً كهذا بالحالة needs_lifecycle_grant بدلاً من إعادة تشغيله نحو الرفض.
المهل الزمنية وترتيب الإيقاف
لا تتوقف حاويات المستودع قبل أن تعمل الدالة down() الخاصة به وتنتهي. ينطبق ذلك على systemctl stop وrestart لوحدة Docker الخاصة بالمستودع، وعلى machine converge وrepo down --unmount وإعادة كتابة الوحدة وإيقاف تشغيل المضيف. الاستثناءات هي انهيار خدمة Docker أو المضيف، وانقطاع التيار، ودالة down() تتجاوز مهلتها، سواء عند إيقاف تشغيل المضيف أو عند systemctl stop أو restart. تُنهى هذه down() ويستمر الإيقاف كما هو موضح أدناه.
تشغّل كل وحدة Docker خطاف إيقاف قبل إرسال الإشارة إلى الخدمة. ينفّذ الخطاف down() على الخدمة التي لا تزال تعمل، ما لم يكن renet قد نفّذها في بدء الخدمة هذا، ويتخطاها إذا لم تستجب الخدمة أو لم يكن للمستودع ملف Rediaccfile. عند إيقاف تشغيل المضيف تتوقف وحدات Docker أولًا وتنفّذ كل منها down() بالتوازي، ثم تفصل وحدة كنس كل المستودعات المركّبة، سواء كان التشغيل التلقائي مفعّلًا أم لا. ميزانية الإيقاف للوحدة 17 دقيقة، وهي تتسع ضمن حد 30 دقيقة لمهمة إعادة التشغيل. إذا انتهت مهلة down() داخل هذا الخطاف، تتلقى مجموعة عملياتها SIGTERM ثم SIGKILL بعد 10 ثوانٍ (FunctionKillGrace، pkg/orchestration/procgroup.go)، ويُسجَّل تحذير ويخرج الخطاف برمز 0، فتواصل systemd الإيقاف. لذلك تؤخّر down() المنتهية المهلة systemctl stop أو إعادة التشغيل بمقدار مهلتها زائد 10 ثوانٍ كحد أقصى (15 دقيقة و10 ثوانٍ عند الحد الأقصى)، ويبقى الإيقاف محدودًا بقيمة TimeoutStopSec للوحدة وهي 17 دقيقة. الرفض الذي يمنع الإيقاف ينطبق فقط على مسارات renet نفسها، مثل repo down --unmount.
تحصل up() وdown() افتراضيًا على 10 دقائق لكل منهما، وتُضبط عبر RENET_UP_TIMEOUT وRENET_DOWN_TIMEOUT أو --up-timeout و--down-timeout. عند انتهاء المهلة تتلقى مجموعة العمليات SIGTERM ثم SIGKILL بعد 10 ثوانٍ. المسار الذي يحتاج إلى down() أولًا، مثل repo down --unmount أو إعادة التشغيل عند converge، يترك الحاويات تعمل إذا انتهت مهلة down()، ويتابع الخيار --force. يمكن لملف Rediaccfile رفع الحد بسطر تعليق:
# rediacc:timeout up=20m down=15m backup=120s health=60s repair=10m
| المفتاح | الافتراضي | الحد الأقصى |
|---|---|---|
up | 10 دقائق | 60 دقيقة |
down | 10 دقائق | 15 دقيقة |
backup | 30 ثانية | 300 ثانية |
health | 30 ثانية | 300 ثانية |
repair | 5 دقائق | 30 دقيقة |
تخضع health() للتقييد نفسه: يُضبط افتراضيها بـ RENET_HEALTH_TIMEOUT، وعند انتهاء المهلة تتلقى مجموعة عملياتها SIGTERM ثم SIGKILL بعد 10 ثوانٍ. يعامل فحص الصحة أثناء النشر health() التي انتهت مهلتها على أنها ما زالت في طور الإحماء ويعيد المحاولة؛ أما rdc repo health وrdc machine health فتُبلغان عنها كخطأ. تتبع repair() النموذج نفسه مع RENET_REPAIR_TIMEOUT، ويُعدّ repair() الذي انتهت مهلته فاشلًا.
التوجيه يرفع الحد فقط ويُقصّ عند حده الأقصى، فلا يستطيع المستودع تقصير down() إلى حد قتله قسرًا. تُتجاهل المفاتيح غير المعروفة مع تحذير.
تُبقي خدمات المستودعات ميزة live-restore في Docker معطّلة. كانت الحاويات ستنجو من إعادة تشغيل الخدمة، لكن عمليات shim تشارك مجموعة cgroup الخاصة بالوحدة وتُنهى معها، فلا تستطيع الخدمة المستعادة إعادة الارتباط بها، وستُبقي الحاويات نقطة التركيب مشغولة عند إيقاف مخطط له.
وحدة تخزين RAM يديرها renet لكل مستودع (# rediacc:ram size=6G، وتمنح الجهةُ المشغِّلة ذاكرة المضيف) مجرد تصميم ولم يُنفَّذ بعد.
مثال
#!/bin/bash
up() {
echo "Starting services..."
renet compose -- up -d
}
down() {
echo "Stopping services..."
renet compose -- down
}
مهم: استخدم دائماً
renet compose --بدلاً منdocker compose. غلافrenet composeيفرض شبكة المضيف وتخصيص عناوين IP وتسميات اكتشاف الخدمات المطلوبة بواسطة renet-proxy. تُضاف قدرات CRIU checkpoint/restore للحاويات التي تحمل تسميةrediacc.checkpoint=true. يتم رفض الاستخدام المباشر لـdocker composeبواسطة التحقق من صحة Rediaccfile. راجع الشبكات للتفاصيل.
تسميات الصلاحيات
تعمل الحاويات بحد أدنى من صلاحيات Linux افتراضياً. تنضم الخدمة إلى صلاحيات إضافية بإضافة تسمية في docker-compose.yml الخاص بها:
| التسمية | تمنح | تُستخدم لـ |
|---|---|---|
rediacc.checkpoint=true | CHECKPOINT_RESTORE، SYS_PTRACE، NET_ADMIN | نقطة تفتيش/استعادة CRIU (الترحيل المباشر، الحفظ والاستئناف) |
rediacc.wireguard=true | NET_ADMIN بالإضافة إلى جهاز /dev/net/tun | تشغيل عميل WireGuard داخل الحاوية |
services:
vpn:
image: alpine
labels:
- "rediacc.wireguard=true"
تتيح rediacc.wireguard للخدمة إنشاء نفق WireGuard، لتوجيه عملية واحدة مثلاً عبر نقطة نهاية بعيدة. بما أن كل خدمة تعمل بشبكة المضيف، احصر النفق في نطاق شبكة داخل الحاوية حتى لا يُغير توجيه المضيف. خيارات الامتياز الواسعة كـ privileged: true وpid: host وipc: host تبقى مرفوضة بصرف النظر عن التسميات، سواء عند التحقق من compose أو على واجهة Docker البرمجية، حيث يرد خادم المستودع بالرمز 403.
تخطيط متعدد الخدمات
للمشاريع ذات مجموعات خدمات مستقلة متعددة، استخدم المجلدات الفرعية:
/mnt/rediacc/repos/my-app/
├── Rediaccfile # Root: shared setup
├── docker-compose.yml
├── database/
│ ├── Rediaccfile # Database services
│ └── docker-compose.yml
├── backend/
│ ├── Rediaccfile # API server
│ └── docker-compose.yml
└── monitoring/
├── Rediaccfile # Prometheus, Grafana, etc.
└── docker-compose.yml
ترتيب التنفيذ لـ up: الجذر، ثم backend، database، monitoring (A-Z).
ترتيب التنفيذ لـ down: monitoring، database، backend، ثم الجذر (Z-A).
شبكات الخدمات (.rediacc.json)
يحصل كل مستودع على شبكة فرعية /26 (64 عنوان IP) في نطاق 127.x.x.x الحلقي. ترتبط الخدمات بعناوين IP حلقية فريدة بحيث يمكنها العمل على نفس المنافذ دون تعارض.
ملف .rediacc.json
يربط أسماء الخدمات بأرقام الفتحات (slots). تتوافق كل فتحة مع عنوان IP فريد ضمن الشبكة الفرعية للمستودع.
{
"services": {
"api": {"slot": 0},
"postgres": {"slot": 1},
"redis": {"slot": 2}
}
}
الإنشاء التلقائي من Docker Compose
لا تحتاج إلى إنشاء .rediacc.json يدوياً. عند تشغيل rdc repo up، يقوم Rediacc تلقائياً بما يلي:
- فحص جميع المجلدات التي تحتوي على Rediaccfile بحثاً عن ملفات compose (
docker-compose.ymlأوdocker-compose.yamlأوcompose.ymlأوcompose.yaml) - استخراج أسماء الخدمات من قسم
services: - تعيين الفتحة التالية المتاحة للخدمات الجديدة
- حفظ النتيجة في
{repository}/.rediacc.json
حساب عنوان IP
يُحسب عنوان IP للخدمة من معرّف شبكة المستودع وفتحة الخدمة. يتم توزيع معرّف الشبكة على الثُمانية الثانية والثالثة والرابعة من عنوان الاسترجاع 127.x.y.z. تحصل الخدمات على إزاحة تبدأ من 2:
| Offset | Address | Purpose |
|---|---|---|
| .0 | 127.0.11.0 | Network address (reserved) |
| .1 | 127.0.11.1 | Gateway (reserved) |
| .2–.62 | 127.0.11.2 – 127.0.11.62 | Services (slot + 2) |
| .63 | 127.0.11.63 | Broadcast (reserved) |
مثال لمعرّف الشبكة 2816 (0x0B00)، العنوان الأساسي 127.0.11.0:
| الخدمة | الفتحة | عنوان IP |
|---|---|---|
| api | 0 | 127.0.11.2 |
| postgres | 1 | 127.0.11.3 |
| redis | 2 | 127.0.11.4 |
يدعم كل مستودع ما يصل إلى 61 خدمة (الفتحات من 0 إلى 60).
استخدام عناوين IP للخدمات في Docker Compose
بما أن كل مستودع يشغّل عملية Docker معزولة، يقوم renet compose تلقائياً بتهيئة network_mode: host لجميع الخدمات. يعيد النواة تلقائياً توجيه استدعاءات bind() إلى عنوان IP الحلقي المخصص للخدمة، لذا يمكن للخدمات الارتباط بـ 0.0.0.0 أو localhost دون تعارض. للاتصال بالخدمات الأخرى، استخدم اسم الخدمة. يحقن renet كل اسم خدمة كاسم مضيف يُحلَّل دائماً إلى عنوان IP الصحيح، حتى في الفروع:
services:
postgres:
image: postgres:16
environment:
PGDATA: /var/lib/postgresql/data
POSTGRES_PASSWORD: secret
# لا حاجة لـ listen_addresses صريح - تعيد النواة توجيه bind إلى عنوان IP الحلقي الصحيح
api:
image: my-api:latest
environment:
DATABASE_URL: postgresql://postgres:secret@postgres:5432/mydb # استخدام اسم الخدمة
LISTEN_ADDR: 0.0.0.0:8080 # تعيد النواة توجيهه إلى IP الخدمة
أسماء الخدمات للاتصالات: استخدم اسم الخدمة (مثل
postgres،redis) للاتصال بالخدمات الأخرى. يقوم renet تلقائياً بتعيين كل اسم خدمة إلى عنوان IP الحلقي الخاص به عبر/etc/hosts. تضمين${POSTGRES_IP}في سلاسل الاتصال المخزنة في قواعد البيانات أو ملفات الإعداد سيثبت عنوان IP الخام، مما يكسر عزل الفروع وهو خطأ تحقق. متغيرات${SERVICE_IP}لا تزال متاحة للاستخدام الصريح، لكن الارتباط يتم تلقائياً بواسطة النواة.
ملاحظة: لا تضف
network_mode: hostيدوياً، يقومrenet composeبحقنه تلقائياً. سياسات إعادة التشغيل (مثلrestart: always) آمنة للاستخدام، يزيلها renet تلقائياً لتوافق CRIU ويتولى watchdog استعادة الحاويات.
استعادة الحاويات وسياسة إعادة التشغيل
يختلف renet و Docker عن قصد في كيفية التعامل مع إعادة تشغيل الحاويات. فهم هذا التقسيم مهم عند تشخيص سبب عودة حاوية إلى العمل أو عدمها.
ترجمة سياسة إعادة التشغيل. عند كتابة restart: always (أو unless-stopped أو on-failure) في ملف compose، يقوم renet بحذفها عند تجميع نشر compose الفعلي ويستبدلها بـ restart: no. يتم حفظ القيمة الأصلية في .rediacc.json الخاص بالمستودع تحت services.<name>.restart_policy. هذا يمنع إعادة التشغيل التلقائية على مستوى Docker daemon من التدخل في عملية CRIU checkpoint/restore (فإعادة تشغيل يقودها daemon ستستأنف من حالة قديمة ما قبل نقطة التفتيش).
تطبيق الـ watchdog. يعمل watchdog الموجّه دورياً على كل جهاز. في كل دورة:
- يقرأ
.rediacc.jsonلكل مستودع ويجد الخدمات ذاتrestart_policyقابلة للاسترداد. - يسرد جميع الحاويات لـ daemon ذلك المستودع، ويحدد الموقوفة منها، ويعيد تشغيلها وفقاً للسياسة المحفوظة. فترة سماح مدتها 30 ثانية تمنع التعارض مع مشغّل نفّذ
docker stopللتو. - تعالج نفس الحلقة أيضاً
/var/run/rediacc/cold-backup-<guid>.running.json(راجع دلالات النسخ الاحتياطية الباردة). تُعاد تشغيل الحاويات المدرجة بغض النظر عن السياسة المحفوظة، لأن الـ sidecar يعني “أوقف renet هذه الحاويات عن قصد وعليه إعادة تشغيلها للمشغّل.”
لماذا قد تبدو on-failure معطوبة. سياسة Docker on-failure تُعيد التشغيل فقط عند خروج الحاوية بكود غير صفري. الإيقاف الطبيعي (الخروج 0) من docker stop أو إيقاف daemon ليس “فشلاً” ولا يُشغّل إعادة تشغيل، لا بالمنطق الأصلي لـ Docker ولا بمسار السياسة المحفوظة لـ watchdog. sidecar النسخ الاحتياطية الباردة هو شبكة الأمان: أي حاوية أوقفناها عن قصد تُعاد تشغيلها بغض النظر عن سياستها.
كيفية تفسير حالة وقت التشغيل:
docker inspect <container>←RestartPolicy.Name: ستكون دائماًnoللحاويات المُدارة بـ renet. لا تعتمد على هذا للسياسة الدلالية..rediacc.jsonفي جذر تحميل المستودع ←services.<name>.restart_policy: النية الحقيقية.docker ps --format '{{.Status}}': حالة وقت التشغيل.
كيفية إصلاح الانحراف. إذا كانت السياسة المحفوظة في .rediacc.json للحاوية غير صحيحة (مثلاً لأنك عدّلت compose لكن لم تُعد إنشاء الحاوية)، أعد تشغيل rdc repo up <repo>. ستُعاد إنشاء الحاوية مع تسجيل السياسة المحدّثة.
تجريبي: وصل استرداد sidecar النسخ الاحتياطية الباردة وعلامة
--sync-certsفيrdc machine statusفي renet 0.9+. الإصدارات الأقدم تعتمد كلياً علىrestart_policyالمحفوظة لاسترداد watchdog، مما قد يترك حاوياتon-failureعالقة بعد نسخة احتياطية باردة.
شبكات Docker bridge معطّلة لعمليات daemon الخاصة بكل مستودع. يتم تكوين كل daemon خاص بمستودع (
FlavorRediacc) بالقيم"bridge": "none"و"iptables": false. سيظل أمرdocker run <image>البسيط داخل شل المستودع يبدأ، لكن الحاوية ستحصل فقط على واجهة loopback وبدون DNS أو اتصال خارجي. هذا بالتصميم، لأن عزل الـ loopback بين المستودعات تفرضه خطاطيف cgroup الخاصة بـ eBPF، وهي خطاطيف تتجاوزها الحاويات التي تعمل عبر bridge. يجب أن تستخدم خدمات الإنتاجrenet compose(الذي يحقن شبكة المضيف تلقائياً)؛ وللتصحيح العابر، مرّر--network hostبشكل صريح:docker run --rm --network host -it ubuntu bash.عمليات Hub daemon الخاصة بكل مستخدم (
FlavorHub، المستخدمة في بيئات التطوير) هي الاستثناء: فهي تضبطbridge="docker0"وiptables=trueوlive-restore=trueلكي تحصل الحاويات التي يشغّلها المستخدم على شبكة bridge عادية واتصال خارجي.
ملاحظة: مستودعات fork تحصل على مسارات تلقائية تحت نطاق فرعي الأصل:
{service}-fork-{tag}.{repo}.{machine}.{baseDomain}. يتم تخطي النطاقات المخصصة لمستودعات fork.
تشغيل الخدمات
حمّل المستودع وشغّل جميع الخدمات:
rdc repo up my-app
| الخيار | الوصف |
|---|---|
--no-wait | العودة فور بدء تشغيل الحاويات؛ تستمر فحوصات الصحة في الخلفية |
--skip-router-restart | تخطي إعادة تشغيل خادم المسارات بعد العملية |
تسلسل التنفيذ هو:
- تحميل المستودع المشفر بـ LUKS (تحميل تلقائي إذا لم يكن محمّلاً)
- بدء عملية Docker المعزولة
- إنشاء
.rediacc.jsonتلقائياً من ملفات compose - تشغيل
up()في جميع ملفات Rediaccfile (بترتيب A-Z)
بعد النشر، يُظهر الإخراج قسم PROXY ROUTES مع عناوين URL الفعلية لكل خدمة. الخدمات ذات تسميات Traefik المخصصة (مثل traefik.http.routers.myapp.rule=Host(...)) تُظهر نطاقاتها المخصصة كعناوين URL رئيسية:
HTTP services (accessible via proxy after ~3s):
gitlab-server:
HTTPS: https://gitlab.example.com (custom)
Auto: https://gitlab-server.gitlab.server-1.example.com
IP: 127.0.11.130
الخدمات بدون تسميات Traefik المخصصة تُظهر فقط المسار المُنتج تلقائياً. استخدم هذه العناوين (وليس النمط العام المطبوع بواسطة CLI) لولوج المتصفح وندءات API والإعدادات بين الخدمات.
التشغيل المنفصل
مع --no-wait، يعود الأمر فور انطلاق الحاويات دون انتظار اكتمال فحوصات الجاهزية. يُنهي التشغيل عمله في الخلفية: يواصل الوكيل إعادة المحاولة حتى ترتبط كل خدمة بمنفذها، فتستعيد المسارات عملها تلقائياً. تابع التقدم بـ rdc machine status <machine> --containers. مثالي للنسخ المؤقتة والحلقات البرمجية التي لا تحتاج إلى جاهزية الخدمات قبل الخطوة التالية.
اختبار الجاهزية
بعد up()، يفحص renet كل خدمة HTTP ويتحقق من قبولها اتصالات TCP قبل إعلانها جاهزة، حتى لا يصطدم أول طلب من المتصفح بخطأ 502 من الوكيل. تُعامَل الحاويات التي تُعرّف فحص صحة Docker معاملةً مميزة: الحاوية السليمة تتجاوز الفحص مباشرةً، وتلك التي لا تزال ضمن start_period تُسجَّل كملاحظة إعلامية لا تحذيراً. يتخلى renet عن الانتظار بعد 15 ثانية (عدّلها بمتغير البيئة REDIACC_READINESS_TIMEOUT، بالثواني، على الجهاز)؛ ويتجاوز التشغيل المنفصل هذا الفحص كلياً.
إيقاف الخدمات
rdc repo down my-app
| الخيار | الوصف |
|---|---|
--unmount | إلغاء تحميل المستودع المشفر بعد إيقاف الخدمات. |
--skip-router-restart | تخطي إعادة تشغيل خادم المسارات بعد العملية |
تسلسل التنفيذ هو:
- تشغيل
down()في جميع ملفات Rediaccfile (بترتيب Z-A عكسي، أفضل جهد) - إيقاف عملية Docker المعزولة (إذا تم تحديد
--unmount) - إلغاء تحميل وإغلاق وحدة LUKS المشفرة (إذا تم تحديد
--unmount)
العمليات المجمّعة
شغّل أو أوقف جميع المستودعات على جهاز دفعة واحدة:
rdc repo up --all -m server-1
| الخيار | الوصف |
|---|---|
--include-forks | تضمين المستودعات المنسوخة |
--no-start | التثبيت والتحضير فقط، دون تشغيل خطوات up() الخاصة بالمستودع |
--dry-run | عرض ما سيتم تنفيذه |
--parallel | تشغيل العمليات بالتوازي |
--concurrency <n> | الحد الأقصى للعمليات المتزامنة (الافتراضي: 3) |
--skip-router-restart | تخطي إعادة تشغيل خادم المسارات بعد العملية |
التشغيل التلقائي عند الإقلاع
افتراضياً، يجب تحميل المستودعات وتشغيلها يدوياً بعد إعادة تشغيل الخادم. يقوم التشغيل التلقائي بتهيئة المستودعات للتحميل تلقائياً وبدء Docker وتنفيذ up() في Rediaccfile عند إقلاع الخادم.
كيف يعمل
عند تفعيل التشغيل التلقائي لمستودع:
- يتم إنشاء ملف مفتاح LUKS عشوائي بحجم 256 بايت وإضافته إلى فتحة LUKS رقم 1 للمستودع (تبقى الفتحة 0 لعبارة مرور المستخدم)
- يُخزّن ملف المفتاح في
{datastore}/.credentials/keys/{guid}.keyبصلاحيات0600(الجذر فقط) - يتم تثبيت خدمة systemd (
rediacc-autostart) تعمل عند الإقلاع لتحميل جميع المستودعات المفعّلة وتشغيل خدماتها
عند إيقاف النظام، تقوم الخدمة بإيقاف جميع الخدمات بسلاسة (Rediaccfile down()) وإيقاف عمليات Docker وإغلاق وحدات LUKS.
ملاحظة أمنية: تفعيل التشغيل التلقائي يخزّن ملف مفتاح LUKS على قرص الخادم. يمكن لأي شخص لديه صلاحيات الجذر على الخادم تحميل المستودع بدون عبارة المرور. قيّم هذا بناءً على نموذج التهديد الخاص بك.
تفعيل
rdc repo admin autostart enable my-app
سيُطلب منك إدخال عبارة مرور المستودع.
تفعيل الكل
rdc repo admin autostart enable
تعطيل
rdc repo admin autostart disable my-app
يزيل هذا ملف المفتاح ويحذف فتحة LUKS رقم 1.
تحديث ملف المفتاح عند النشر
عند تفعيل التشغيل التلقائي، يتحقق rdc repo up من ملف مفتاح LUKS في الفتحة رقم 1.
إذا كان ملف المفتاح على القرص لا يزال مطابقاً لفتحة LUKS، لا يتم إجراء أي تغييرات.
بعد نقل مستودع بين الأجهزة عبر repo push / repo pull،
ملف المفتاح على الجهاز الجديد لن يتطابق. في هذه الحالة، يُعيد repo up تلقائياً
إنشاء ملف المفتاح وتحديث فتحة LUKS رقم 1. ستظهر رسائل السجل:
Refreshing keyfile credential for <guid>
Killing LUKS slot 1: /mnt/rediacc/repositories/<guid>
Adding keyfile to LUKS slot 1: /mnt/rediacc/repositories/<guid>
هذا آمن، الفتحة 0 (عبارة مرورك) لا تُعدَّل أبداً. إذا لم يكن التشغيل التلقائي مفعّلاً، يتم تخطي الفحص بصمت. الأخطاء غير حرجة ولا تعيق النشر.
عرض الحالة
rdc repo admin autostart list -m server-1
لتفاصيل حول كيفية استرداد المُوفِّق الدوري للمستودعات التي تتوقف بعد الإقلاع، راجع التشغيل التلقائي والاسترداد.
مثال كامل
ينشر هذا تطبيق ويب مع PostgreSQL و Redis وخادم API.
1. الإعداد
curl -fsSL https://www.rediacc.com/install.sh | bash
rdc config init production --ssh-key ~/.ssh/id_ed25519
rdc machine add prod-1 --ip 203.0.113.50 --user deploy
rdc machine setup prod-1
rdc repo create webapp -m prod-1 --size 10G
2. التحميل والتحضير
rdc repo up webapp --no-start
3. إنشاء ملفات التطبيق
داخل المستودع، أنشئ الملفات التالية:
docker-compose.yml:
services:
postgres:
image: postgres:16
volumes:
- ./data/postgres:/var/lib/postgresql/data
environment:
POSTGRES_DB: webapp
POSTGRES_USER: app
POSTGRES_PASSWORD: changeme
redis:
image: redis:7-alpine
api:
image: myregistry/api:latest
environment:
DATABASE_URL: postgresql://app:changeme@postgres:5432/webapp
REDIS_URL: redis://redis:6379
LISTEN_ADDR: 0.0.0.0:8080
Rediaccfile:
#!/bin/bash
up() {
mkdir -p data/postgres
renet compose -- up -d
echo "Waiting for PostgreSQL..."
for i in $(seq 1 30); do
if renet compose -- exec postgres pg_isready -q 2>/dev/null; then
echo "PostgreSQL is ready."
return 0
fi
sleep 1
done
echo "Warning: PostgreSQL did not become ready within 30 seconds."
}
down() {
renet compose -- down
}
4. التشغيل
rdc repo up webapp
5. تفعيل التشغيل التلقائي
rdc repo admin autostart enable webapp
استخدام أسرار المستودع في compose
العنصر النائب POSTGRES_PASSWORD: changeme أعلاه بخير للبرنامج التعليمي، لكن التطبيقات الحقيقية تحتاج بيانات اعتماد حقيقية، والتزام تخزينها في ملف compose (أو ملف .env داخل المستودع) يعني أن fork يرثها أيضاً. للبيانات الاعتمادية على النشر، استخدم rdc repo secret. تعيش القيم خارج صورة المستودع المشفرة، لذا تبدأ forks بخريطة أسرار فارغة.
يعمل نمطا تسليم في compose:
نمط env. قم بالاستيفاء عبر ${REDIACC_SECRET_<KEY>} في أي قيمة environment:. يمرر غلاف renet القيمة إلى بيئة الحاوية عند النشر.
نمط file. تنزل القيمة إلى ملف tmpfs على جانب المضيف في /var/run/rediacc/net-<networkID>/secrets/<KEY>، وتحمّله في الحاوية عبر كتلة secrets: القياسية لـ Docker compose. تقرأ الحاوية /run/secrets/<key>. فضّل هذا النمط لأي شيء حساس. القيم لا تظهر أبداً في docker inspect أو /proc/<pid>/environ.
services:
api:
image: myregistry/api:latest
environment:
DATABASE_URL: ${REDIACC_SECRET_DATABASE_URL}
secrets:
- stripe_live_key
secrets:
stripe_live_key:
file: /var/run/rediacc/net-${REDIACC_NETWORK_ID}/secrets/STRIPE_LIVE_KEY
ازرع القيم باستخدام rdc repo secret set <repo> --key DATABASE_URL --value <val> --mode env --current "" والمعادل لنمط الملف. راجع المستودعات § الأسرار للحصول على طريقة شاملة و أسرار المستودع في ورقة الغش للحصول على مرجع الأمر.
يتم رفض مسارات متعددة المستودعات في وقت التحقق. تصريح compose
secrets: file:(أوconfigs: file:أوenv_file:) يشير إلى دليل/var/run/rediacc/net-<other-networkID>/secrets/لمستودع آخر يتم رفضه بشدة بواسطة غلاف renet قبل تشغيل docker compose.--unsafeلا تعكس. دفاع متعدد الطبقات: sandbox الـ Landlock حول شل Rediaccfile ينطاق القراءات إلى دليل الأسرار لشبكة حالية، لذاcat /var/run/rediacc/net-<other>/secrets/Xمن bash Rediaccfile يفشل مع EACCES حتى إذا تجاوز مدقق YAML. لا تحتاج إلى الانضمام؛ هذا بالفعل مفعّل بشكل افتراضي لكلrepo up.