ورقة مرجعية لـ RDC CLI
لا تتضمن هذه الورقة جميع أوامر rdc، فقط تلك التي تستخدم في كل نشر. للحصول على مجموعة الخيارات الكاملة، شغّل أي أمر مع --help. الحالات الخاصة والخيارات النادرة موجودة في المرجع الكامل.
دورة حياة المستودع
| الأمر | الوصف |
|---|---|
rdc repo create <repo> -m <machine> | إنشاء مستودع جديد على جهاز |
rdc repo up <repo>@<machine> | نشر مستودع أو تحديثه |
rdc repo down <repo>@<machine> | إيقاف مستودع |
rdc repo delete <repo>@<machine> | حذف مستودع |
rdc repo fork <repo>@<machine> --tag <tag> | تفريع مستودع (شبه فوري، باستخدام BTRFS reflink) |
rdc repo promote <repo>:<tag> | ترقية فرع تم التحقق منه إلى مستودع الإنتاج باسم المستودع الأصل |
rdc repo list | عرض جميع المستودعات باسمها ومعرف GUID |
rdc repo resize <repo> --size <size> | تغيير حجم وحدة تخزين مستودع متوقف |
rdc repo expand <repo> --size <size> | توسيع وحدة تخزين مستودع قيد التشغيل أثناء العمل |
أسرار المستودع
بيانات اعتماد وقت النشر (كتابة فقط). يعيد get الملخص فقط. لا تُرجع القيمة أبداً. راجع المستودعات § الأسرار للدليل الكامل.
| الأمر | الوصف |
|---|---|
rdc repo secret set <repo> --key <KEY> --value <val> [--mode env|file] --current "" | إنشاء سر جديد (--current "" للكتابة الأولى) |
rdc repo secret set <repo> --key <KEY> --value <val> --current <prev> | الكتابة فوق سر موجود (شرط على نمط كلمة المرور) |
rdc repo secret set <repo> --key <KEY> --value <val> --rotate-secret | الكتابة فوق دون التحقق من القيمة السابقة (مسجلة كدوران) |
rdc repo secret list <repo> | عرض أسماء الأسرار ووسائط التسليم (بدون قيم أبداً، بدون ملخصات) |
rdc repo secret get <repo> --key <KEY> | عرض ملخص السر والوضع (بدون قيمة نصية عادية أبداً) |
rdc repo secret unset <repo> --key <KEY> --current <prev> | حذف سر |
rdc repo secret unset <repo> --key <KEY> --rotate-secret | حذف دون التحقق من القيمة السابقة |
التفريعات لا ترث أي أسرار. اضبطها على التفرع بشكل صريح مع
rdc repo secret set <repo>:<tag>.
النسخ الاحتياطي والاستعادة
| الأمر | الوصف |
|---|---|
rdc repo push ... --bwlimit <limit> | تحديد عرض نطاق rsync أثناء الرفع (مثال: 10M) |
rdc repo pull ... --bwlimit <limit> | تحديد عرض نطاق rsync أثناء السحب |
rdc repo push ... --checkpoint | عمل نقطة تحقق للحاويات قبل الرفع |
rdc backup manifests <repo-ref> | عرض اللقطات التي يحتفظ بها التخزين المجزّأ |
rdc backup browse <repo-ref> | عرض الملفات التي يحتويها مستودع (محلي، للقراءة فقط) |
rdc backup snapshot <repo> | رفع لقطة تخزين مجزّأ: المخزون الكامل أولاً، ثم الخلايا المتغيّرة لاحقاً |
rdc backup snapshot <repo> --dry-run | تخطيط اللقطة دون رفع؛ يُظهر ما كان سيتحرك |
rdc backup verify <repo> | التحقق من مرساة النسخ الاحتياطي لمستودع مقابل التخزين المجزّأ |
rdc backup usage | عرض البايتات المخزَّنة في التخزين المجزّأ مقابل حصتك |
rdc backup restore <repo> --as <name> --at <snapshot-id> -m <machine> --up | استعادة لقطة من التخزين المجزّأ باسم جديد |
rdc backup retention <repo> | عرض سياسة الاحتفاظ التي يفرضها الخادم على سلسلة مستودع |
rdc backup retention preview <repo> | عرض ما سيحذفه المرور التالي والمساحة التي سيحررها |
rdc backup retention set <repo> --keep-daily 7 [--stream <id>] | إعلان الاحتفاظ لسلسلة أو لمسار نسخ احتياطي واحد |
rdc backup retention clear <repo> [--stream <id>] | إزالة السياسة؛ تُحفظ كل لقطة |
rdc backup snapshots delete <repo> <snapshot-id> | حذف لقطة واحدة؛ يحرر GC التالي بياناتها الخاصة بها |
نقل المستودعات
| الأمر | الوصف |
|---|---|
rdc repo migrate <repo>@<machine> --to <machine> | نقل مستودع بين جهازين |
rdc repo migrate ... --provision | تجهيز الجهاز الهدف قبل النقل |
rdc repo migrate ... --checkpoint | عمل نقطة تحقق قبل النقل |
rdc repo migrate ... --skip-dns | تخطي تحديث DNS بعد النقل |
rdc repo migrate ... --bwlimit <limit> | تحديد عرض نطاق النقل |
استراتيجيات النسخ الاحتياطي
| الأمر | الوصف |
|---|---|
rdc backup strategy set <name> --destination <name> --cron <expr> --mode <hot|cold> --enable | إنشاء أو تحديث استراتيجية نسخ احتياطي مسماة |
rdc backup strategy list | عرض جميع استراتيجيات النسخ الاحتياطي المحددة |
rdc backup strategy show <name> | عرض تفاصيل استراتيجية |
rdc backup strategy remove <name> | حذف استراتيجية |
rdc backup schedule -m <machine> | نشر استراتيجيات النسخ الاحتياطي المُكوَّنة على جهاز |
عمليات النسخ الاحتياطي
| الأمر | الوصف |
|---|---|
rdc backup schedule -m <machine> | نشر الاستراتيجيات المرتبطة كمؤقتات systemd |
rdc backup schedule -m <machine> --dry-run | معاينة وحدات المؤقت دون نشر (الرموز مخفية) |
rdc backup run -m <machine> | تشغيل جميع الاستراتيجيات المرتبطة فوراً |
rdc backup run <name> -m <machine> | تشغيل استراتيجية محددة فوراً |
rdc backup status -m <machine> | عرض حالة المؤقتات ونتائج المهام الأخيرة |
rdc backup status <name> -m <machine> | عرض حالة استراتيجية محددة |
rdc backup cancel -m <machine> | إلغاء النسخ الاحتياطية الجارية |
rdc backup cancel <name> -m <machine> | إلغاء نسخة احتياطية جارية محددة |
إدارة الأجهزة
| الأمر | الوصف |
|---|---|
rdc machine status <machine> | الحالة الكاملة للجهاز (النظام، الحاويات، الخدمات، المستودعات، الشبكة) |
rdc machine status <machine> --system | معلومات النظام فقط |
rdc machine status <machine> --containers | قائمة الحاويات فقط |
rdc machine status <machine> --repositories | قائمة المستودعات فقط |
rdc machine status <machine> --services | قائمة الخدمات فقط |
rdc machine status <machine> --network | معلومات الشبكة فقط |
rdc machine status <machine> --block-devices | معلومات أجهزة التخزين فقط |
rdc machine list | عرض جميع الأجهزة في الإعدادات |
rdc machine setup <machine> | تشغيل التجهيز الأولي للجهاز |
rdc machine health <machine> | فحص صحة جهاز |
rdc machine scan-keys <machine> | تحديث مفاتيح مضيف SSH بعد إعادة البناء |
rdc machine prune <machine> | إزالة الموارد غير المستخدمة من الجهاز |
rdc machine deprovision <machine> | إلغاء تجهيز الجهاز بالكامل |
الطرفية والمزامنة
| الأمر | الوصف |
|---|---|
rdc term connect <machine> | فتح طرفية SSH للجهاز |
rdc term connect <repo>@<machine> | فتح طرفية SSH للمستودع (تعيين DOCKER_HOST) |
rdc term connect <machine> -c "<command>" | تشغيل أمر على الجهاز |
rdc repo sync upload <repo>@<machine> --local <paths...> | رفع ملف أو مجلد أو عدة مصادر إلى المستودع |
rdc repo sync upload <repo>@<machine> --local <file> --remote-file <path> | رفع ملف محلي واحد إلى مسار بعيد محدد |
rdc repo sync download <repo>@<machine> --local <dir> | تنزيل مجلد المستودع محلياً |
rdc repo sync download <repo>@<machine> --remote-file <path> --local <dir> | تنزيل ملف واحد من المستودع إلى مجلد محلي |
rdc vscode connect <repo>@<machine> | فتح جلسة VS Code Remote SSH |
rdc vscode list | عرض إعدادات SSH التي أنشأها vscode connect |
rdc vscode cleanup --all | إزالة كل إعدادات SSH التي كتبها vscode connect |
rdc repo tunnel <repo> -c <container> --port <port> | توجيه منفذ حاوية عبر SSH |
الإعدادات
| الأمر | الوصف |
|---|---|
rdc config init <name> | إنشاء ملف إعدادات مسمى |
rdc config list | عرض جميع الإعدادات على هذا الجهاز |
rdc config set machine <alias> | توجيه اسم مستعار إلى جهاز مختلف |
rdc machine add <machine> --ip <host> --user <user> | إضافة جهاز إلى الإعدادات |
rdc backup strategy set ... | تحديد استراتيجية نسخ احتياطي مسماة |
rdc --config <name> <command> | استخدام ملف إعدادات مسمى |
الملاحظات
| الأمر | الوصف |
|---|---|
rdc feedback report --last | معاينة تقرير مبني من أحدث أمر فاشل؛ أضف --yes للإرسال |
rdc feedback report --command <n> | الإبلاغ عن أمر مسجّل (1 هو الأحدث) |
rdc feedback report --list-recent | سرد الأوامر المسجّلة ثم الخروج |
rdc feedback report --message <text> [--kind bug|feedback|docs] | الإبلاغ عن ملاحظة بدون أمر فاشل |
rdc feedback list [--status <list>] | سرد التقارير مع المعرّف والبصمة والحالة والتواريخ؛ ويظهر التقرير المُصلَح بالصيغة fixed-in-v<version> |
rdc feedback show <id> | عرض تقرير واحد بالمعرّف أو ببادئة فريدة |
التشخيص والوصول المباشر
| الأمر | الوصف |
|---|---|
rdc repo logs <repo>@<machine> -c <container> --lines 200 --follow | بث سجلات الحاوية (مفضّل) |
rdc repo exec <repo>@<machine> -c <container> -- <command> | تشغيل أمر داخل حاوية (مفضّل) |
rdc repo exec <repo>@<machine> -c <container> -i -- bash | فتح واجهة تفاعلية داخل الحاوية |
rdc term connect <repo>@<machine> -c "docker ps" | عرض الحاويات في مستودع |
rdc term connect <repo>@<machine> -c "docker logs <name>" | جلب سجلات الحاوية |
rdc term connect <repo>@<machine> -c "docker exec <name> <cmd>" | تنفيذ أمر داخل حاوية |
rdc term connect <repo>@<machine> -c "docker restart <name>" | إعادة تشغيل حاوية |