مرجع سطر أوامر Rediacc

نظرة عامة

**Rediacc CLI** (`rdc`) هي واجهة سطر أوامر لإدارة البنية التحتية ذاتية الاستضافة: الأجهزة، والمستودعات، والتخزين، والنسخ الاحتياطية، والمزيد.

التثبيت

قم بتنزيل أحدث ملف تنفيذي لمنصتك من [صفحة إصدارات Rediacc](https://www.rediacc.com) أو قم بالتثبيت عبر مدير الحزم الخاص بك:

# macOS / Linux
curl -fsSL https://www.rediacc.com | sh

# Or use the packaged binary directly
./rdc --help

الخيارات العامة

يدعم كل أمر هذه العلامات العامة:

العلامة	الوصف
`--output`	صيغة المخرجات (table\|json\|yaml\|csv). Override default with REDIACC_DEFAULT_OUTPUT.
`--config`	استخدام إعدادات محددة لهذا الأمر
`--lang`	تجاوز اللغة ({{languages}})
`--force`	تخطي نوافذ التأكيد

1. إدارة الإعدادات

إدارة ملفات التكوين: الإنشاء، والتبديل، والتحرير، وتسوية الحالة، والمرافق الشاملة (الحقول، التدقيق، مفاتيح SSH، المزامنة البعيدة).

تخزن ملفات الإعدادات تفاصيل الاتصال (عنوان URL للـ API، بيانات الاعتماد، الفريق/المنطقة/الجسر الافتراضي) حتى تتمكن من التبديل بين البيئات بسرعة.

1.1 prune

إزالة الأوزان الميتة من ملف التكوين المحلي في ~/.config/rediacc/<config>.json. يتم تنظيف ثلاث مجموعات، جميعها محلية بحتة (بدون مكالمات SSH/renet): (1) إدخالات ذاكرة التخزين المؤقت لشهادات ACME التي لم يعد المرسى GUID/repo/machine الخاص بها موجوداً في التكوين النشط؛ (2) المستودعات المؤرشفة التي انتهت فترة سماحها (افتراضياً 7 أيام، انظر defaults.pruneGraceDays)؛ (3) المراجع المتقاطعة المعلقة (machine→strategy، strategy→repo). الموارد المستخدمة وبيانات الاعتماد ورموز التخزين والمضيفات المعروفة لا تُلمس أبداً. السلوك الافتراضي هو تطبيق التغييرات؛ مرر --dry-run للمعاينة فقط.

rdc config prune [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	معاينة ما سيتم إزالته دون تعديل ملف التكوين. يعكس دلالات الإيقاف الافتراضية لأوامر التنظيف الأخرى.	لا	-
`--certs-only`	تقييد ذاكرة التخزين المؤقت لشهادات ACME. يتخطى تطهير الأرشيف وتنظيف المراجع المتقاطعة. حصري بشكل متبادل مع --archives-only و --refs-only.	لا	-
`--archives-only`	تقييد لتطهير الأرشيف المنتهي. يتخطى ذاكرة التخزين المؤقت للشهادات وتنظيف المراجع المتقاطعة. حصري مع --certs-only و --refs-only.	لا	-
`--refs-only`	تقييد للمراجع المتقاطعة المعلقة (machine→strategy، استثناءات/تضمينات strategy→repo). يتخطى ذاكرة التخزين المؤقت للشهادات والأرشيف. حصري مع --certs-only و --archives-only.	لا	-
`--purge-archived`	إسقاط جميع المستودعات المؤرشفة بغض النظر عن العمر، ليس فقط تلك التي تجاوزت فترة السماح. مكافئ لتشغيل 'rdc repo admin archive purge' لكل مستودع مؤرشف. استخدم فقط عندما تكون متأكدًا من أنك لا تحتاج إلى أي من بيانات الاعتماد المخزَّنة للاستعادة.	لا	-
`--orphan-repos`	يزيل إدخالات المستودعات غير المرتبطة بأي جهاز. يحتوي كل إدخال على بيانات الاعتماد ومفتاح SSH الخاص بذلك المستودع، لذا فإن هذا الإجراء لا رجعة فيه. شغّل أولًا 'rdc config reconcile' حتى يعكس التوزيع الأجهزة الفعلية.	لا	-
`--gone-machine-repos`	أرشفة إدخالات المستودعات الموضوعة على جهاز لم يعد في الإعداد. تُؤرشف ولا تُحذف: يحتفظ كل منها ببيانات اعتماده ويبقى قابلًا للاستعادة حتى تنتهي مهلة الأرشيف. يحدد هذه الفئة فقط: تُتخطى فئات ذاكرة الشهادات المؤقتة والأرشيفات والمراجع المتقاطعة ما لم يُمرَّر أيضاً خيارها --*-only الخاص بها.	لا	-
`--grace-days <days>`	تجاوز نافذة سماح الأرشيف (بالأيام) لهذا الاستدعاء. يعود إلى defaults.pruneGraceDays في التكوين، ثم إلى 7 إذا لم يتم تعيين أي منهما.	لا	-

1.2 init

إنشاء ملف إعدادات مسمى جديد

في الوضع المحلي يمكنك إضافة الآلات مباشرة:

rdc config init [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`--ssh-key <path>`	المسار إلى مفتاح SSH الخاص (مثال: ~/.ssh/id_rsa)	لا	-
`--renet-path <path>`	المسار إلى ثنائي renet (افتراضي: renet في PATH)	لا	-
`--master-password <password>`	تشفير الموارد بكلمة مرور رئيسية	لا	-
`--server <url>`	عنوان خادم الحساب	لا	-

1.3 list

عرض جميع ملفات الإعدادات

rdc config list

مرجع CLI: rdc config list

1.4 show

عرض تفاصيل الإعدادات الحالية

rdc config show [options]

العلامة	الوصف	مطلوب	افتراضي
`--reveal`	عرض النص الصريح للقيم الحساسة (الوضع التفاعلي فقط)	لا	-

1.5 current

عرض الإعدادات النشطة: الاسم، الملف، الخادم والقناة بعد الحل، حالة الرمز

rdc config current

مرجع CLI: rdc config current

1.6 delete

حذف ملف إعدادات

rdc config delete <name>

مرجع CLI: rdc config delete

1.7 set

تعيين قيمة افتراضية (فريق، منطقة، جسر)

rdc config set <key> <value>

مرجع CLI: rdc config set

1.8 clear

مسح القيم الافتراضية (الكل أو مفتاح معين)

rdc config clear [key]

مرجع CLI: rdc config clear

1.9 recover

استعادة الإعدادات من ملف النسخة الاحتياطية (.bak)

rdc config recover [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-y, --yes`	تخطي نافذة التأكيد	لا	-

1.10 ssh

إدارة إعدادات مفتاح SSH

set

تعيين مفتاح SSH للإعدادات الحالية

rdc config ssh set [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <path>`	مسار ملف مفتاح SSH الخاص	نعم	-
`--embed`	تضمين محتوى المفتاح في الإعدادات بدلاً من تخزين المسار	لا	-

show

عرض إعدادات مفتاح SSH الحالية

rdc config ssh show

مرجع CLI: rdc config ssh show

remove

إزالة مفتاح SSH من الإعدادات الحالية

rdc config ssh remove

مرجع CLI: rdc config ssh remove

1.11 remote

إدارة اتصال تخزين الإعدادات عن بُعد

enable

ربط هذه الإعدادات بالتخزين المشفر عن بُعد

rdc config remote enable [options]

العلامة	الوصف	مطلوب	افتراضي
`--master-password`	التسجيل بلا واجهة رسومية باستخدام فتحة كلمة مرور مُجهَّزة مسبقًا (بلا متصفح)	لا	-
`--master-password-stdin`	مثل --master-password، مع قراءة كلمة المرور الرئيسية من stdin	لا	-
`--api-url <url>`	عنوان خادم الحساب	لا	-
`--force`	استبدال المحتوى المحلي المختلف بنسخة الخادم دون تأكيد	لا	-
`--config-id <id>`	أرفِق بهذه الإعدادات الموجودة في المخزن بدلاً من إنشاء إدخال جديد	لا	-

disable

قطع الاتصال بالتخزين عن بُعد وحفظ الإعدادات محلياً

rdc config remote disable [options]

العلامة	الوصف	مطلوب	افتراضي
`--local`	فكّ الارتباط على هذا الجهاز فقط، من النسخة المخزنة مؤقتاً، دون الاتصال بالخادم	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-

status

عرض حالة الاتصال عن بُعد

rdc config remote status

مرجع CLI: rdc config remote status

master-password

إدارة كلمة المرور الرئيسية لهذا العضو (فتحة كلمة المرور)

change:

تغيير كلمة المرور الرئيسية: إعادة تغليف مفتاح الإعدادات من تسجيل هذا الجهاز ضمن فتحة كلمة مرور جديدة

rdc config remote master-password change [options]

العلامة	الوصف	مطلوب	افتراضي
`--new-master-password-stdin`	اقرأ كلمة المرور الرئيسية الجديدة من stdin (وإلا فمن REDIACC_NEW_STORE_MASTER_PASSWORD، أو عبر مطالبة في TTY)	لا	-

refresh

إعادة جلب الإعدادات من التخزين عن بُعد

rdc config remote refresh

مرجع CLI: rdc config remote refresh

versions

عرض الإصدارات السابقة من هذه الإعدادات المحفوظة على الخادم

rdc config remote versions [options]

العلامة	الوصف	مطلوب	افتراضي
`--explain`	عرض مؤشرات JSON التي غيّرها كل إصدار، من الإصدارات التي احتفظ بها الخادم	لا	-

restore

نشر إصدار سابق من هذه الإعدادات بوصفه أحدث إصدار لها

rdc config remote restore <version> [options]

العلامة	الوصف	مطلوب	افتراضي
`-y, --yes`	تخطي نافذة التأكيد	لا	-

1.12 field

عمليات حقول التكوين المعنونة بالمؤشرات (get/set/unset/rotate/list). مؤشرات JSON (RFC 6901) مثل /credentials/cfDnsApiToken.

get

قراءة قيمة تكوين واحدة بواسطة مؤشر JSON. تُخفى الحقول الحساسة إلا باستخدام --reveal (للمستخدمين البشريين فقط).

rdc config field get [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل (مثال: /credentials/cfDnsApiToken)	نعم	-
`--reveal`	إظهار النص الصريح للقيم الحساسة (طرفية تفاعلية فقط؛ يُسجَّل في التدقيق)	لا	-
`--digest`	طباعة تلخيص SHA-256 بدلاً من القيمة (آمن للمشاركة مع العملاء الذكيين)	لا	-

set

كتابة قيمة تكوين عند مؤشر JSON. المسارات الحساسة تتطلب --current (بوابة المعرفة).

rdc config field set [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل (مثال: /credentials/cfDnsApiToken)	نعم	-
`--new <value>`	القيمة الجديدة (تُفسَّر كـ JSON إذا بدأت بـ { [ " أو true/false/null/رقم)	نعم	-
`--current <value>`	القيمة الصريحة الحالية - مطلوبة لتعديل المسارات الحساسة (إثبات بوابة المعرفة)	لا	-

unset

حذف قيمة تكوين عند مؤشر JSON. المسارات الحساسة تتطلب --current.

rdc config field unset [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل (مثال: /credentials/cfDnsApiToken)	نعم	-
`--current <value>`	القيمة الصريحة الحالية - مطلوبة لحذف المسارات الحساسة	لا	-

rotate

تدوير قيمة حساسة دون --current. طرفية تفاعلية فقط؛ يُسجَّل بشكل بارز.

rdc config field rotate [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل الحساس (مثال: /credentials/cfDnsApiToken)	نعم	-
`--new <value>`	قيمة جديدة	نعم	-

list

سرد كل قالب مؤشر مسجّل مع نوعه وسياسة الالتزام/التشفير.

rdc config field list [options]

العلامة	الوصف	مطلوب	افتراضي
`--sensitive`	عرض القوالب الحساسة فقط (غير العامة)	لا	-

1.13 edit

فتح التكوين الحالي في $EDITOR كإسقاط JSONC مُخفى. للمستخدمين البشريين فقط؛ يُرفض العملاء.

rdc config edit [options]

العلامة	الوصف	مطلوب	افتراضي
`--reveal`	إظهار النص الصريح للقيم الحساسة (طرفية تفاعلية فقط؛ يُسجَّل في التدقيق)	لا	-
`--dump`	طباعة التكوين الحالي كـ JSONC إلى stdout بدلاً من فتح المحرر (للقراءة فقط؛ آمن للعملاء عند الإخفاء)	لا	-
`--apply <file>`	تطبيق ملف JSONC معدّل (يتخطى إطلاق $EDITOR)	لا	-
`--current-secrets <file>`	ملف JSON يربط المؤشر → النص الصريح القديم لبوابة المعرفة عند --apply	لا	-
`--editor <cmd>`	أمر المحرر البديل (يتبع تسلسل git: --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR)	لا	-

1.14 audit

فحص سجل تدقيق التكوين (JSONL متسلسل التجزئة في ~/.config/rediacc/audit.log.jsonl)

log

طباعة أحدث إدخالات التدقيق بصيغة JSON

rdc config audit log [options]

العلامة	الوصف	مطلوب	افتراضي
`--since <spec>`	إظهار الإدخالات الأحدث من (مثال: '24h', '7d', طابع زمني ISO)	لا	-
`--path <glob>`	تصفية حسب نمط مؤشر JSON (مثال: /credentials/*)	لا	-
`--actor <kind>`	تصفية حسب نوع الفاعل (human\|agent)	لا	-

tail

بث الإدخالات الجديدة أثناء كتابتها (Ctrl+C للإيقاف)

rdc config audit tail

مرجع CLI: rdc config audit tail

verify

التحقق من سلامة سلسلة تجزئة SHA-256 عبر جميع إدخالات التدقيق

rdc config audit verify

مرجع CLI: rdc config audit verify

1.15 reconcile

إعادة بناء حالة وقت التشغيل من واقع الأجهزة. يُصلح بيانات الإرفاق والتوجيه القديمة.

rdc config reconcile [options]

العلامة	الوصف	مطلوب	افتراضي
`--machine <m...>`	تقييد التسوية بهذه الأجهزة	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-
`--accept-observed`	إعادة كتابة الموضع المُعلن ليطابق مكان الصورة الفعلي، ولكن فقط عندما يكون ذلك لا لبس فيه (مُلاحظ على جهاز واحد بالضبط). التكرارات تبقى تعارضات.	لا	-

1.16 rotate-cek

تدوير مفتاح تشفير تكوين المؤسسة

rdc config rotate-cek [options]

العلامة	الوصف	مطلوب	افتراضي
`--api-url <url>`	عنوان خادم الحساب	لا	-

1.17 access

إدارة مفاتيح الوصول في التكوين: مفاتيح SSH العامة التي تكتبها CLI في authorized_keys الخاص بالجهاز مع قيد from= على نطاقات IPv4 و IPv6 المعلنة. اربط المفتاح بجهاز باستخدام 'machine access set' ثم طبّقه باستخدام 'machine access push'

add

إضافة مفتاح وصول، أو تحديث مفتاح موجود في مكانه مع الإبقاء على ارتباطاته بالأجهزة. تسري النطاقات المحددة هنا على المفتاح في كل جهاز ما لم يحدد الارتباط نطاقاته الخاصة؛ وبدون نطاقات تسري نطاقات التكوين العامة

rdc config access add <key> [options]

العلامة	الوصف	مطلوب	افتراضي
`--public-key <key>`	سطر مفتاح OpenSSH العام، أو مسار ملف يحتويه	نعم	-
`--hosted-executor`	إضافة نطاقات الصادر المرصودة للمنفّذ المستضاف (104.28.0.0/16 و 2a09:bac0::/29)	لا	-
`--ipv4 <cidrs>`	نطاقات IPv4 بصيغة CIDR (مفصولة بفواصل، مثل 203.0.113.0/24)	لا	-
`--ipv6 <cidrs>`	نطاقات IPv6 بصيغة CIDR (مفصولة بفواصل، مثل 2001:db8::/32)	لا	-
`--no-restrict`	كتابة from= وحده، دون قيود no-forwarding و no-pty و no-user-rc	لا	-

remove

إزالة مفتاح وصول من التكوين

rdc config access remove <key>

مرجع CLI: rdc config access remove

ranges

تعيين نطاقات المصدر التي يستخدمها كل مفتاح وصول ما لم يحدد المفتاح أو ارتباطه بالجهاز نطاقاته الخاصة. بدون خيارات تُعرض النطاقات الحالية

rdc config access ranges [options]

العلامة	الوصف	مطلوب	افتراضي
`--hosted-executor`	إضافة نطاقات الصادر المرصودة للمنفّذ المستضاف (104.28.0.0/16 و 2a09:bac0::/29)	لا	-
`--ipv4 <cidrs>`	نطاقات IPv4 بصيغة CIDR (مفصولة بفواصل، مثل 203.0.113.0/24)	لا	-
`--ipv6 <cidrs>`	نطاقات IPv6 بصيغة CIDR (مفصولة بفواصل، مثل 2001:db8::/32)	لا	-
`--clear`	إزالة النطاقات العامة للتكوين	لا	-

list

عرض مفاتيح الوصول في التكوين

rdc config access list

مرجع CLI: rdc config access list

2. إدارة مخزن البيانات

تجمّعات تخزين مسماة تحمل المستودعات. مخزن البيانات متنقّل (أرفقه بجهاز، انقله إلى آخر) وأحادي الحامل (جهاز واحد بالضبط يحمله في كل مرة). مخزن البيانات الافتراضي الضمني على كل جهاز لا يُدار هنا.

2.1 resize

توسيع أو تقليص مخزن بيانات. هذه عملية غير متصلة: يجب إيقاف المستودعات بداخله.

rdc datastore resize <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`--size <size>`	الحجم الجديد (مثلاً 200G)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.2 fork

تفريع مخزن بيانات بنسخ-عند-الكتابة. التفريع فوري وتكلفته لا تنمو مع حجم التجمّع. يحتاج خلفية rbd: مخزن البيانات local ليس له نسخ على مستوى الكتل، لذا تُفرَّع المستودعات بداخله واحدًا تلو الآخر عبر reflink بدلاً من ذلك (rdc repo fork).

rdc datastore fork <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`--tag <tag>`	وسم النسخة المتفرعة (تكون النتيجة name:tag)	نعم	-
`--attach-to <machine>`	إرفاق النسخة المتفرعة بهذا الجهاز فورًا (يتطلب --writes)	لا	-
`--writes <disposition>`	وجهة كتابات النسخة المتفرعة: local (فوري، مؤقت) أو ceph (نسخة دائمة)	لا	-
`--cow-size <size>`	حجم الطبقة التراكبية لـ --writes local	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.3 status

عرض مخزن بيانات واحد: خلفيته، وإرفاقه، واستخدامه، ومستودعاته، ولقطاته. مخزن البيانات غير المرفق لا يزال يُبلِّغ عن سجله.

rdc datastore status <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.4 create

إنشاء مخزن بيانات إضافي مسمى على جهاز. الخلفية local هي تجمّع مدعوم بملف على ذلك الجهاز ويبقى هناك. الخلفية rbd تعيش في Ceph، لذا يمكنها الانتقال إلى أي جهاز يصل إلى نفس العنقود. مرّر --cluster لجعله مخزن بيانات من عالم Kubernetes؛ هذا المرجع الخلفي ثابت عند الإنشاء.

rdc datastore create <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	الجهاز المُراد إنشاء مخزن البيانات عليه	نعم	-
`--size <size>`	حجم مخزن البيانات (مثلاً 100G)	نعم	-
`--backend <type>`	خلفية التخزين: local (مدعومة بملف، تبقى على هذا الجهاز) أو rbd (Ceph، قابلة للنقل)	لا	`local`
`--pool <name>`	تجمّع Ceph لخلفية rbd (الافتراضي: rbd)	لا	-
`--image <name>`	اسم صورة RBD لخلفية rbd (الافتراضي: اسم مخزن البيانات)	لا	-
`--cluster <name>`	عنقود Kubernetes الذي ينتمي إليه مخزن البيانات هذا. تعيينه يعني مستودعات Kubernetes فقط؛ عدم تعيينه يعني مستودعات Docker فقط. يُحدَّد بشكل ثابت عند الإنشاء.	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.5 list

عرض مخازن البيانات المسماة، وأماكن إرفاقها، وما تحتويه.

rdc datastore list [place]

مرجع CLI: rdc datastore list

2.6 attach

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

rdc datastore attach <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`--to <machine>`	الجهاز المُراد إرفاق مخزن البيانات به	نعم	-
`--writes <disposition>`	وجهة كتابات النسخة المتفرعة: local (فوري، مؤقت، يُفقد عند الفصل) أو ceph (نسخة دائمة في التجمّع). مطلوب للنسخة المتفرعة.	لا	-
`--cow-size <size>`	حجم الطبقة التراكبية لـ --writes local	لا	-
`--no-auto`	عدم إعادة إرفاق مخزن البيانات هذا تلقائيًا عند الإقلاع	لا	-
`--force`	تسييج (fence) حامل قديم لم يتخلَّ عن مخزن البيانات بشكل نظيف	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.7 detach

فصل مخزن بيانات عن جهازه. تتوقف المستودعات بداخله أولاً. النسخة المتفرعة المرفقة بـ --writes local ليس لديها مكان تكتب طبقتها التراكبية إليه، لذا فصلها يتخلّى عن الطبقة التراكبية ويتطلب --discard.

rdc datastore detach <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`--discard`	التخلي عن نسخة متفرعة بكتابات محلية وطبقتها التراكبية. البيانات غير قابلة للاسترجاع.	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.8 snapshot

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

create

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

rdc datastore snapshot create <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`--snapshot <label>`	تسمية اللقطة (الافتراضي: طابع زمني UTC)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

list

عرض لقطات مخزن البيانات.

rdc datastore snapshot list <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.9 delete

تدمير مخزن بيانات وكل ما فيه. يُفصل أولاً؛ إذا تعذّر فصله بشكل نظيف، يفشل الحذف بدلاً من ترك تجمّع مركّب يتيمًا.

rdc datastore delete <datastore> [options]

العلامة	الوصف	مطلوب	افتراضي
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`--force`	الحذف حتى لو كانت مستودعات لا تزال تشير إليه. تُحذف بياناتها معه.	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3. إدارة الأجهزة

فحص حالة الأجهزة البعيدة: موارد النظام، والحاويات قيد التشغيل، وخدمات systemd، والمستودعات المنشورة، وتشخيصات الصحة. استعلامات للقراءة فقط؛ لتعديل المستودعات استخدم `repo`. الأوامر الفرعية الرئيسية: status (الحالة الكاملة، مُضيَّقة بـ --system و--containers و--repositories و--services)، health، list، add، remove، setup، prune، provision، deprovision.

3.1 list

قائمة الآلات

rdc machine list [options]

العلامة	الوصف	مطلوب	افتراضي
`--search <text>`	البحث في {{field}}	لا	-
`--sort <field>`	الترتيب حسب الحقل	لا	-
`--desc`	الفرز بترتيب تنازلي	لا	-

3.2 health

فحص صحة الآلة لأنابيب CI/CD

يُخرج أمر health مقاييس النظام وحالة الحاويات واستقرار الخدمات ومعلومات التخزين، وهو مفيد لفحوصات خطوط أنابيب CI/CD.

rdc machine health <name>

مرجع CLI: rdc machine health

3.3 repair

يشغّل الإصلاحات الآمنة لنتائج فحص صحة الجهاز ثم يعيد الفحص (رمز الخروج 0: لم يبقَ شيء، 1: بقيت تحذيرات أو مهام للمشغّل، 2: بقي خطأ أو فشل إصلاح)

rdc machine repair <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	يسرد الإصلاحات التي ستُشغَّل دون تشغيلها	لا	-
`--code <code>`	يصلح رمز النتيجة هذا فقط (قابل للتكرار)	لا	-
`--with-backup`	يسمح بإصلاحات auto-with-backup، كلٌّ منها بعد لقطة ناجحة لمستودعه	لا	-
`--window-override`	يشغّل إصلاحات window=only خارج نافذة الصيانة	لا	-
`--set-window <window>`	يحفظ نافذة صيانة الجهاز (HH:MM-HH:MM بتوقيت UTC) أو يمسحها بـ off ثم يخرج	لا	-

3.4 provision

توفير جهاز جديد على مزود سحابي باستخدام OpenTofu

rdc machine provision <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--provider <name>`	اسم المزود السحابي (من machine provider add)	نعم	-
`--region <region>`	تجاوز المنطقة الافتراضية	لا	-
`--type <type>`	تجاوز نوع المثيل الافتراضي	لا	-
`--image <image>`	تجاوز صورة نظام التشغيل الافتراضية	لا	-
`--ssh-user <user>`	اسم مستخدم SSH للجهاز الافتراضي الجديد (الافتراضي: root)	لا	-
`--base-domain <domain>`	النطاق الأساسي للبنية التحتية (مثال: example.com). يتضمن --infra	لا	-
`--no-infra`	تخطي تكوين البنية التحتية (الوكيل + DNS)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.5 deprovision

تدمير جهاز مُوفَّر سحابياً وإزالته من الإعدادات

rdc machine deprovision <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	تخطي نافذة التأكيد	لا	-
`--archive-repos`	أرشفة إدخالات الإعداد للمستودعات الموضوعة على هذا الجهاز (تُحفظ بيانات الاعتماد وتبقى قابلة للاستعادة)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.6 prune

إزالة موارد مخزن البيانات المعزولة واللقطات القديمة من جهاز

rdc machine prune <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	عرض ما سيتم إزالته دون إجراء تغييرات	لا	-
`--orphaned-repos`	حذف كل صورة مستودع على الجهاز غير موجودة في تكوين CLI المحلي لديك. سلوك خشن: يحذف أيضًا النسخ المتفرعة التي أنشأتها أدوات أخرى ولا يوجد لها إدخال تكوين محلي، حتى عندما تحدِّدها مرآة renet بشكل صحيح كنسخ متفرعة. استخدم --prune-unknown للسلوك الأضيق الذي يحترم المرآة.	لا	-
`--prune-unknown`	حذف فقط المستودعات التي لا يستطيع مرآة renet .interim/state تصنيفها (ليست في التكوين المحلي ولا تحتوي على مرآة موسومة بالشوكة). أضيق بشكل صارم من --orphaned-repos: تتم المحافظة على الشوكات بدون تكوين عندما تحددها المرآة. المتبقيات القديمة قبل المرآة والأجداد القدامى الذين تم حذف إدخال التكوين الخاص بهم يقعون كلاهما في هذه الفئة.	لا	-
`--force-delete-mounted`	تجاوز فحص أمان التركيب وحذف المستودعات حتى لو كانت مركبة حالياً أو تحتوي على حاويات Docker قيد التشغيل. مختلف عن --force (الذي يتجاوز فترة السماح للأرشيف فقط). ينطبق على كل من --orphaned-repos و --prune-unknown.	لا	-
`--force`	تخطي نوافذ التأكيد	لا	-
`--grace-days <days>`	فترة السماح بالأيام للمستودعات المؤرشفة حديثًا (الافتراضي: 7)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.7 converge

يعيد تشغيل كل خدمة مستودع ما زالت تعمل بتخطيط قديم لبيئة التشغيل، واحدة تلو الأخرى، لتنتقل إلى التخطيط الحالي. تتولى CLI ذلك تلقائيًا بعد رفع renet، ويفيد تشغيله يدويًا في معاينة الخطة أو استئناف جولة فاشلة أو، مع --policy always، إعادة التشغيل بعد أي تغيير في ملف renet التنفيذي.

rdc machine converge <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	عرض الخطة دون إعادة تشغيل أي شيء	لا	-
`--json`	عرض تقرير المواءمة بصيغة JSON	لا	-
`--include-unknown`	إعادة تشغيل المستودعات القديمة غير الموجودة في الإعدادات المحلية أيضًا (أسرار بيئتها غير معروفة)	لا	-
`--policy <policy>`	سياسة إعادة التشغيل: epoch (عند تغيير التخطيط فقط) أو always (وعند أي تغيير في ملف renet التنفيذي أيضًا)	لا	`epoch`
`--continue-on-error`	المتابعة بعد فشل أحد المستودعات بدلًا من إيقاف الجولة	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.8 add

إضافة جهاز إلى الإعدادات الحالية

rdc machine add <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--ip <address>`	عنوان IP للآلة أو اسم المضيف	نعم	-
`--user <username>`	اسم مستخدم SSH	نعم	-
`--port <port>`	منفذ SSH	لا	`22`

3.9 infra

إدارة تكوين البنية التحتية (الوكيل، DNS، الشهادات)

cert

إدارة شهادات TLS المخزنة مؤقتاً

clear:

إزالة ذاكرة تخزين الشهادات المؤقتة

rdc machine infra cert clear

مرجع CLI: rdc machine infra cert clear

pull:

تنزيل وتخزين شهادات TLS مؤقتاً من جهاز

rdc machine infra cert pull <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--no-prune`	تخطي تنظيف شهادات معرّف الشبكة القديمة	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

push:

رفع شهادات TLS المخزنة مؤقتاً إلى جهاز

rdc machine infra cert push <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

status:

عرض مخزون الشهادات المخزنة مؤقتاً

rdc machine infra cert status

مرجع CLI: rdc machine infra cert status

push

دفع إعدادات البنية التحتية إلى الجهاز (وكيل Traefik، الموجّه، Cloudflare DNS). شغّل 'machine infra set <machine>' أولاً

rdc machine infra push <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

set

تعيين إعدادات البنية التحتية لجهاز (خاصة بالجهاز: عناوين IP، النطاق، المنافذ؛ مشتركة: بريد الشهادة، رمز Cloudflare DNS)

rdc machine infra set <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--public-ipv4 <ip>`	عنوان IPv4 العام (لكل جهاز)	لا	-
`--public-ipv6 <ip>`	عنوان IPv6 العام (لكل جهاز)	لا	-
`--base-domain <domain>`	النطاق الأساسي للتطبيقات (لكل جهاز)	لا	-
`--cert-email <email>`	البريد الإلكتروني لإشعارات شهادات TLS (مشترك بين الأجهزة)	لا	-
`--cf-dns-token <token>`	رمز Cloudflare DNS API لتحدي ACME DNS-01 (مشترك بين الأجهزة)	لا	-
`--tcp-ports <ports>`	منافذ TCP للتوجيه (مفصولة بفواصل، مثال: 25,143,465)	لا	-
`--udp-ports <ports>`	منافذ UDP للتوجيه (مفصولة بفواصل، مثال: 53)	لا	-

show

عرض تكوين البنية التحتية لجهاز

rdc machine infra show <machine>

مرجع CLI: rdc machine infra show

3.10 provider

إدارة المزودين السحابيين لتوفير الأجهزة تلقائياً

add

إضافة مزود سحابي

rdc machine provider add <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--provider <source>`	مصدر مزوّد معروف (مثال: linode/linode، hetznercloud/hcloud)	لا	-
`--source <source>`	مصدر مزوّد OpenTofu مخصص (مثال: vultr/vultr)	لا	-
`--token-env <var>`	اسم متغير البيئة الذي يحمل رمز API الخاص بالمزوّد؛ لا يُمرَّر الرمز نفسه في سطر الأوامر أبدًا	نعم	-
`--region <region>`	المنطقة الافتراضية للأجهزة الجديدة	لا	-
`--type <type>`	نوع/حجم النسخة الافتراضي	لا	-
`--image <image>`	صورة نظام التشغيل الافتراضية	لا	-
`--ssh-user <user>`	اسم مستخدم SSH للأجهزة الافتراضية الجديدة (الافتراضي: root)	لا	-
`--resource <type>`	مخصص: نوع مورد OpenTofu للأجهزة الافتراضية	لا	-
`--label-attr <attr>`	مخصص: اسم سمة تسمية الجهاز الافتراضي	لا	-
`--region-attr <attr>`	مخصص: اسم سمة المنطقة	لا	-
`--size-attr <attr>`	مخصص: اسم سمة نوع المثيل	لا	-
`--image-attr <attr>`	مخصص: اسم سمة صورة نظام التشغيل	لا	-
`--ipv4-output <attr>`	مخصص: سمة الإخراج لعنوان IPv4	لا	-
`--ipv6-output <attr>`	مخصص: سمة الإخراج لعنوان IPv6	لا	-
`--ssh-key-attr <attr>`	مخصص: اسم سمة مفاتيح SSH	لا	-
`--ssh-key-format <format>`	مخصص: تنسيق مفتاح SSH (inline_list أو resource_id)	لا	-
`--ssh-key-resource <type>`	مخصص: نوع مورد OpenTofu لمفاتيح SSH	لا	-

list

عرض قائمة المزودين السحابيين المُعدّين

rdc machine provider list

مرجع CLI: rdc machine provider list

remove

إزالة تكوين مزود سحابي

rdc machine provider remove <name>

مرجع CLI: rdc machine provider remove

3.11 remove

إزالة جهاز من التكوين الحالي

rdc machine remove <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`--force`	إزالة الجهاز حتى لو كانت مستودعات موضوعة عليه أو استراتيجيات نسخ احتياطي مرتبطة به، ما يترك تلك المراجع معلّقة.	لا	-
`--archive-repos`	أرشفة إدخالات الإعداد للمستودعات الموضوعة على هذا الجهاز (تُحفظ بيانات الاعتماد وتبقى قابلة للاستعادة)	لا	-

3.12 restart-services

يعيد تشغيل خدمات renet التي لا تزال تعمل بملف تنفيذي مستبدَل، واحدة تلو الأخرى، لتنتقل إلى الملف المثبّت، ويتحقق من أن كل وحدة تعمل بالملف الجديد قبل الانتقال إلى التالية. مع --include-docker يُعاد أيضًا تشغيل مشرف rediacc-docker-N لكل مستودع، مستودعًا تلو الآخر، مما يعيد تشغيل حاويات ذلك المستودع.

rdc machine restart-services <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--include-docker`	إعادة تشغيل مشرف rediacc-docker-N لكل مستودع أيضًا (يعيد تشغيل حاويات المستودع)	لا	-
`--repo <name>`	تقييد إعادة التشغيل بمشرف مستودع واحد (يتطلب --include-docker)	لا	-
`--json`	طباعة التقرير بتنسيق JSON	لا	-

3.13 scan-keys

فحص مفاتيح SSH للأجهزة في التكوين الحالي

rdc machine scan-keys [name]

مرجع CLI: rdc machine scan-keys

3.14 setup

تهيئة جهاز بعيد للمستودعات (تثبيت renet، إعداد Docker، مخزن بيانات BTRFS). قابل للتكرار. مطلوب بعد config machine add وقبل repo create

rdc machine setup <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--datastore-path <path>`	مسار مخزن البيانات على الجهاز البعيد	لا	`/mnt/rediacc`
`--datastore-size <size>`	حجم مخزن البيانات (مثال: 95%، 100G)	لا	`95%`
`--no-converge`	عدم إعادة تشغيل خدمات المستودعات التي ما زالت على تخطيط قديم لبيئة التشغيل (مثل REDIACC_SKIP_RUNTIME_CONVERGE=1)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.15 status

عرض حالة الجهاز الكاملة (النظام، المستودعات، الحاويات، الخدمات). للقراءة فقط: لا يحدّث renet على الجهاز أبدًا، ويعرض تحذيرًا إذا اختلف إصداره.

rdc machine status [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--system`	تضمين معلومات النظام فقط	لا	-
`--repositories`	تضمين المستودعات فقط	لا	-
`--containers`	تضمين الحاويات فقط	لا	-
`--services`	تضمين الخدمات فقط	لا	-
`--network`	تضمين واجهات الشبكة فقط	لا	-
`--block-devices`	تضمين أجهزة التخزين فقط	لا	-
`--licenses`	تضمين حالات تراخيص المستودعات	لا	-
`--storage-health`	عرض تجزئة BTRFS ووفورات reflink لكل مستودع	لا	-
`--datastores`	عرض مخازن البيانات المرفقة (التركيب، الإرفاق، الاستخدام)	لا	-
`--health-check`	وضع فحص الصحة - الخروج برمز 2 إذا وُجدت حاويات غير سليمة	لا	-
`--stability-check`	وضع فحص الاستقرار - الخروج برمز 2 إذا وُجدت خدمات فاشلة/تعيد التشغيل	لا	-
`--search <text>`	تصفية المستودعات حسب الاسم	لا	-
`--sync-certs`	اسحب أيضًا ذاكرة التخزين المؤقت لشهادات ACME من الجهاز بعد الاستعلام	لا	-
`--strict`	الخروج بقيمة غير صفرية (الكود 2) إذا تجاوزت أي حاوية عتبة انحراف الصحة	لا	-

3.16 gpu

يعرض وحدات GPU التي يستطيع الجهاز تسليمها إلى المستودعات، وأجهزة CDI التي يوفرها، والمستودع الذي يحمل كل جهاز.

list

يعرض وحدات GPU المكتشفة على الجهاز، وأسماء أجهزة CDI التي تعرّفها مواصفاته، والمستودعات الممنوح لها كل جهاز. لمنح جهاز استخدم 'rdc repo gpu grant'.

rdc machine gpu list <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.17 access

ربط مفاتيح الوصول في التكوين بجهاز وكتابتها في authorized_keys الخاص به، مع تقييد كل مفتاح بنطاقات مصدره

set

ربط مفتاح وصول بجهاز. تحل النطاقات المحددة هنا محل نطاقات المفتاح على هذا الجهاز فقط. طبّقه باستخدام 'machine access push'

rdc machine access set <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <key>`	اسم مفتاح الوصول (انظر 'config access list')	نعم	-
`--ipv4 <cidrs>`	نطاقات IPv4 بصيغة CIDR (مفصولة بفواصل، مثل 203.0.113.0/24)	لا	-
`--ipv6 <cidrs>`	نطاقات IPv6 بصيغة CIDR (مفصولة بفواصل، مثل 2001:db8::/32)	لا	-
`--clear-ranges`	تجاهل نطاقات هذا الجهاز الخاصة ليسري ما حدده المفتاح أو التكوين من نطاقات	لا	-

remove

إلغاء ربط مفتاح وصول بجهاز. سيزيل 'machine access push' التالي سطره

rdc machine access remove <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <key>`	اسم مفتاح الوصول (انظر 'config access list')	نعم	-

show

عرض مفاتيح الوصول المرتبطة بجهاز والنطاقات التي يسري كل منها هناك

rdc machine access show <machine>

مرجع CLI: rdc machine access show

push

كتابة مفاتيح الوصول المرتبطة بجهاز في authorized_keys الخاص به، مع تبنّي أي سطر موجود بالمفتاح نفسه، وإزالة أسطر هذا التكوين للمفاتيح التي لم تعد مرتبطة. يرفض أي تغيير يحجب جلسة rdc نفسها، ولا يكتب شيئًا إذا تغيّر الملف أثناء الدفع

rdc machine access push <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	عرض التغييرات دون كتابتها	لا	-

4. إدارة العناقيد

تجهيز وإدارة العناقيد: مجموعات مسمّاة من تجمعات العقد (ceph وk8s-server وk8s-agent وhyperconverged) على شبكة خاصة. تتجسد أعضاء التجمع كأجهزة، بحيث يعمل كل أمر -m عليها.

4.1 create

تصريح عنقود وتجهيزه: الأجهزة، وتجمعات Ceph، وKubernetes. مرّر --provider و--pool للتصريح في خطوة واحدة؛ التنفيذ المجرد لـ create يُجهِّز عنقودًا مُصرَّحًا به بالفعل.

rdc cluster create <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--provider <provider>`	المزود: مفتاح cloudProviders، أو 'kvm'	لا	-
`--pool <spec...>`	مواصفات التجمع name:role:count[:size] (الدور: ceph\|k8s-server\|k8s-agent\|hyperconverged)	لا	-
`--declare-only`	تسجيل العنقود في التكوين دون تجهيزه	لا	-
`--network-cidr <cidr>`	CIDR الشبكة الخاصة (مثلاً 10.0.0.0/24)	لا	-
`--network-primitive <primitive>`	أولية الشبكة (مثلاً vlan وvpc وnetwork)	لا	-
`--control-node <machine>`	جهاز عقدة تحكم صريح (الافتراضي: أول عضو k8s-server)	لا	-
`--net-name <name>`	KVM: شبكة libvirt لهذا العنقود (مثلاً renet12)	لا	-
`--net-base <prefix>`	KVM: بادئة الشبكة، الأوكتيتات الثلاثة الأولى (مثلاً 192.168.112)	لا	-
`--net-offset <n>`	KVM: الإزاحة المضافة إلى VM id عند اشتقاق العنوان	لا	-
`--control-id <n>`	KVM: VM id لعقدة التحكم والسجل (الافتراضي: 1)	لا	-
`--docker-registry <endpoint>`	KVM: نقطة نهاية سجل Docker داخل VM لهذا العنقود	لا	-
`--ssh-user <user>`	مستخدم SSH للأعضاء المجهزين	لا	-
`--base-domain <domain>`	النطاق الأساسي لـ DNS العام للعنقود (وإلا يُورَث من جهاز شقيق)	لا	-
`--control-ds-size <size>`	حجم مخزن بيانات التحكم التأسيسي (الافتراضي 10G)	لا	-
`--control-ds-backend <backend>`	خلفية مخزن بيانات التحكم المرجعي: local \| ceph (الافتراضي: ceph إذا كان العنقود يحتوي على ceph، وإلا local)	لا	-
`--control-ds-pool <pool>`	مجمع Ceph RBD لمخزن بيانات التحكم التأسيسي (خلفية ceph)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.2 status

سرد جميع العناقيد، أو تمرير اسم عنقود لعرض إعداداته الكاملة.

rdc cluster status [cluster]

مرجع CLI: rdc cluster status

4.3 scale

تغيير عدد أعضاء تجمع (إضافة/إزالة أجهزة وضم/تفريغ عقد). تجمعات k8s-agent تتوسع في مكانها؛ يتم نمو تجمع ceph عبر cephadm مباشرة.

rdc cluster scale <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--pool <pool>`	اسم التجمع	نعم	-
`--count <n>`	عدد الأعضاء المطلوب	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.4 destroy

تفكيك الأعضاء المجهزين وإزالة العنقود وأجهزته من الإعداد.

rdc cluster destroy <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	تخطي التأكيد والمتابعة رغم أخطاء التفكيك	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.5 kubeconfig

جلب kubeconfig من عقدة تحكم العنقود عبر SSH وتخزينه مؤقتاً محلياً (0600) لـ kubectl.

rdc cluster kubeconfig <cluster>

مرجع CLI: rdc cluster kubeconfig

4.6 fork

استنساخ عنقود كامل، بما في ذلك بيانات مستودعاته، إلى عنقود جديد: نسخ عند الكتابة منسّق لصور العنقود وPV، ثم إعادة كتابة هوية العقدة بحيث يقلع التفريع على عناوين جديدة. يستمر الأصل في العمل.

rdc cluster fork <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--tag <tag>`	وسم التفريع	نعم	-
`--to <dest-cluster>`	العنقود الوجهة الذي تستضيف عقده التفريع (عقدة تحكمه وعماله؛ لا يمكن لعنقود أن يتفرّع على أجهزته نفسها، لأن k3s لا يمكنهما مشاركة مساحة اسم شبكة مضيف واحدة)	نعم	-
`--writes <disposition>`	نمط الكتابة في التفريع: local (طبقة تراكبية dm-COW مؤقتة، بدون أي أثر على Ceph) \| ceph (نسخة دائمة). الافتراضي local	لا	-
`--up`	تشغيل المستودعات المُفرَّعة والتحقق من صحة العنقود بعد إقلاع التفريع	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.7 migrate

نقل عنقود كامل، بما في ذلك بيانات مستودعاته، إلى جهاز أو مركز بيانات آخر بفترة انتقال قصيرة (نسخ مسبق ساخن، ثم إيقاف وإعادة تشغيل في الوجهة).

rdc cluster migrate <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--to <dest-cluster>`	الوجهة	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.8 join

ضمّ جهاز مسجَّل موجود كعقدة عامل Kubernetes تابعة لعنقود، باستخدام نفس رمز الانضمام المُشتق من CA المستخدم عند التثبيت (anchor) وإعادة الانضمام (rejoin).

rdc cluster join <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--cluster <name>`	العنقود المطلوب ضم الجهاز إليه	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.9 evict

تفريغ العقدة، وحذف كائن Node الخاص بها، ومسح عضويتها في العنقود. يُشتق العنقود من الجهاز؛ يُرفض أي جهاز لا يزال مخزن بيانات مثبَّتًا عليه.

rdc cluster evict <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	تخطي التفريغ إذا كانت العقدة ميتة بالفعل	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.10 rehearse

التمرين على إصدار/ترقية: تفريع العنقود إلى وجهة كنسخة مؤقتة قابلة للتخلص منها (writes=local، بلا أسرار role=rehearsal)، ثم تشغيلها والتحقق من صحتها، ثم حذفها. لا يُمَس الأصل أبدًا.

rdc cluster rehearse <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--on <dest-cluster>`	العنقود الوجهة الذي يُقلَع عليه التمرين القابل للتخلص منه	نعم	-
`--tag <tag>`	وسم اختياري لتفريع التمرين (الافتراضي: بطابع زمني)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.11 snapshot

لقطات لحظية للعنقود بأكمله. لحظة واحدة متسقة عبر الانهيار (crash-consistent) عبر كل مخزن بيانات معتمد على rbd يملكه العنقود، تُؤخذ عبر لقطة المجموعة (group snapshot) في Ceph: لا يتوقف شيء ولا يلاحظ العنقود ذلك مطلقًا. مخازن البيانات بخلفية local ليس لها بدائية مجموعة على مستوى الكتل، لذا تقع خارج هذه اللحظة ويُبلَّغ عنها كذلك. اللحظة متّسقة عبر الانهيار، وليست متّسقة على مستوى التطبيق: إذا احتجت أن تكون كتابة معيّنة داخل اللقطة، زامنها أولاً.

create

أخذ لقطة لكل مخزن بيانات معتمد على rbd في العنقود في لحظة واحدة. لا يتوقف أي شيء. أي مخزن بيانات بخلفية local في العنقود يُدرَج خارج تلك اللحظة: فهو ليس جزءًا من اللقطة. اللحظة متّسقة عبر الانهيار، وليست متّسقة على مستوى التطبيق: إذا احتجت أن تكون كتابة معيّنة داخل اللقطة، زامنها أولاً.

rdc cluster snapshot create <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--snapshot <label>`	تسمية اللقطة (الافتراضي: طابع زمني UTC)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

list

عرض لقطات المجموعة الخاصة بالعنقود.

rdc cluster snapshot list <cluster> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

5. خادم MCP

خادم MCP للوكلاء الذكية

5.1 serve

تشغيل خادم MCP (نقل stdio)

rdc mcp serve [options]

العلامة	الوصف	مطلوب	افتراضي
`--config <name>`	اسم الإعدادات المستخدمة لجميع الأوامر	لا	-
`--timeout <ms>`	مهلة الأمر الافتراضية بالميلي ثانية	لا	`120000`

6. دورة حياة المستودعات

نشر وإدارة المستودعات المشفرة على الأجهزة. الأوامر الفرعية الرئيسية: create، up (نشر)، down (إيقاف)، fork (استنساخ CoW فوري)، delete، push/pull (نسخ احتياطي)، sync (نقل الملفات). دورة الحياة: repo create → repo up → repo down. راجع المفاهيم الأساسية في rdc --help لتفاصيل البنية والتوجيه ومتغيرات البيئة.

6.1 up

نشر أو تحديث مستودع (التركيب، وتشغيل Rediaccfile up الذي يستدعي renet compose). يُشتق الجهاز من موضع المرجع. تستغرق مسارات الوكيل نحو 3 ثوانٍ لتصبح نشطة بعد النشر. يطبع نمط عنوان URL للخدمات المكشوفة عبر HTTP (وسم rediacc.service_port) عند الاكتمال. يُركَّب أول نشر والنسخ المتفرعة تلقائيًا. تُكتشف استعادة نقطة تفتيش CRIU تلقائيًا؛ استخدم --skip-checkpoint لفرض بدء جديد. استخدم --all --machine <m> لنشر كل مستودع على جهاز.

rdc repo up [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--no-start`	تركيب المستودع وتجهيزه دون تشغيل خطوات up() الخاصة به (يطوي أمر 'repo mount' المتقاعد؛ فتح LUKS، ولمستودعات العنقود، توليد PV).	لا	-
`--skip-checkpoint`	تخطي استعادة نقطة تفتيش CRIU حتى لو كانت بيانات checkpoint موجودة (فرض بدء جديد)	لا	-
`--tls`	طلب شهادة TLS مخصصة لهذا المستودع (النسخ المتفرعة تستخدم شهادة الجهاز المشتركة افتراضيًا)	لا	-
`--no-wait`	العودة فور بدء الحاويات؛ تستمر فحوصات الصحة في الخلفية	لا	-
`--all`	نشر كل مستودع موطنه --machine (صيغة الدفعة)	لا	-
`-m, --machine <name>`	مع --all: الجهاز الذي تُنفَّذ الدفعة على مستودعاته	لا	-
`--include-forks`	تشغيل/بدء المستودعات المتشعبة أيضًا	لا	-
`--parallel`	بدء المستودعات بشكل متزامن	لا	-
`--concurrency <n>`	الحد الأقصى للمستودعات المتزامنة (افتراضي: 3)	لا	`3`
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

6.2 down

إيقاف حاويات Docker الخاصة بالمستودع (يُشغِّل Rediaccfile down عبر renet compose). يُشتق الجهاز من موضع المرجع. لا يفكّ تثبيت وحدة التخزين المشفرة، بل يبقى المستودع مركَّبًا ويمكن إعادة تشغيله بـ 'repo up'. استخدم --unmount لإغلاق حاوية LUKS أيضًا بعد الإيقاف (يطوي أمر 'repo unmount' المتقاعد). استخدم --checkpoint لحفظ حالة عمليات CRIU قبل الإيقاف (يستعيدها 'repo up' التالي تلقائيًا). استخدم --all --machine <m> لإيقاف كل مستودع على جهاز.

rdc repo down [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--unmount`	فك التثبيت أيضًا (إغلاق حاوية LUKS) بعد الإيقاف. مطلوب قبل 'repo resize' أو لتأمين وحدة التخزين بالكامل	لا	-
`--checkpoint`	إنشاء نقطة تفتيش CRIU قبل الإيقاف (حفظ حالة ذاكرة العمليات للاستعادة لاحقًا عبر 'repo up')	لا	-
`--all`	إيقاف كل مستودع موطنه --machine (صيغة الدفعة)	لا	-
`-m, --machine <name>`	مع --all: الجهاز الذي تُنفَّذ الدفعة على مستودعاته	لا	-
`--parallel`	بدء المستودعات بشكل متزامن	لا	-
`--concurrency <n>`	الحد الأقصى للمستودعات المتزامنة (افتراضي: 3)	لا	`3`
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

6.3 status

الحصول على حالة المستودع

rdc repo status <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.4 health

تشغيل فحوص health() في ملف Rediaccfile للمستودع والخروج بالرمز 0 (سليم) أو 1 (تحذير) أو 2 (خطأ)

rdc repo health <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.5 repair

يشغّل دوال repair() في ملفات Rediaccfile الخاصة بالمستودع التي تسمح بها فئتها المُعلنة، ثم health() مجددًا (رمز الخروج 0 سليم، 1 تحذير، 2 خطأ أو إصلاح فاشل)

rdc repo repair <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	يعرض أي repair() سيُشغَّل دون تشغيل أي منها	لا	-
`--with-backup`	يسمح بدوال repair() من فئة auto-with-backup بعد لقطة ناجحة للمستودع	لا	-
`--window-override`	يشغّل دوال repair() من نوع window=only خارج نافذة صيانة الجهاز	لا	-
`-y, --yes`	يشغّل دون سؤال دوال repair() التي لا تُعلن فئة (operator-only)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.6 cat

قراءة نافذة محدودة من ملف داخل مستودع وكتابتها إلى stdout (محدودة من جانب الخادم؛ التشخيصات تذهب إلى stderr)

rdc repo cat <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--remote-file <path>`	مسار الملف للقراءة، نسبةً إلى جذر تثبيت المستودع	نعم	-
`--max-bytes <n>`	الحد الأقصى من البايتات للقراءة والطباعة (الافتراضي 1 MiB، الحد الأقصى المطلق 50 MiB)	لا	-
`--offset <n>`	إزاحة البايت لبدء القراءة منها	لا	-
`--head <lines>`	طباعة أول N سطر فقط (لا يمكن الدمج مع نطاق البايت)	لا	-
`--tail <lines>`	طباعة آخر N سطر فقط (لا يمكن الدمج مع نطاق البايت)	لا	-
`--stat`	طباعة الحجم والنوع ووقت التعديل فقط؛ دون قراءة أي محتوى	لا	-
`--force-binary`	السماح بقراءة المحتوى الثنائي (الذي يحتوي على NUL)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.7 diff

مقارنة على مستوى الملف بأسلوب git بين مستودعين مفترعين بنسخ-عند-الكتابة. تُبلّغ عن الملفات المضافة والمعدَّلة والمحذوفة والمعاد تسميتها. تُقارن المستودع المُعطى عبر <ref> الموضعي (الهدف / الجانب الجديد) بأصله المُحلَّل من الإعدادات المحلية، أو بمستودع --base صريح (الجانب القديم). تعتمد على البيانات الوصفية ومستقلة عن الحجم: تقارن صور LUKS المشفّرة على مستوى الكتل دون فكّ تشفيرها، فتُقارن مستودعًا بحجم 1 ج.ب وآخر بحجم 100 ج.ب في نفس أجزاء الثانية.

rdc repo diff <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--base <ref>`	المستودع المُراد المقارنة معه (الجانب القديم/الأساس)؛ افتراضيًا أصل <ref>	لا	-
`--name-only`	اطبع فقط مسارات الملفات المتغيّرة، واحدة في كل سطر (بدون أحرف الحالة)	لا	-
`--stat`	أظهر حجم التغيير لكل ملف (فروق البايت والكتل) والإجماليات	لا	-
`--content [path]`	أظهر فرقًا نصيًا موحَّدًا لملف واحد (يتطلّب مسار ملف)	لا	-
`--fast`	ثِق بمرشّح الكتل؛ تجاوز تأكيد تجزئة المحتوى (قد يُبالغ في الإبلاغ عن المُعدَّل)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.8 list

عرض المستودعات على جهاز

rdc repo list [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	لا	-
`--datastore <name>`	عرض المستودعات في مخزن البيانات هذا (يُحلّ إلى أيًا كان الجهاز الذي يحمله حاليًا)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.9 create

إنشاء مستودع جديد. حدِّد موطنه مرة واحدة: جهاز أو مخزن بيانات.

rdc repo create <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	لا	-
`--datastore <name>`	مخزن البيانات المسمى الذي يستضيف المستودع (تدرّج Docker، أو صيغة العنقود)	لا	-
`--size <size>`	حجم المستودع (مثلاً 10G، 100G، 1T)	لا	-
`--no-docker`	تخطي تشغيل Docker daemon بعد الإنشاء	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.10 delete

حذف مستودع وبياناته. يُنقل إدخال التكوين الخاص بالـ fork إلى deletedRepositories، فيتحرر الاسم ويبقى GUID قابلًا للاستعادة عبر 'repo admin archive restore'؛ أما إدخال المستودع الرئيسي (grand) أو المدفوع إلى أجهزة أخرى فيبقى ما لم تُمرَّر --archive-config. يأخذ <ref> موضعيًا؛ الاسم المجرد يُحلّ إلى الخط الرئيسي (grand) ويُرفض عندما تشترك عدة مستودعات في الاسم الأساسي، لذا مرّر name:tag لاستهداف نسخة متفرعة.

rdc repo delete <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--archive-config`	نقل إدخال الإعدادات إلى deletedRepositories للاستعادة لاحقاً	لا	-
`--purge-backups`	احذف النسخ الاحتياطية السحابية للمستودع الآن أيضًا بدل تركها تنتهي	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

6.11 commit

تجميد الحالة الحالية لفرع عمل (fork) مُركَّب في commit جديد غير قابل للتغيير (شبيه بـ git). يسجّل الـ commit رسالته ومؤلّفه وطابعه الزمني وأصله (parent) داخل المجلد المُشفَّر (بحيث ينتقل معه عند الدفع) ويُعلَّم للقراءة فقط، فيرفض التركيب. يبقى فرع العمل دون تغيير، تماماً كما يترك git شجرة العمل سليمة. استخرج الـ commit باستخدام 'rdc repo checkout' للحصول على نسخة قابلة للكتابة.

rdc repo commit <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--message <msg>`	رسالة الـ commit	نعم	-
`--author <author>`	مؤلّف الـ commit	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.12 branch

إنشاء مرجع branch مُسمّى يشير إلى الـ commit الحالي لفرع العمل (fork) (طرفه). تُخزَّن مراجع الـ branch في إعدادات الـ CLI (الجهاز = مخزن الكائنات، الإعداد = مخزن المراجع).

rdc repo branch <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--branch <branch>`	اسم الفرع الجديد	نعم	-

6.13 checkout

استنساخ commit غير قابل للتغيير (أو طرف branch) عبر reflink إلى فرع عمل (fork) جديد قابل للكتابة وتوجيه HEAD إليه. شبه فوري وثابت الزمن (reflink الخاص بـ BTRFS).

rdc repo checkout <commit-or-branch-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--tag <name>`	اسم فرع العمل (fork) الجديد القابل للكتابة	نعم	-
`--from <workingFork>`	حل الوسيطة الموضعية <commit-or-branch-ref> كاسم فرع على هذا الفرع العامل	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.14 log

طباعة سجل الـ commit الذي يمكن الوصول إليه من الـ commit الحالي لفرع العمل (fork) (أو من مرجع commit)، بتتبّع سلسلة الأصل (parent) المسجَّلة بواسطة 'rdc repo commit'. يقرأ من النسخة المرآة خارج المجلد المُشفَّر، فلا يُفتح أي commit.

rdc repo log <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.15 merge

دمج commit مصدري أو fork في fork عملي هدف. لا يتم تعديل الهدف الحي في مكانه أبداً: تُبنى النتيجة في نسخة reflink ويتم تبديلها بشكل ذري. يُرفض الهدف المُركَّب أو قيد التشغيل ما لم يُستخدم --force، الذي يوقفه أولاً بشكل نظيف. بدون --resolve يكون الدمج أخذًا للصورة الكاملة (take-theirs) فيصبح الهدف هو المصدر؛ ومع --resolve ours|theirs يكون دمجًا ثلاثي الاتجاهات لكل ملف مقابل السلف المشترك، يأخذ التغييرات الفريدة لكل جانب ويحل التعارضات الثنائية الجانب وفقًا للخيار.

rdc repo merge <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--from <source>`	الـ commit أو fork المصدري المراد الدمج منه	نعم	-
`--force`	أوقِف الهدف المُركَّب/قيد التشغيل أولاً، ثم ادمج (لا يعدّل أبداً نقطة تركيب حية)	لا	-
`—resolve <ours	theirs>`	حل التعارضات لكل ملف في دمج ثلاثي الاتجاهات: تُبقي 'ours' على نسخة الهدف، وتأخذ 'theirs' نسخة المصدر. احذفها للتقديم السريع للصورة كاملة (take-theirs).	لا
`--base <guid>`	‏GUID الخاص بإيداع السلف المشترك لدمج ثلاثي الاتجاهات (يُستخدم مع ‎--resolve). يكون افتراضيًا أصل إيداع المصدر أو الإيداع الحالي للهدف.	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.16 gc

حذف كائنات الإيداع الثابتة على جهاز التي لا يصل إليها أي فرع أو HEAD (جمع المهملات بحسب قابلية الوصول). الجهاز هو مخزن الكائنات؛ وإعداد الـ CLI هو مخزن المراجع. تشغيل تجريبي افتراضيًا: مرّر ‎--apply‎ للحذف. لا يمسّ أبدًا كائنًا مركّبًا أو نسخة عمل.

rdc repo gc [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--apply`	حذف الإيداعات غير القابلة للوصول فعليًا (الافتراضي معاينة تجريبية)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.17 fork

إنشاء نسخة CoW (نسخ عند الكتابة) من مستودع. التفريع شبه فوري وثابت الزمن بغض النظر عن حجم المستودع؛ يستنسخ reflink الخاص بـ BTRFS الصورة الأساسية بحيث يُفرَّع مستودع بحجم 100 ج.ب ومستودع بحجم 1 ج.ب في نفس أجزاء الثانية تقريبًا. تحصل النسخة المتفرعة على GUID وnetworkId ونطاق IP ونطاق توجيه تلقائي جديد ({service}-fork-{tag}.{repo}.{machine}.{baseDomain}) وهي نسخة مستقلة تمامًا. التفريع أثناء التشغيل مدعوم، ويمكن للأصل الاستمرار في العمل. ترث النسخة المتفرعة بيانات اعتماد التشفير الخاصة بالأصل تلقائيًا. استخدم --checkpoint لالتقاط حالة عمليات CRIU قبل التفريع؛ ستستعيدها النسخة المتفرعة تلقائيًا عند أول 'repo up' (تُحفظ الحالة في الذاكرة). التفريع بين الأجهزة: فرِّع محليًا أولاً، ثم انقل: (1) rdc repo fork <parent-ref> --tag <name>، (2) rdc repo push <fork-ref> --to <target-machine>، (3) rdc backup restore <fork-ref> --as <fork-name> -m <target-machine> --up. تحذير: لا تستخدم "repo push" وحدها للتفريع، فهي تُنشئ نسخة خام بنفس GUID (وليست نسخة متفرعة مستقلة). فرِّع دائمًا أولاً للحصول على هوية جديدة. تستخدم المسارات التلقائية اسم المستودع، لذا تحصل كل نسخة متفرعة على نطاق فريد تلقائيًا.

rdc repo fork <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--tag <name>`	وسم النسخة (ينشئ اسم:وسم)	نعم	-
`--checkpoint`	إنشاء نقطة تفتيش CRIU على المصدر قبل التفريع (التقاط حالة ذاكرة العمليات للاستعادة عند fork)	لا	-
`--immutable`	يضع علامة على الفرع كقراءة فقط: يرفض التحميل ويُبقي صورته مستقرة على مستوى البايت إلى الأبد (التزام/أساس مجمَّد للدفع التزايدي بين الأجهزة)	لا	-
`--up`	تركيب وبدء الخدمات بعد التفريع (fork + mount + up في أمر واحد)	لا	-
`--no-wait`	مع --up: يعود فور بدء الحاويات؛ تستمر فحوصات الصحة في الخلفية (مثالي للفروع المؤقتة)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.18 replicate

إنشاء N نسخة قراءة من مستودع في ثوانٍ، بغض النظر عن حجم قاعدة البيانات. يأخذ لقطة واحدة فقط لمخزن البيانات، ثم يُنشئ N من عمليات ربط-التفريع (fork-attach) ثابتة الزمن (نسخ عند الكتابة، كتابات محلية قابلة للتخلص منها) موزّعة عبر عقد العنقود، ويطبّق طبقة تراكبية (overlay) مُولَّدة: PersistentVolume واحد مثبَّت لكل نسخة، وStatefulSet، وService اثنان ({repo}-rw للنسخة الرئيسية، {repo}-ro عبر النسخ). النسخ هي لقطات في لحظة زمنية محددة: لا يوجد تدفّق نسخ متماثل (replication)، ولا ضمان لقراءة ما كتبته بنفسك (read-your-writes)؛ تُجري كل نسخة دورة تعافٍ من الأعطال (crash-recovery) واحدة قبل بدء الخدمة. حدِّثها باستخدام 'repo replicate refresh'. مجموعات النسخ حالة مُدارة: راجعها عبر 'repo replicate status' وأزلها عبر 'repo replicate remove'.

status

عرض مجموعات النسخ المُدارة: النسخ، العقد المستضيفة، مخازن البيانات المُفرَّعة، اللقطة، وطوابع زمن التحديث.

rdc repo replicate status <ref>

مرجع CLI: rdc repo replicate status

remove

إزالة مجموعة نسخ: حذف كائنات k8s المُولَّدة لها (ضمن نطاق التصنيفات)، والتخلص من مخازن بياناتها المُفرَّعة، وإسقاط لقطتها، ونسيان حالتها. خطوات البنية التحتية تُنفَّذ على أساس بذل أفضل جهد (best-effort) بحيث تكتمل الإزالة حتى على عنقود فقد جزءًا منه.

rdc repo replicate remove <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

refresh

نقل كل نسخة إلى لقطة جديدة في لحظة زمنية محددة، واحدة تلو الأخرى: أعد تشغيل pod الخاص بالنسخة، تخلَّص من مخزن بياناته وأعد تفريعه على نفس المسار، ثم اسمح لفحص الجاهزية (readiness) بإعادة قبوله. تستمر N-1 نسخة في تقديم الخدمة طوال هذه العملية.

rdc repo replicate refresh <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.19 canary

شغّل صورة جديدة إلى جانب الصورة المستقرة وقسّم حركة المرور الحية بينهما بنسبة مئوية (الدرجة 2 من سلّم الإصدار). يُنشئ هذا الأمر Deployment وService واحدًا للـ Canary على نفس البيانات الحية (بلا تفريع: لأن مستخدمي الـ Canary على بيانات مفرَّعة سيقرؤون بيانات قديمة ويكتبون في نسخة مصيرها الحذف)، ويُخبر وكيل Rediacc بتوجيه النسبة المحددة من حركة مرور المضيف المستقر إليه. الوزن 0 يُبقي الـ Canary بلا حركة مرور (dark)، والوزن 100 هو تحويل blue/green الكامل. قبل كل تغيير على الـ Canary، تؤخذ تلقائيًا لقطة جماعية لمخازن بيانات العنقود (الدرجة 0 من سلّم الإصدار) كوسيلة تراجع شاملة. توافق المخطط (schema) بين الإصدارين (expand-contract) هو مسؤولية التطبيق نفسه. أما الإصدارات التي تكسر المخطط، فاستخدم blue/green بدلاً من ذلك: فرّع المستودع (فوري، يشمل البيانات)، ووجّه Service الخاص بالتفريع إلى هنا بوزن 100، وتراجع بإعادة تشغيل الأصل غير الممسوس؛ الكتابات التي تحدث بعد التحويل توجد فقط في النسخة الجديدة، لذا نافذة التراجع قرار يخص السياسة التشغيلية.

status

عرض مجموعات الـ Canary المُدارة: الوزن، الصور، Service المستقر، وأحدث لقطة للتراجع عن الإصدار.

rdc repo canary status <ref>

مرجع CLI: rdc repo canary status

weight

تغيير نسبة حركة المرور الموجَّهة إلى الـ Canary. يأخذ أولاً لقطة جماعية جديدة للتراجع عن الإصدار، ثم يعيد تطبيق الطبقة التراكبية (overlay)؛ ويلتقط الوكيل التقسيم الجديد في دورة التحديث التالية. الوزن 100 يرسل كل حركة المرور إلى الإصدار الجديد (تحويل blue/green).

rdc repo canary weight <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--weight <percent>`	نسبة حركة المرور الموجَّهة إلى الـ Canary (عدد صحيح من 0 إلى 100؛ 0 = تشغيل خفي، 100 = تحويل كامل)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

remove

إزالة Deployment وService الخاصين بالـ Canary (ضمن نطاق التصنيفات)؛ يعود Service المستقر لخدمة 100% من حركة المرور. تُحتفَظ بلقطات التراجع عن الإصدار؛ نظّفها باستخدام أوامر لقطات مخزن البيانات.

rdc repo canary remove <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

create

تشغيل صورة جديدة إلى جانب الصورة المستقرة وإرسال نسبة مئوية من حركة المرور الحية إليها. يشارك الـ Canary بيانات المستودع الحية (بلا تفريع)، لذا فإن توافق المخطط بين الإصدارين مسؤولية التطبيق. تُؤخذ لقطة جماعية لمخازن بيانات العنقود أولاً، كوسيلة للتراجع.

rdc repo canary create <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--image <image>`	الصورة الجديدة التي يشغّلها Deployment الخاص بالـ Canary (على البيانات الحية المشتركة)	نعم	-
`--port <port>`	المنفذ الذي يخدم عليه التطبيق (يجب أن يطابق Service المستقر)	نعم	-
`--weight <percent>`	نسبة حركة المرور الموجَّهة إلى الـ Canary (عدد صحيح من 0 إلى 100؛ 0 = تشغيل خفي، 100 = تحويل كامل)	نعم	-
`--service <name>`	Service المستقر الذي سيتم تقسيم حركة المرور معه (الافتراضي: اسم المستودع)	لا	-
`--replicas <n>`	عدد نسخ Deployment الخاص بالـ Canary (الافتراضي: 1)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.20 resize

تغيير حجم مستودع دون اتصال (يدعم التوسيع والتقليص)

rdc repo resize <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--size <size>`	حجم المستودع الجديد (مثلاً 10G، 100G، 1T)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.21 expand

توسيع مستودع مُركّب أثناء التشغيل (بدون توقف)

rdc repo expand <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--size <size>`	حجم المستودع الجديد (مثلاً 10G، 100G، 1T)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.22 trim

استعادة مساحة تجمّع مخزن البيانات من المستودعات المركَّبة (أثناء التشغيل، دون توقف). تُعاد الكتل المحذوفة داخل المستودعات إلى التجمّع عبر fstrim. بدون مرجع، تُعالَج كل المستودعات المركَّبة على -m ومخزن البيانات نفسه. يُتخطى fstrim للمستودعات التي يجري نسخها احتياطيًا، لكن استعادة --docker تظل تُنفَّذ

rdc repo trim [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--docker`	استعادة مساحة Docker (حاويات متوقفة، صور معلّقة، ذاكرة بناء مؤقتة)؛ تُنفَّذ حتى أثناء وجود لقطة نسخ احتياطي نشطة	لا	-
`--docker-volumes`	حذف وحدات تخزين Docker غير المستخدمة أيضًا	لا	-
`--report-only`	عرض حالة discard وتقدير المساحة القابلة للاستعادة دون تنفيذ	لا	-
`-m, --machine <name>`	اسم الجهاز المستهدف	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.23 prune

يصنّف تخزين Docker لمستودع ويستعيد مساحته: الصور غير المستخدمة، وذاكرة البناء المؤقتة، والحاويات المتوقفة، ومجلدات overlay2 التي لا تشير إليها أي صورة أو حاوية. تشغيل تجريبي ما لم تُستخدم --apply. تستعيد --apply المساحة عبر واجهة Docker البرمجية مع بقاء المستودع متصلاً، وتوقف --apply --offline فوق ذلك عفريت Docker الخاص بالمستودع طوال التشغيل وتعزل المجلدات اليتيمة. من دون مرجع، تفحص كل المستودعات المركّبة على -m (تشغيل تجريبي فقط)

rdc repo prune [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--apply`	استعادة المساحة؛ من دونه يقتصر التشغيل على الإبلاغ	لا	-
`--offline`	إيقاف عفريت Docker الخاص بالمستودع وعزل المجلدات اليتيمة (يتطلب --apply)	لا	-
`--all-images`	إزالة الصور الموسومة التي لا تستخدمها أي حاوية أيضاً	لا	-
`--no-trim`	تخطي fstrim بعد الاستعادة	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`-m, --machine <name>`	اسم الجهاز المستهدف	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.24 policy

إدارة سياسة الحجم التلقائية التي يطبقها مشرف التخزين في الجهاز: يوسّع حصة المستودع أثناء التشغيل عندما يمتلئ (لا يتجاوز max-quota أبدًا، ولا يوسّع عند انخفاض مساحة التجمّع) وينفّذ عمليات trim مجدولة. لا يوجد تقليص تلقائي؛ استخدم 'repo resize' لذلك. بدون مرجع، تُدار السياسة الافتراضية على مستوى الجهاز عبر -m

set

يضبط حقول سياسة الحجم. تتغير الأعلام الممررة فقط؛ تحتفظ بقية الحقول المخزنة بقيمها. يتطلب تفعيل التوسيع التلقائي ‎--max-quota: السقف هو موافقتك الصريحة على تجاوز سعة التجمّع

rdc repo policy set [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--auto-grow <bool>`	تفعيل التوسيع التلقائي للحصة أثناء التشغيل (true/false)	لا	-
`--max-quota <size>`	سقف التوسيع التلقائي (مثل 200G)؛ مطلوب للتوسيع التلقائي	لا	-
`--grow-threshold <percent>`	نسبة استخدام نظام الملفات التي تطلق التوسيع (الافتراضي 85)	لا	-
`--grow-step <step>`	مقدار التوسيع لكل خطوة: مطلق (10G) أو نسبة من الحصة (20%)	لا	-
`--auto-trim <bool>`	تفعيل trim المجدول (true/false)	لا	-
`--trim-interval <hours>`	الحد الأدنى من الساعات بين عمليات trim التلقائية (الافتراضي 24)	لا	-
`--memory-max <size>`	سقف الذاكرة للمستودع (مثل 10G، أو max لإزالته)؛ عند بلوغه تُنهى إحدى حاوياته بسبب نفاد الذاكرة دون المساس بما هو خارجه	لا	-
`--memory-high <size>`	نقطة تقييد الذاكرة للمستودع (مثل 8G، أو max لإزالتها)	لا	-
`--cpu-max <cores>`	سقف المعالج للمستودع بعدد الأنوية (4، 2.5) أو N%، أو max لإزالته	لا	-
`--io-max <limits>`	سقف الإدخال/الإخراج لجهاز المستودع: rbps=،wbps=،riops=،wiops= (أي مجموعة منها، مثل rbps=200M,wbps=100M؛ KEY=max يزيل قيمة) أو max	لا	-
`--pids-max <count>`	سقف عدد العمليات للمستودع (pids.max)، أو max لإزالته	لا	-
`--ram-volume <size>`	حجم وحدة تخزين RAM للمستودع في <mount>/.ram (مثل 8G، أو max لإزالتها)؛ يجب أن يبقى سقف الذاكرة أعلى منها بمقدار 1G	لا	-
`--clear-limits`	إزالة كل الحدود ووحدة تخزين RAM من المستودع	لا	-
`--force`	السماح بسقف ذاكرة أقل من استخدام المستودع الحالي للذاكرة	لا	-
`-m, --machine <name>`	اسم الجهاز المستهدف	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

get

عرض افتراضي الجهاز المخزَّن، وتجاوز المستودع (مع مرجع)، والسياسة الفعلية المدمجة التي يعمل بها المشرف

rdc repo policy get [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.25 push

دفع مستودع إلى جهاز آخر. وجهات التخزين مُلغاة؛ استخدم `rdc backup snapshot` للنسخ الاحتياطي بنقطة زمنية. عند النقل بين الأجهزة، تُنسخ صورة المستودع المشفرة بنفس GUID: هذا نسخ احتياطي/ترحيل وليس fork. لإنشاء fork مستقل، استخدم 'repo fork' أولاً ثم ادفع. تصل النسخة المدفوعة كعنصر نسخة احتياطية (ARTIFACT): شغّلها على الجهاز الهدف بـ 'backup restore <ref> --as <name> -m <target> --up'

rdc repo push <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--to <remote>`	اسم الجهاز الهدف (يُكتشف تلقائياً من الإعدادات)	لا	-
`--to-machine <machine>`	—	لا	-
`--provision <provider>`	تزويد الجهاز الهدف تلقائياً عبر مزود السحابة إذا لم يكن موجوداً	لا	-
`--checkpoint`	إنشاء نقطة فحص CRIU قبل النسخ الاحتياطي (التقاط حالة ذاكرة العمليات للترحيل المباشر)	لا	-
`--force`	فرض الكتابة فوق النسخة الاحتياطية الموجودة	لا	-
`--bwlimit <limit>`	حدّ سرعة النقل: بايت في الثانية، أو وحدات عشرية (12.5M = ‏12.5 MB/s)، أو وحدات ثنائية (12Mi)، أو بتات (100Mbps). بدونه لا يوجد حدّ	لا	-
`--delta-base <guid>`	معرّف GUID أساسي ثابت متطابق بايتياً على كلا الجهازين؛ نقل الكتل المتغيرة فقط (هدف الجهاز). احذفه للاكتشاف التلقائي للأساس	لا	-
`--strategy <strategy>`	استراتيجية دلتا الكتل عند استخدام أساس دلتا: auto أو physical أو shared	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.26 pull

سحب مستودع من جهاز آخر. مصادر التخزين مُلغاة؛ استخدم `rdc backup restore` للاستعادة بنقطة زمنية. يُكتشف نوع المصدر تلقائياً من الإعدادات. استخدم --up للنشر بعد السحب

rdc repo pull <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--from <remote>`	اسم الجهاز المصدر (يُكتشف تلقائياً من الإعدادات)	لا	-
`--from-machine <machine>`	—	لا	-
`--force`	فرض الكتابة فوق المستودع الموجود	لا	-
`--up`	بعد السحب، قم بتركيب ونشر المستودع على هذا الجهاز	لا	-
`--bwlimit <limit>`	حدّ سرعة النقل: بايت في الثانية، أو وحدات عشرية (12.5M = ‏12.5 MB/s)، أو وحدات ثنائية (12Mi)، أو بتات (100Mbps). بدونه لا يوجد حدّ	لا	-
`--delta-base <guid>`	معرّف GUID أساسي ثابت متطابق بايتياً على كلا الجهازين؛ استقبال الكتل المتغيرة فقط (مصدر الجهاز)	لا	-
`--strategy <strategy>`	استراتيجية دلتا الكتل عند استخدام أساس دلتا: auto أو physical أو shared	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.27 migrate

ترحيل مستودع حيًا من جهاز إلى آخر بأقل توقف ممكن. rsync على مرحلتين: نقل كتلي أثناء التشغيل، ثم توقف قصير لمزامنة الفروقات (delta). ينقل المستودع بالكامل (يُعاد توجيه التوجيه إلى الموطن الجديد)، وبمجرد نجاح النقل، يحذف صور المصدر (استخدم --keep-source للاحتفاظ بها). يدعم نقطة تفتيش CRIU لترحيل حالة ذاكرة العمليات والتزويد التلقائي للأجهزة الهدف

rdc repo migrate <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--to <place>`	الجهاز أو العنقود الوجهة	نعم	-
`--provision <provider>`	توفير تلقائي للهدف عبر مزود السحابة (مثال: hetzner، linode)	لا	-
`--bwlimit <limit>`	حدّ سرعة النقل: بايت في الثانية، أو وحدات عشرية (12.5M = ‏12.5 MB/s)، أو وحدات ثنائية (12Mi)، أو بتات (100Mbps). بدونه لا يوجد حدّ	لا	-
`--checkpoint`	ترحيل مباشر عبر CRIU: التقاط واستعادة حالة ذاكرة العمليات	لا	-
`--delta-base <guid>`	معرّف GUID أساسي ثابت لدلتا التحويل (متقدّم؛ الافتراضي هو أساس المرحلة 1)	لا	-
`--strategy <strategy>`	استراتيجية دلتا الكتل للتحويل: auto أو physical أو shared	لا	-
`--skip-dns`	تخطي تبديل سجلات DNS بعد الترحيل	لا	-
`--keep-source`	الاحتفاظ بصور المصدر بعد نجاح النقل (تُحذف افتراضيًا؛ النسخ المتبقية غير قابلة للعنونة من أي سجل تكوين، وتُعلّمها reconcile كعناصر شاردة)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.28 sync

مزامنة المستودعات والملفات (دفع/سحب جماعي، نقل ملفات)

upload

رفع الملفات إلى مستودع

rdc repo sync upload <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--local <paths...>`	مسار واحد أو أكثر لملف أو مجلد محلي (الافتراضي: المجلد الحالي)	لا	-
`--remote <path>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--remote-file <path>`	‫مسار ملف بعيد واحد (نسبي إلى جذر المستودع) للرفع إليه. لا يمكن استخدامه مع --remote.	لا	-
`--mirror`	وضع الانعكاس - حذف الملفات البعيدة غير الموجودة محلياً	لا	-
`--verify`	التحقق من الملفات باستخدام المجاميع الاختبارية بعد المزامنة	لا	-
`--confirm`	معاينة التغييرات وطلب التأكيد قبل المزامنة	لا	-
`--exclude <patterns...>`	الأنماط التي يتم استبعادها من المزامنة	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

download

تنزيل الملفات من مستودع

rdc repo sync download <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--local <path>`	مسار المجلد المحلي (افتراضي: المجلد الحالي)	لا	-
`--remote <path>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--remote-file <path>`	مسار الملف البعيد داخل المستودع (بديل لـ --remote لنقل ملف واحد)	لا	-
`--mirror`	وضع الانعكاس - حذف الملفات المحلية غير الموجودة على البعيد	لا	-
`--verify`	التحقق من الملفات باستخدام المجاميع الاختبارية بعد المزامنة	لا	-
`--confirm`	معاينة التغييرات وطلب التأكيد قبل المزامنة	لا	-
`--exclude <patterns...>`	الأنماط التي يتم استبعادها من المزامنة	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

status

التحقق من حالة المزامنة ومقارنة الملفات المحلية/البعيدة

rdc repo sync status <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--local <path>`	مسار المجلد المحلي (افتراضي: المجلد الحالي)	لا	-
`--remote <path>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--remote-file <path>`	مسار الملف البعيد داخل المستودع (بديل لـ --remote لنقل ملف واحد)	لا	-

6.29 tunnel

إنشاء نفق SSH لتوجيه المنافذ إلى منفذ حاوية على جهاز بعيد. يكتشف تلقائيًا الحاوية والمنفذ عندما لا يكون هناك غموض. يبقى النفق مفتوحًا حتى تضغط Ctrl+C

rdc repo tunnel <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`-c, --container <name>`	اسم الحاوية (يُكتشف تلقائيًا إذا كانت واحدة فقط قيد التشغيل)	لا	-
`--port <port>`	منفذ الحاوية البعيد للتوجيه	لا	-
`--local <port>`	المنفذ المحلي (الافتراضي نفس المنفذ البعيد)	لا	-
`--url-only`	طباعة عنوان URL المحلي فقط عند جهوزية النفق (قابل للقراءة آلياً)	لا	-

6.30 secret

إدارة أسرار كل مستودع المُحقنة وقت النشر. للكتابة فقط: تُعيد get التلخيص فقط (لا القيمة الصريحة أبدًا)، وتتطلب set/unset تطابق تلخيص --current أو --rotate-secret. وضعا تسليم: env (REDIACC_SECRET_<KEY>) وfile (نظام tmpfs في /var/run/rediacc/net-<networkId>/secrets/<KEY> عبر `secrets:` في compose). الأسرار لا تدخل صورة LUKS المشفرة أبدًا؛ النسخ المتفرعة لا ترث أيًا منها.

get

عرض تلخيص SHA-256 لسر. لا تُعاد القيمة الصريحة أبدًا بحكم التصميم (للكتابة فقط). استخدم --current في عملية set/unset لاحقة للتحقق من قيمة تعرفها بالفعل، أو دوّرها عبر `set --rotate-secret`.

rdc repo secret get <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <KEY>`	مفتاح السر بصيغة UPPER_SNAKE_CASE (بحد أقصى 64 حرفاً). سيتم عرضه كـ REDIACC_SECRET_<KEY> لوضع env أو /run/secrets/<key> في الحاويات لوضع file.	نعم	-

list

سرد مفاتيح وأوضاع السر (لا قيم أبداً، ولا ملخصات).

rdc repo secret list <ref>

مرجع CLI: rdc repo secret list

set

تعيين أو الكتابة فوق سر. الشوكات لا ترث؛ عيّن على الشوكة بشكل صريح. تحت سياق الوكيل، يتطلب تطابق ملخص --current (نمط passwd).

rdc repo secret set <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <KEY>`	مفتاح السر بصيغة UPPER_SNAKE_CASE (بحد أقصى 64 حرفاً). سيتم عرضه كـ REDIACC_SECRET_<KEY> لوضع env أو /run/secrets/<key> في الحاويات لوضع file.	نعم	-
`--value <value>`	قيمة السر. مرر `-` للقراءة من stdin (يتجنب التعرض في سجل الصدفة).	نعم	-
`--mode <mode>`	وضع التسليم: 'env' (مرئي في بيئة الحاوية، docker inspect) أو 'file' (ملف tmpfs، ليس في البيئة أبداً). الافتراضي: file.	لا	`file`
`--current <value>`	القيمة الصريحة السابقة (شرط مسبق بنمط passwd). مطلوبة للكتابة فوق القيمة أو حذفها؛ حصرية بشكل متبادل مع --rotate-secret.	لا	-
`--rotate-secret`	الإقرار بالتدوير؛ تخطي شرط --current المسبق (مدقق كتدوير). استخدم عند التدوير المتعمد دون التحقق من القيمة السابقة.	لا	-

unset

حذف سر. تحت سياق الوكيل، يتطلب تطابق ملخص --current.

rdc repo secret unset <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <KEY>`	مفتاح السر بصيغة UPPER_SNAKE_CASE (بحد أقصى 64 حرفاً). سيتم عرضه كـ REDIACC_SECRET_<KEY> لوضع env أو /run/secrets/<key> في الحاويات لوضع file.	نعم	-
`--current <value>`	القيمة الصريحة السابقة (شرط مسبق بنمط passwd). مطلوبة للكتابة فوق القيمة أو حذفها؛ حصرية بشكل متبادل مع --rotate-secret.	لا	-
`--rotate-secret`	الإقرار بالتدوير؛ تخطي شرط --current المسبق (مدقق كتدوير). استخدم عند التدوير المتعمد دون التحقق من القيمة السابقة.	لا	-

6.31 admin

أفعال إدارة وصيانة المستودعات.

validate

التحقق من سلامة المستودع

rdc repo admin validate <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

fsck

التحقق من مراجع إعداد الـ CLI (الفروع، HEAD) مقابل الكائنات الموجودة فعليًا على جهاز. يبلّغ عن المراجع المعلّقة (مرجع يشير إلى كائن مفقود) والإيداعات اليتيمة (إيداع ثابت لا يصل إليه أي مرجع). للقراءة فقط.

rdc repo admin fsck [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

ownership

تغيير ملكية مجلد المستودع

rdc repo admin ownership <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--uid <uid>`	معرّف المالك UID (افتراضي: 7111)	لا	-
`--root-owned`	تسليم الملفات المملوكة لـ root الموجودة تحت أدلة يملكها root أو هذا UID إلى UID المالك، مع تسجيل كل منها في بيان تراجع	لا	-
`--dry-run`	مع --root-owned: عرض الملفات التي ستتغير دون تغيير أي شيء	لا	-
`--undo`	مع --root-owned: إعادة ملفات بيان التراجع التي لا يزال UID المالك يملكها إلى root	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

autostart

إدارة التشغيل التلقائي للمستودعات عند الإقلاع

enable:

تمكين التشغيل التلقائي لمستودع

rdc repo admin autostart enable [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

disable:

تعطيل التشغيل التلقائي لمستودع

rdc repo admin autostart disable [ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

list:

عرض المستودعات ذات التشغيل التلقائي المفعّل

rdc repo admin autostart list [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

template

تطبيق قالب على مستودع

list:

عرض جميع قوالب النشر المضمنة في واجهة سطر الأوامر

rdc repo admin template list

مرجع CLI: rdc repo admin template list

apply:

طبّق قالبًا على مستودع. استخدم اسم قالب مدمج (مثل app-postgres) أو --file لقالب JSON مخصص. دورة حياة Rediaccfile: up() تُشغّل الحاويات (سحب الصور، توليد الإعدادات هنا)، down() توقفها. Rediaccfile الأدنى: up() { renet compose -- pull; renet compose -- up -d; } down() { renet compose -- down; }. مهم: يجب أن يستخدم Rediaccfile 'renet compose': يُرفض 'docker compose'. متغيرات البيئة: مستويان: (أ) صَدَفة Rediaccfile: ${SVCNAME_IP} (مثل APP_IP)، ${REDIACC_WORKING_DIR}، ${REDIACC_NETWORK_ID}. (ب) داخل الحاويات: يُدرج renet تلقائيًا متغيرات SERVICE_IP وREDIACC_NETWORK_ID. تتولى إعادة كتابة bind عبر eBPF عزل IP بشفافية، لذا يمكن للتطبيقات الارتباط بـ 0.0.0.0 وتعيد النواة كتابته إلى عنوان loopback الصحيح. يمكن لفحوصات الصحة استخدام localhost. يُدرج network_mode:host تلقائيًا وتُتجاهل ports:. التخزين: كل من bind mounts الخاصة بـ ${REDIACC_WORKING_DIR}/... وأحجام Docker المسمّاة آمنة: جذر بيانات Docker داخل حجم LUKS المشفر. سياسة إعادة التشغيل: سياسات إعادة التشغيل آمنة: يحذفها renet تلقائيًا لتوافق CRIU ويتولى watchdog التعافي. Compose: لا تُضف network_mode أو علامات rediacc.* (يُدرجها renet تلقائيًا). مشاريع متعددة: ضع كل مشروع فرعي في مجلده الفرعي الخاص مع Rediaccfile خاص به: يكتشفها renet تلقائيًا ويشغّلها بالترتيب. توجيه HTTPS: (أ) المسار التلقائي (متوافق مع النسخ المتفرعة، موصى به): لا تُضف traefik.enable. يولّد Renet تلقائيًا https://{serviceName}.{repoName}.{machineName}.{baseDomain}. أضف علامة rediacc.service_port=<port> للمنافذ غير 80. يحصل كل نسخة متفرعة على نطاق فريد. (ب) علامات Traefik (نطاق مخصص، غير متوافق مع النسخ المتفرعة): traefik.enable=true، traefik.http.routers.<n>.rule=Host(`domain`)، traefik.http.routers.<n>.entrypoints=websecure,websecure-v6، traefik.http.routers.<n>.tls.certresolver=letsencrypt، traefik.http.services.<n>.loadbalancer.server.port=<port>. لـ TCP/UDP: rediacc.tcp_ports=3306 / rediacc.udp_ports=53

rdc repo admin template apply <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--template <name>`	القالب المُراد تطبيقه	نعم	-
`--file <path>`	مسار ملف قالب JSON مخصص ({"version":"2","files":{"Rediaccfile":"...","docker-compose.yml":"..."}}): يتجاوز اسم القالب المدمج	لا	-
`--grand <name>`	اسم المستودع الرئيسي (يُحلّ تلقائيًا إلى GUID)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.32 promote

استبدال بيانات المستودع الأصلي ببيانات النسخة المتفرعة. يحتفظ الأصلي بهويته (GUID، networkId، النطاقات، التشغيل التلقائي، سلسلة النسخ الاحتياطي) لكنه يحصل على البيانات المحدّثة من النسخة المتفرعة. يتم حفظ البيانات القديمة للإنتاج كنسخة احتياطية متفرعة. للاستخدام: اختبر الترقية على النسخة المتفرعة → تحقق → استحوذ على بيانات الإنتاج.

rdc repo promote <fork-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.33 logs

عرض سجلات التطبيق من حاويات مستودع. مستودعات Docker تُقرأ من Docker daemon الخاص بالمستودع نفسه؛ مستودعات Kubernetes تقرأ سجلات الـ pod في فضاء أسماء المستودع. إذا كان المستودع يُشغّل أكثر من حاوية، حدِّد المطلوبة بـ --container.

rdc repo logs <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`-c, --container <name>`	الحاوية المُراد قراءتها (مطلوبة فقط عندما يُشغّل المستودع أكثر من واحدة)	لا	-
`-f, --follow`	الاستمرار في بث الأسطر الجديدة حتى المقاطعة	لا	-
`--lines <n>`	عدد أسطر السجل التاريخية المُراد عرضها (الافتراضي: 100)	لا	`100`
`--timestamps`	إضافة الطابع الزمني في بداية كل سطر	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.34 exec

تشغيل أمر داخل حاوية مستودع. يُمرَّر رمز خروج الأمر نفسه مباشرةً، لذا يعمل هذا في البرامج النصية والشروط. مستودعات Docker تُشغِّله عبر Docker daemon الخاص بالمستودع؛ مستودعات Kubernetes تُشغِّله في فضاء أسماء المستودع.

rdc repo exec <ref> <cmd...> [options]

مرجع CLI: rdc repo exec

العلامة	الوصف	مطلوب	افتراضي
`-c, --container <name>`	الحاوية المُراد التشغيل بداخلها (مطلوبة فقط عندما يُشغّل المستودع أكثر من واحدة)	لا	-
`-i, --interactive`	تخصيص طرفية (لأمر يتوقع واحدة)	لا	-
`-u, --user <user>`	المستخدم الذي يُشغَّل الأمر باسمه	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.35 gpu

يمنح مستودعًا جهاز CDI (مثل nvidia.com/gpu=all) كي تتمكن حاوياته من طلبه، أو يسحبه مجددًا. الجهاز هو من يفرض التصريح؛ والتصريح الحصري يحجز الجهاز لمستودع واحد.

grant

يسمح لحاويات المستودع بطلب جهاز CDI. تظهر أسماء الأجهزة في 'rdc machine gpu list'.

rdc repo gpu grant <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--device <cdi-name>`	اسم جهاز CDI الكامل (مثل nvidia.com/gpu=all)	نعم	-
`--exclusive`	حجز الجهاز لهذا المستودع: لا يمكن منحه لمستودع آخر في هذه الأثناء	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

revoke

يسحب جهاز CDI من حاويات المستودع. تحتفظ به الحاويات التي تملكه بالفعل حتى تُعاد تشغيلها.

rdc repo gpu revoke <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--device <cdi-name>`	اسم جهاز CDI الكامل (مثل nvidia.com/gpu=all)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.36 permission

يوسّع ما يمكن لـ up() و down() في ملف Rediaccfile الخاص بالمستودع الوصول إليه. يعملان بصفة المستخدم العام غير المميّز؛ ويضيف المنح مسارًا (--path) أو صلاحية root دون خفض الامتيازات (--root). تفرض الآلة المنح، ولا يستطيع ملف Rediaccfile طلبه إلا عبر سطر '# rediacc:needs'، ويبدأ الفرع (fork) دون أي منح.

grant

السماح لـ up() و down() في ملف Rediaccfile الخاص بالمستودع بالوصول إلى مسار أو بالعمل بصفة root. يُرفض --root للوكيل ما لم يعيّن المستخدم REDIACC_ALLOW_GRAND_REPO قبل بدء الوكيل.

rdc repo permission grant <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--root`	تشغيل up() و down() بصفة root دون خفض الامتيازات	لا	-
`--path <path>`	مسار مطلق يمكن لـ up() و down() الوصول إليه، بالصيغة PATH[:ro\|:rw] (للقراءة فقط افتراضيًا)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

revoke

يسحب منح مسار دورة الحياة، أو منح root، من المستودع. ستعمل up() و down() التاليتان بما تبقى.

rdc repo permission revoke <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--root`	سحب منح root	لا	-
`--path <path>`	المسار المطلق المراد سحبه	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

show

يعرض ما إذا كانت up() و down() في المستودع تعملان بصفة root، وما المسارات التي يمكنهما الوصول إليها.

rdc repo permission show <ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

7. المهام المنفصلة

إدارة المهام المنفصلة (detached jobs) على جهاز: عرض قائمتها، التحقق من حالتها، إعادة تشغيل أو متابعة سجلات أحداثها، إلغاء إحداها، أو تنظيف المهام المكتملة. تعمل المهمة المنفصلة تحت systemd على الجهاز، لذا تبقى قائمة حتى عند انقطاع الاتصال ويمكن إعادة الاتصال بها لاحقًا.

7.1 list

عرض المهام المنفصلة على جهاز، الأحدث أولًا

rdc job list [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف (احذفه لعرض تذاكر المهام المعلّقة في هذه الإعدادات)	لا	-
`--all`	تضمين التذاكر المنتهية والمتجاهلة	لا	-

7.2 status

عرض حالة مهمة منفصلة

rdc job status <job-id> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف (اختياري عندما تحتفظ هذه الإعدادات بتذكرة للمهمة)	لا	-

7.3 logs

إعادة تشغيل أو متابعة سجل أحداث مهمة منفصلة

rdc job logs <job-id> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف (اختياري عندما تحتفظ هذه الإعدادات بتذكرة للمهمة)	لا	-
`-f, --follow`	بث السجل حتى انتهاء المهمة	لا	-
`--since-line <n>`	الاستئناف بعد هذا العدد من الأسطر (العدد الذي استلمته بالفعل)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

7.4 cancel

إلغاء مهمة منفصلة قيد التشغيل

rdc job cancel <job-id> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف (اختياري عندما تحتفظ هذه الإعدادات بتذكرة للمهمة)	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-

7.5 gc

إزالة المهام المكتملة وسجلاتها

rdc job gc [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--older-than <duration>`	تجميع المهام التي انتهت منذ أكثر من هذه المدة، بالساعات (الافتراضي: 168)	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-

7.6 wait

استئناف متابعة مهمة من تذكرتها، ثم الإقرار بها والخروج برمز خروج المهمة

rdc job wait <job-id> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف (اختياري عندما تحتفظ هذه الإعدادات بتذكرة للمهمة)	لا	-
`--timeout <duration>`	التوقف عن الانتظار بعد هذه المدة (30s أو 5m أو 2h؛ الرقم وحده يعني ثوانيَ). تواصل المهمة العمل.	لا	-

7.7 dismiss

التخلي عن تذاكر المهام محليًا: تُسقط الخطوات المعلقة ولا تظهر التذكرة بعد ذلك. لا يتصل بالجهاز ولا يمس المهمة نفسها.

rdc job dismiss [job-id...] [options]

مرجع CLI: rdc job dismiss

العلامة	الوصف	مطلوب	افتراضي
`--stale`	تجاهل كل التذاكر المعلقة الأقدم من --older-than (الافتراضي 24h)	لا	-
`--older-than <duration>`	مع --stale، الحد الأدنى لعمر التذكرة، مثل 90m أو 24h (الافتراضي: 24h)	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-

8. النسخ الاحتياطي والاستعادة

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

8.1 browse

عرض الملفات التي يحتويها المستودع. افتراضيًا يكون هذا مرورًا محليًا للقراءة فقط على صورة المستودع: بلا خادم حساب وبلا شبكة. يجب تحميل المستودع المشفّر أو نشر ملف مفتاحه قبل فتحه، ويخبرك browse بذلك بدل عرض قائمة فارغة. مع --at <وقت|لقطة> يعرض بدلًا من ذلك قائمة الملفات المحفوظة مع لقطة في مخزن الأجزاء، دون استعادتها.

rdc backup browse <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--path <subdir>`	قصر العرض على هذه الشجرة الفرعية	لا	-
`--depth <n>`	قصر عمق النزول على N مستوى (0 لعدم التحديد)	لا	-
`--limit <n>`	الحد الأقصى للعناصر المُعادة (0 لعدم التحديد)	لا	-
`—at <time	snapshot>`	عرض اللقطة المأخوذة عند هذا الوقت أو قبله، أو معرّف هذه اللقطة (يقرأ مخزن الأجزاء)	لا
`--from <storeId>`	مع --at، اقرأ اللقطة من مخزن النسخ الاحتياطية هذا بدل الأعلى ترتيبًا	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.2 cancel

إلغاء نسخة احتياطية قيد التشغيل على جهاز بعيد

rdc backup cancel [strategy] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.3 list

عرض عناصر النسخ الاحتياطي على جهاز.

rdc backup list [artifact-ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	لا	-
`--path <subdir>`	اقتصر السرد على دليل فرعي واحد؛ اتركه فارغًا لسرد مخزن البيانات بالكامل	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.4 manifests

عرض بيانات لقطات النسخ الاحتياطي المسجَّلة على الخادم

rdc backup manifests [repo-ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--limit <n>`	عدد الصفوف في الصفحة (الافتراضي والأقصى 500)	لا	-
`--before <cursor>`	مؤشر الصفحة من قائمة سابقة (nextBefore)	لا	-
`--include-deleted`	تضمين اللقطات التي ينتظر حذفها المؤجَّل	لا	-

8.5 restore

تحويل عنصر نسخة احتياطية إلى مستودع فعلي. يُحدَّد الموضع هنا.

rdc backup restore <artifact-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--as <name>`	اسم المستودع المُستعاد (افتراضيًا اسم العنصر)	لا	-
`-m, --machine <name>`	اسم الآلة	لا	-
`--datastore <name>`	الاستعادة إلى مخزن البيانات المسمى هذا (يستضيفه الجهاز المرفق به)	لا	-
`--at <time>`	الاستعادة إلى نقطة زمنية: معرّف لقطة أو وقت بصيغة RFC3339 (استعادة من التخزين المجزّأ)	لا	-
`--from <storeId>`	قراءة اللقطة من مخزن النسخ الاحتياطية هذا (الافتراضي: المخزن الذي يحوي أحدث لقطة تم التحقق منها، مع الانتقال إلى التالي عند تعطل المخزن)	لا	-
`--any-stream`	مع --at، انظر أيضًا في اللقطات التي كتبتها أجهزة أخرى وفروع من هذا النسب (الافتراضي: هذا المستودع على جهازه المصدر فقط)	لا	-
`--no-seed`	جلب كل جزء من المخزن بدلاً من إعادة استخدام المرساة المحلية أو صور المستودع (يثبت أن المخزن قابل للقراءة)	لا	-
`--allow-unopenable`	ضع الصورة حتى لو لم تفتحها عبارة مرور المستودع (لقطة تسبق تغيير عبارة المرور)	لا	-
`--salvage`	تابع رغم الأجزاء المفقودة أو التالفة واترك خلاياها ثقوبًا (يتطلب --as)	لا	-
`--path <file-or-dir>`	استعد هذا الملف أو المجلد فقط من اللقطة دون استعادة المستودع كاملاً (يتطلب --at)	لا	-
`--to <dir>`	المجلد الذي يوضع فيه المسار المستعاد (الافتراضي: مجلد الاستعادة في الجهاز الخاص بهذه اللقطة)	لا	-
`--up`	نشر المستودع المُستعاد بعد النقل	لا	-
`--health-window <seconds>`	نافذة بوابة الصحة الإجمالية بالثواني (الافتراضي 300)	لا	-
`--health-timeout <seconds>`	مهلة فحص الصحة لكل محاولة بالثواني (الافتراضي 30)	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.6 retention

عرض سياسة الاحتفاظ باللقطات التي يفرضها الخادم.

clear

إزالة السياسة المعلنة، فتعود الخطة أو القيمة الافتراضية للخادم إلى السريان.

rdc backup retention clear <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--stream <id>`	ينطبق على مجرى النسخ الاحتياطي هذا فقط (معرّف مجرى)؛ وبدونه تسري القيمة الافتراضية للمستودع كله	لا	-

set

حدِّد عدد اللقطات المطلوب الاحتفاظ بها. يُستبدل كل معيار بالكامل، ولا يُدمَج.

rdc backup retention set <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--keep-last <n>`	الاحتفاظ بهذا العدد من أحدث اللقطات	لا	-
`--keep-hourly <n>`	الاحتفاظ بأحدث لقطة من كل عدد من الساعات	لا	-
`--keep-daily <n>`	الاحتفاظ بأحدث لقطة من كل عدد من الأيام	لا	-
`--keep-weekly <n>`	الاحتفاظ بأحدث لقطة من كل عدد من الأسابيع	لا	-
`--keep-monthly <n>`	الاحتفاظ بأحدث لقطة من كل عدد من الأشهر	لا	-
`--keep-yearly <n>`	الاحتفاظ بأحدث لقطة من كل عدد من السنوات	لا	-
`--keep-within <duration>`	الاحتفاظ بكل لقطة ضمن هذه المدة من أحدث لقطة، مثل 24h	لا	-
`--stream <id>`	ينطبق على مجرى النسخ الاحتياطي هذا فقط (معرّف مجرى)؛ وبدونه تسري القيمة الافتراضية للمستودع كله	لا	-

preview

يعرض اللقطات التي ستحذفها عملية التنظيف التالية والمساحة التي ستحررها.

rdc backup retention preview <repo-ref>

مرجع CLI: rdc backup retention preview

8.7 run

تشغيل نسخة احتياطية فورية على جهاز بعيد

rdc backup run [strategy] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.8 schedule

نشر جدول النسخ الاحتياطي إلى جهاز بعيد (مؤقتات systemd)

rdc backup schedule [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--dry-run`	معاينة الوحدات المُولَّدة دون نشرها	لا	-
`--force`	المتابعة حتى إن كانت هناك نسخة احتياطية قيد التشغيل (تنطبق الوحدة الجديدة عند النبضة التالية للمؤقت؛ يحتفظ التنفيذ الجاري بوحدته القديمة)	لا	-
`--reset-failed`	مسح حالة الفشل للخدمات المُعدَّلة بعد نشر ناجح (معطّل افتراضيًا، يحافظ على إشارة الفشل)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.9 snapshot

رفع لقطة إلى التخزين المجزّأ: المخزون الكامل أولاً، ثم الخلايا المتغيّرة

rdc backup snapshot <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--reseed`	عدم الوثوق بالمرساة المحلية وإعادة رفع المخزون كاملاً (يعيد رفع كل شيء ويُعيد احتساب الحصة)	لا	-
`--dry-run`	التخطيط فقط: بلا رفع. يُظهر ما كان سيتحرك	لا	-
`--cold`	أوقِف الحاويات ثم جمِّد ثم أعِد التشغيل ثم ارفع. يكلّف انقطاعًا قصيرًا فعليًا لكنه يعطي لقطة متسقة على مستوى التطبيق، ولا يمكن استخدامه مع ‎--dry-run	لا	-
`--accept-identity-change`	اعتمد هذه الصورة خط أساس جديدًا عندما تتغير هوية LUKS الخاصة بها أو تصغر؛ يرفع لقطة كاملة	لا	-
`--bwlimit <rate>`	حدّ سرعة الرفع: بايت في الثانية، أو وحدات عشرية (12.5M = ‏12.5 MB/s)، أو وحدات ثنائية (12Mi)، أو بتات (100Mbps). بدونه لا يوجد حدّ	لا	-
`--parallelism <n>`	عدد القطع التي تُرفع في آنٍ واحد (الافتراضي 4)	لا	-
`--read-bwlimit <rate>`	حدّ سرعة القراءة للتجزئة وقراءة الخلايا: بنفس وحدات --bwlimit؛ الافتراضي 50M، و0 = بلا حدّ	لا	-
`--hash-parallelism <n>`	عدد الخلايا التي تُجزَّأ في آنٍ واحد (الافتراضي 1؛ 0 = خلية لكل معالج، حتى 16)	لا	-
`--cpu-limit <percent>`	الحد الأقصى للمعالج لهذه اللقطة: نسبة مئوية من جميع الأنوية، من 1 إلى 100 (الافتراضي 50؛ 100 = بلا حد)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.10 status

عرض حالة النسخ الاحتياطي وحالة المؤقت على جهاز بعيد

rdc backup status [strategy] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.11 strategy

إدارة استراتيجيات النسخ الاحتياطي المسماة (أوضاع ساخنة/باردة، وجهات، جدولة)

set

إنشاء أو تحديث استراتيجية نسخ احتياطي

rdc backup strategy set <strategy> [options]

العلامة	الوصف	مطلوب	افتراضي
`--destination <name>`	اسم الوجهة ضمن الاستراتيجية. يُنشئ وجهة تخزين مجزأ من Rediacc	لا	-
`--target <storeId>`	معرّف المخزن المسجّل الذي تكتب إليه الوجهة (الافتراضي: home). يُستخدم مع --destination	لا	-
`--replicate-from <storeId>`	اجعل الوجهة نسخة مطابقة: يقوم خادم الحساب بنسخ هذا المخزن إلى هدف الوجهة، فلا يرفع الجهاز أي شيء إليه. يُستخدم مع --destination و --target	لا	-
`--cron <expression>`	جدول cron (مثلاً "0 * * * *" للتشغيل كل ساعة)	لا	-
`--mode <mode>`	وضع النسخ الاحتياطي: "hot" يلتقط اللقطة والنظام يعمل بالكامل، "cold" يوقف الحاويات للحظة التقاط اللقطة	لا	-
`--bwlimit <limit>`	حد عرض النطاق الترددي للرفع بالبايت في الثانية، مع لاحقة اختيارية K/M/G (مثلاً "6M"، "500K")	لا	-
`--read-bwlimit <limit>`	حدّ سرعة القراءة للقطات هذه الاستراتيجية: بنفس وحدات --bwlimit؛ none يزيله	لا	-
`--cpu-limit <percent>`	الحد الأقصى للمعالج للقطات هذه الاستراتيجية: نسبة مئوية من جميع الأنوية، من 1 إلى 100 (الافتراضي 50)؛ none يزيله	لا	-
`--include <repos>`	نسخ هذه المستودعات فقط (أسماء مفصولة بفواصل)	لا	-
`--exclude <repos>`	استبعاد هذه المستودعات من النسخ الاحتياطي (أسماء مفصولة بفواصل)	لا	-
`--retention <spec>`	الاحتفاظ باللقطات، مثل last=7,daily=7,weekly=4,monthly=6 (القيمة "none" تزيله)	لا	-
`--rpo <duration>`	هدف الحماية المعلن، مثل 15m (5m على الأقل؛ none يزيله)	لا	-
`--repo-rpo <ref=duration>`	هدف لكل مستودع بصيغة <ref>=<المدة>، قابل للتكرار (none يزيله)؛ name:* هو العائلة	لا	-
`--repo-cell-size <ref=size>`	حجم خلية لكل مستودع بصيغة <ref>=<الحجم>، قابل للتكرار. التغيير يعيد تهيئة المستودع	لا	-
`--no-estimate`	تخطي تقدير التغيّر والتكلفة	لا	-
`--dry-run`	عرض ما سيتغير دون كتابة أي شيء	لا	-
`--enable`	تفعيل الاستراتيجية أو الوجهة	لا	-
`--disable`	تعطيل الاستراتيجية أو الوجهة	لا	-

bind

ربط استراتيجية نسخ احتياطي بجهاز بحيث يُنشر جدولها عليه

rdc backup strategy bind <strategy> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-

unbind

فك ربط استراتيجية نسخ احتياطي من جهاز

rdc backup strategy unbind <strategy> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-

remove

إزالة استراتيجية نسخ احتياطي أو وجهة

rdc backup strategy remove <strategy> [options]

العلامة	الوصف	مطلوب	افتراضي
`--destination <name>`	إزالة هذه الوجهة فقط (الاحتفاظ بالوجهات الأخرى)	لا	-
`--unbind`	إسقاط الاستراتيجية أيضًا من كل جهاز يرتبط بها	لا	-

list

عرض قائمة جميع استراتيجيات النسخ الاحتياطي

rdc backup strategy list

مرجع CLI: rdc backup strategy list

show

عرض تفاصيل استراتيجية النسخ الاحتياطي

rdc backup strategy show [strategy]

مرجع CLI: rdc backup strategy show

8.12 reconcile

يعيد ضبط سجل البايتات المخزّنة لمستودع إلى ما يحتويه المخزن فعلاً (ولا يحذف أي مقطع أبداً)

rdc backup reconcile [repo-ref] [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	عرض الأرقام دون تعديل السجل	لا	-
`--check`	تشغيل تجريبي ينتهي بالرمز 1 عند اختلاف السجل عن المخزن	لا	-

8.13 usage

عرض حصة تخزين النسخ الاحتياطي والبايتات المخزَّنة والاستخدام لكل مستودع

rdc backup usage

مرجع CLI: rdc backup usage

8.14 verify

التحقق من مرساة النسخ الاحتياطي لمستودع مقابل التخزين المجزّأ

rdc backup verify <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--deep`	إعادة تجزئة كل خلية مسجَّلة (تحقق كامل) بدلاً من فحص عيّني	لا	-
`--store`	اطلب من الخادم إعادة تجزئة كل جزء مخزَّن لهذا المستودع وتسمية أي جزء مفقود أو تالف	لا	-
`--restore-test`	استعادة لقطة المرساة باسم مؤقت مباشرة من المخزن، ومقارنتها بالمرساة، وتسجيل النتيجة، وحذف النسخة	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.15 snapshots

إدارة اللقطات المخزّنة

delete

يحذف لقطة مخزّنة واحدة. تُحرَّر البيانات التي تستخدمها هذه اللقطة وحدها عند عملية جمع المهملات التالية.

rdc backup snapshots delete <repo-ref> <snapshot-id>

مرجع CLI: rdc backup snapshots delete

8.16 download

ينسخ صور المستودعات من جهاز إلى مجلد محلي أو إلى قرص خارجي. في كل تشغيل تُؤخذ لقطة جديدة لا تبقى إلا طوال الجلسة، وتُحدَّث النسخة المحلية في مكانها بفروقات rsync، ويُستأنف العمل بعد أي انقطاع، ويُتحقق من النتيجة عبر sha256.

rdc backup download [refs...] [options]

العلامة	الوصف	مطلوب	افتراضي
`--to <dir>`	مجلد موجود وقابل للكتابة يستقبل <machine>/<name>.<tag>.img (لا يُنشأ أبدًا)	نعم	-
`--all`	نسخ كل مستودعات grand الموجودة على الجهاز المحدد بالخيار -m	لا	-
`-m, --machine <name>`	اسم الآلة	لا	-
`--include-forks`	مع --all، انسخ التفرعات (forks) أيضًا	لا	-
`--bwlimit <rate>`	حد لعرض النطاق الترددي للشبكة مثل 100Mbps أو 12.5M (الافتراضي: بلا حد)	لا	-
`--checkpoint`	أخذ نقطة تفتيش وتجميد المستودع قبل اللقطة (نسخ احتياطي ساخن)	لا	-
`--retries <n>`	عدد إعادات المحاولة داخل التشغيل بعد فشل الشبكة (الافتراضي: 3)	لا	-
`--skip-verify`	تخطي مقارنة sha256 بعد rsync؛ يظل مجموع التحقق الخاص بـ rsync يعمل	لا	-
`--skip-space-check`	التحذير بدل الرفض عندما قد لا تتوفر مساحة حرة كافية في الوجهة	لا	-
`--store`	يعيد بناء الصورة المشفرة مباشرة من مخزن النسخ الاحتياطية دون أي جهاز. يتطلب رمز API بنطاق backup:read + backup:restore في REDIACC_TOKEN	لا	-
`—at <time	snapshot>`	مع --store: اللقطة المطلوب جلبها، وقت (ISO 8601) أو معرّف لقطة (الافتراضي: الأحدث)	لا
`--from <storeId>`	مع --store، اقرأ من مخزن النسخ الاحتياطية هذا بدل الأعلى ترتيبًا؛ ولا ينتقل أبدًا إلى مخزن آخر	لا	-

8.17 upload

يرسل صورة مستودع محلية، أنشأها 'rdc backup download'، إلى جهاز ويسجّلها كمستودع جديد. يُستأنف النقل بعد أي انقطاع، ويتحقق الجهاز من sha256 ومن ترويسة LUKS قبل وضع الصورة.

rdc backup upload <image-file> [options]

العلامة	الوصف	مطلوب	افتراضي
`--to <machine>`	الجهاز الذي يستقبل الصورة	نعم	-
`--as <name>`	اسم المستودع الجديد (الافتراضي: اسم المستودع المسجّل في الصورة)	لا	-
`--datastore <name>`	وضع الصورة في مخزن البيانات المسمّى هذا بدل المخزن الافتراضي للجهاز	لا	-
`--from-repo <name>`	مستودع في الإعداد يوفّر بيانات الاعتماد والنسب عند فقدان ملف الحالة أو إشارته إلى مستودع غير معروف	لا	-
`--bwlimit <rate>`	حد لعرض النطاق الترددي للشبكة مثل 100Mbps أو 12.5M (الافتراضي: بلا حد)	لا	-
`--retries <n>`	عدد إعادات المحاولة داخل التشغيل بعد فشل الشبكة (الافتراضي: 3)	لا	-
`--up`	تشغيل المستودع بعد تسجيله	لا	-
`--skip-verify`	تخطي مقارنة الصورة المحلية بقيمة sha256 المسجّلة عند تنزيلها	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.18 purge

يحذف كل لقطات النسخ الاحتياطي المخزّنة لمستودع من مخزن الأجزاء دفعة واحدة، مع الإبقاء على المستودع نفسه.

rdc backup purge <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-
`-y, --yes`	تخطي نافذة التأكيد	لا	-
`--cancel`	إلغاء مسح كامل مؤجَّل قبل أن يسري	لا	-

8.19 check

يثبت أن لقطة تُفتح بعبارة المرور عبر استعادة ملف واحد

rdc backup check <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--path <file>`	الملف المراد استعادته ومقارنته (الافتراضي: أصغر ملف غير فارغ)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.20 repair

إعادة رفع الأجزاء التي فقدها المخزن أو يحتفظ بها خطأً من مرساة هذا الجهاز

rdc backup repair <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	يعرض ما سيُحذف ويُعاد رفعه دون تغيير أي شيء	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.21 toc-key

إدارة مفتاح قائمة التصفح الخاص بمستودع

sync

تثبيت مفتاح قائمة المستودع على جهازه، أو استبدال مفتاح مختلف

rdc backup toc-key sync <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--replace`	استبدال مفتاح مختلف موجود على الجهاز (يرسل عبارة المرور كإثبات)	لا	-
`--dry-run`	يعرض ما سيُنفَّذ دون لمس أي شيء	لا	-

8.22 churn

يقيس مقدار تغيّر صورة المستودع بين التشغيلات، ويتنبأ بحجم الرفع لكل حجم خلية ويوصي بأحدها. تُحفظ قاعدة reflink على الجهاز أثناء التشغيل وتُزال دائمًا عند الانتهاء.

rdc backup churn <repo-ref> [options]

العلامة	الوصف	مطلوب	افتراضي
`--samples <n>`	عدد العينات المقاسة (الافتراضي 3)	لا	-
`--interval <duration>`	الانتظار بين الفحوصات، مثل 10m (الافتراضي 10m)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

8.23 immutability

عرض أو ضبط نافذة الحذف المؤجَّل للنسخ الاحتياطية المخزنة

show

عرض نافذة الحذف المؤجَّل السارية

rdc backup immutability show

مرجع CLI: rdc backup immutability show

set

ضبط نافذة الحذف المؤجَّل بالأيام (من 0 إلى 30)

rdc backup immutability set <days>

مرجع CLI: rdc backup immutability set

8.24 undelete

إلغاء الحذف المؤجَّل للقطة قبل أن يسري

rdc backup undelete <snapshot-id>

مرجع CLI: rdc backup undelete

9. تكامل VS Code

فتح VS Code Remote SSH للاتصال بجهاز أو مستودع

9.1 connect

فتح VS Code على جهاز أو داخل مستودع.

rdc vscode connect <target> [options]

العلامة	الوصف	مطلوب	افتراضي
`-f, --folder <path>`	مسار المجلد البعيد للفتح	لا	-
`--url-only`	طباعة عنوان VS Code URI بدلاً من تشغيله	لا	-
`-n, --new-window`	الفتح في نافذة VS Code جديدة	لا	-
`--skip-env-setup`	تخطي إعداد البيئة البعيدة	لا	-
`--insiders`	استخدام إعدادات VS Code Insiders	لا	-
`--browser`	تشغيل VS Code المتصفح من داخل بيئة المستودع المعزولة (لا يلزم VS Code محلياً)	لا	-
`--no-open`	طباعة عنوان URL دون فتح المتصفح المحلي	لا	-
`--local <port>`	المنفذ المحلي (الافتراضي نفس المنفذ البعيد)	لا	-
`--server-provider <id>`	تطبيق خادم VS Code المتصفح (openvscode, code-server)	لا	-
`--server-archive <file>`	مسار أرشيف الخادم المُعدّ مسبقاً على الجهاز (للتثبيت بدون إنترنت)	لا	-

9.2 list

قائمة اتصالات VS Code SSH المكونة

rdc vscode list

مرجع CLI: rdc vscode list

9.3 cleanup

إزالة إعدادات VS Code SSH

rdc vscode cleanup [options]

العلامة	الوصف	مطلوب	افتراضي
`--all`	إزالة جميع إعدادات SSH الخاصة بـ rediacc	لا	-
`-c, --connection <name>`	إزالة اتصال معين	لا	-

9.4 check

التحقق من تثبيت VS Code والإعدادات

rdc vscode check [options]

العلامة	الوصف	مطلوب	افتراضي
`--insiders`	استخدام إعدادات VS Code Insiders	لا	-

9.5 serve

إدارة خادم VS Code المتصفح داخل بيئة المستودع

status

عرض ما إذا كان خادم VS Code المتصفح يعمل

rdc vscode serve status <target> [options]

العلامة	الوصف	مطلوب	افتراضي
`--server-provider <id>`	تطبيق خادم VS Code المتصفح (openvscode, code-server)	لا	-

stop

إيقاف خادم VS Code المتصفح

rdc vscode serve stop <target> [options]

العلامة	الوصف	مطلوب	افتراضي
`--server-provider <id>`	تطبيق خادم VS Code المتصفح (openvscode, code-server)	لا	-

10. وصول طرفية SSH

فتح طرفية SSH إلى جهاز أو مستودع. الهدف اسم جهاز أو مرجع مستودع، ويُعَدّ سياق المستودع (DOCKER_HOST، دليل العمل، البيئة) تلقائيًا. استخدم `-c` لتشغيل أمر واحد بشكل غير تفاعلي. لسجلات الحاويات أو أمر لمرة واحدة داخل حاوية، استخدم `repo logs` و`repo exec`. لـ VS Code، استخدم `vscode`.

10.1 connect

فتح صدفة على جهاز، أو داخل مستودع مع إعداد Docker الخاص به.

rdc term connect <target> [options]

العلامة	الوصف	مطلوب	افتراضي
`-c, --command <cmd>`	تنفيذ أمر بدلاً من الصدفة التفاعلية	لا	-
`--external`	فرض تشغيل في نافذة طرفية خارجية	لا	-
`--reset-home`	إعادة تعيين طبقة المنزل لكل مستودع للبدء من جديد	لا	-

11. أوامر سريعة (اختصارات)

11.1 run

تحذير: أمر منخفض المستوى مخصص للتصحيح والتجربة فقط، وليس للاستخدام في بيئة الإنتاج. للاستخدام المعتاد توجد أوامر أعلى مستوى (repo up وrepo down وغيرها). يشغّل دالة renet خامًا على جهاز.

rdc run

11.2 trace

تتبع مهمة (اختصار لـ: queue trace)

rdc trace

11.3 cancel

إلغاء مهمة (اختصار لـ: queue cancel)

rdc cancel

11.4 retry

إعادة محاولة مهمة فاشلة (اختصار لـ: queue retry)

rdc retry

12. إدارة الاشتراكات

إدارة التراخيص ورموز الاشتراك. سجّل الدخول بـ login، وافحص الحالة بـ status، وأعد إصدار التراخيص بـ refresh.

المصادقة باستخدام رمز API من بوابة الويب

rdc subscription login [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --token <token>`	رمز API (rdt_...). مرر `-` لقراءته من stdin (يبقيه خارج قائمة العمليات).	لا	-
`--password-stdin`	تسجيل الدخول بدون متصفح بكلمة مرور الحساب المقروءة من stdin (يلزم REDIACC_LOGIN_EMAIL)	لا	-
`--server <url>`	عنوان خادم الحساب	لا	-

12.2 logout

مسح رمز الاشتراك المحفوظ

rdc subscription logout

مرجع CLI: rdc subscription logout

12.3 proxy-token

إصدار رمز proxy:exec قصير الأجل من تسجيل دخول هذا الجهاز لاستخدامه مع --proxy

rdc subscription proxy-token [options]

العلامة	الوصف	مطلوب	افتراضي
`--json`	طباعة JSON يتضمن الرمز وقيمة expiresAt الخاصة به	لا	-

12.4 status

عرض الاشتراك، وحالة الترخيص لجهاز.

rdc subscription status [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	لا	-

12.5 refresh

تحديث التراخيص من خادم الحساب.

rdc subscription refresh [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	لا	-
`--repo <ref>`	مرجع المستودع: اسم، أو اسم:وسم، اختياريًا مع @machine (مثال shop أو shop:test)	لا	-

13. تحديثات سطر الأوامر

التحقق من تحديثات CLI وتطبيقها

rdc update [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	فرض التحديث حتى لو كان محدثاً	لا	-
`--check-only`	التحقق من التحديثات فقط دون التنزيل	لا	-
`--rollback`	التراجع إلى الإصدار السابق	لا	-
`--status`	عرض حالة التحديث التلقائي والتشخيصات	لا	-
`--channel <channel>`	تعيين قناة الإصدار (stable أو edge)	لا	-

14. إسنادات الأطراف الثالثة

طباعة مكونات الأطراف الثالثة المرفقة مع rdc: الملفات التنفيذية التي يضمّنها renet وينقلها (CRIU وrsync)، وبيئة تشغيل Node.js المضمّنة، وتبعيات npm المرفقة. يعرض الإصدارات ومعرّفات ترخيص SPDX وعناوين URL لأرشيف المصدر بالإصدار الدقيق المطلوبة للامتثال لـ GPL. استخدم --licenses لطباعة نص THIRD_PARTY_LICENSES الكامل المرفق مع إصدارات الإطلاق.

rdc credits [options]

العلامة	الوصف	مطلوب	افتراضي
`--licenses`	طباعة نص THIRD_PARTY_LICENSES الكامل المرفق مع إصدارات الإطلاق	لا	-

15. تشخيص النظام

تشخيص بيئة CLI وتكامل renet

rdc doctor

مرجع CLI: rdc doctor

16. الأدوات المحلية

يدير الأدوات المحلية التي يشغّلها rdc على هذا الجهاز. يقوم `rdc tools install tofu` بتنزيل إصدار OpenTofu المحدد، ويطابق قيمة SHA-256 الخاصة به مع المجموع الاختباري المضمّن في rdc قبل فك الضغط، ثم يضع الملف التنفيذي في مجلد أدوات rdc. ويعرض `rdc tools list` كل أداة مع إصدارها ومكان العثور عليها.

16.1 install

ينزّل إصدار OpenTofu المحدد في أداة CLI هذه، ويتحقق من مجموعه الاختباري SHA-256، ثم يثبّته في مجلد أدوات rdc. إذا لم يتطابق المجموع الاختباري يُحذف الملف المنزَّل ولا يُثبَّت أي شيء. لا يثبّت rdc أداة Terraform أبدًا، وإن كانت موجودة في PATH فتُستخدم كما هي.

rdc tools install <tool> [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	إعادة التثبيت حتى لو كان الإصدار المحدد موجودًا	لا	-

16.2 list

يعرض محرك التجهيز الذي سيشغّله rdc (OpenTofu أو Terraform) وكل إصدار من OpenTofu في مجلد أدوات rdc، مع الإصدار والمصدر والمسار.

rdc tools list

مرجع CLI: rdc tools list

17. عمليات VM محلية

تجهيز وإدارة أجهزة افتراضية محلية باستخدام KVM/QEMU/Hyper-V (يُكتشف النظام الأساسي تلقائيًا). ليست للأجهزة البعيدة. استخدم `machine` لتلك. الأوامر الفرعية الرئيسية: up (تشغيل الأجهزة الافتراضية)، down (إيقافها)، status (سرد الأجهزة الافتراضية العاملة)، ssh (الاتصال بجهاز افتراضي)، setup (تثبيت المتطلبات)، check (التحقق من جاهزية المضيف).

17.1 up

إنشاء مجموعة VM محلياً

rdc ops up [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	فرض إعادة تشغيل جميع الآلات الافتراضية	لا	-
`--parallel`	إنشاء الآلات الافتراضية بالتوازي	لا	-
`--basic`	مجموعة بسيطة (جسر + عامل واحد)	لا	-
`--lite`	تخطي توفير VM (الحالة فقط)	لا	-
`--skip-orchestration`	تخطي تنسيق المجموعة	لا	-
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-
`--os <name>`	نظام تشغيل VM (مثلاً، ubuntu-24.04، debian-12)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

17.2 down

تدمير مجموعة VM

rdc ops down [options]

العلامة	الوصف	مطلوب	افتراضي
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

17.3 status

عرض حالة مجموعة VM

rdc ops status [options]

العلامة	الوصف	مطلوب	افتراضي
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-

17.4 ssh

الاتصال بـ VM عبر SSH

rdc ops ssh [options]

العلامة	الوصف	مطلوب	افتراضي
`--vm-id <id>`	معرّف الآلة الافتراضية	نعم	-
`-c, --command <cmd>`	تنفيذ أمر بدلاً من الصدفة التفاعلية	لا	-
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-
`--user <user>`	اسم مستخدم SSH للاتصال بالآلة الافتراضية	لا	-

17.5 setup

تثبيت متطلبات المحاكاة الافتراضية

rdc ops setup [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

17.6 check

التحقق من متطلبات المحاكاة الافتراضية

rdc ops check

مرجع CLI: rdc ops check

18. خدمة المُنفِّذ

شغّل هذه العملية كمنفّذ حتى يتمكن العملاء من تنفيذ الأوامر من خلاله بدلاً من الاتصال بأنفسهم عبر SSH

rdc serve [options]

العلامة	الوصف	مطلوب	افتراضي
`-p, --port <port>`	المنفذ الذي يتم الاستماع عليه	لا	`8080`
`--host <host>`	العنوان الذي يتم الربط به	لا	`0.0.0.0`
`--mode <mode>`	الموضع: daemon (مضيف العميل) أو container	لا	`daemon`

رسائل الخطأ الشائعة

عندما يحدث خطأ ما، يوفر سطر الأوامر رسائل خطأ واضحة:

الخطأ	المعنى
المصادقة مطلوبة. قم بتشغيل: rdc subscription login	تحتاج إلى تسجيل الدخول أولاً
لا توجد إعدادات نشطة. أنشئ واحدة باستخدام: rdc config init <name>	لا توجد إعدادات نشطة. أنشئ واحدة باستخدام `rdc config init`
تم رفض الإذن	حسابك لا يملك الصلاحيات المطلوبة
اسم الآلة مطلوب. استخدم --machine <name>	حدد جهازاً باستخدام `--machine` أو عيّن قيمة افتراضية للسياق
اسم المنطقة مطلوب. استخدم --region أو عيّن القيمة الافتراضية بـ: rdc config set region <name>	حدد منطقة باستخدام `--region` أو عيّن قيمة افتراضية للسياق

تنسيقات الإخراج

تدعم جميع أوامر القائمة/الحصول تنسيقات إخراج متعددة عبر `--output`:

rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table   # default

مرجع CLI: rdc machine list

هذا يسهّل دمج سطر أوامر Rediacc في البرامج النصية وخطوط أنابيب CI/CD وسير عمل الأتمتة.