أوامر ERPC CLI
كل مجموعات أوامر ERPC CLI في جدول واحد، والخيارات التي تعمل مع كل أمر، ورموز الخروج التي يمكن للسكربت الاعتماد عليها.
تصف هذه الصفحة ERPC CLI
v0.1.0-rc.4، وهو إصدار تمهيدي.مجموعات الأوامر
شغّل أي مجموعة أوامر دون أمر فرعي، مثل
erpc validator أو erpc worker، لسرد أوامرها الفرعية.الخيارات العامة
--jsonيعطي مخرجات قابلة للقراءة آليًا:erpc --json <command>. وللمتغيرERPC_JSON=trueالتأثير نفسه. في أوامر العُقد، يجب أن يأتي--jsonقبل الأمر.--langيحدد اللغة التي يتحدث بها erpc:enأوjaأوzhأوru. وبدونه يستخدم erpc الإعدادlocale، وإلا فلغة النظام.
الأخطاء ورموز الخروج
يبدو الفشل بالشكل نفسه في كل مكان: سطر
error: يذكر ما الذي حدث من خطأ، وسطر hint: يذكر ما يجب فعله بعد ذلك، إن وُجد. مع --json، يكون الفشل كائنًا واحدًا على المخرج القياسي، {"error": {"code", "exit", "message", "hint"}}. وفي حالتين تُطبع رسالة clap الخاصة به بدلًا من ذلك ويكون الخروج بالرمز 2: سطر أوامر لا يستطيع clap تحليله في الطرفية، ووسيطة لا يقبلها الأمر الفرعي في شجرة أوامر العُقد (erpc validator وrpc وnode)، حتى مع --json. ولا يظهر الحقل details إلا عندما يكون لدى الأمر ما يضيفه للسكربت عمّا فعله قبل أن يفشل، ولا يظهر أبدًا في الطرفية.عند إيقافه بـ Ctrl-C (أو SIGTERM أو SIGHUP)، ينتهي erpc بالإشارة نفسها، فتتوقف أيضًا أي حلقة في السكربت. ويحتفظ الرمز المنشور باسمه وبرمز الخروج الخاص به، ولا يُعاد استخدام أي رمز أبدًا.
التخزين والنسخ الاحتياطية
bash
يشتري
erpc storage buy خطة ERPC Global Storage، ويُدفع ثمنها من ERPC Credit. تجد الخطط والأسعار في صفحة الأسعار.erpc storage
- يشفّر
erpc storage putالملف على هذا الجهاز قبل إرسال أي جزء منه، ما لم يُمرَّر--no-encrypt. لا يخزّن ERPC سوى البايتات المشفرة، ولا يحتفظ بالمفتاح أبدًا. ويتعرّفerpc storage getعلى الملف المشفر ويفك تشفيره. - يوجد مفتاح تخزين واحد لكل حساب، ويُحفظ في مكان الحفظ الذي اختاره
erpc login. لا يحتفظ به erpc في حلقة مفاتيح نواة Linux، التي تُفقد عند إعادة تشغيل الجهاز: سجّل الدخول باستخدام--store 1passwordأو--store file، أو استخدم--no-encrypt. ومع مكان الحفظfile، يوجد المفتاح في~/.erpc/storage-key(الوضع 0600) غير مشفّر. ويرفع--no-encryptالملفَّ الذي ترسله كما هو، دون تشفير. - فقدان مفتاح التخزين يعني فقدان كل ملف شُفِّر به، ولا يستطيع ERPC استعادته. يطبع
erpc storage key export --showالمفتاح حتى يمكن الاحتفاظ بنسخة منه بعيدًا عن الجهاز، ويعيدهerpc storage key importعلى جهاز آخر. - المسار الذي يُخزَّن تحته الملف، وحجمه، مرئيان لـ ERPC.
- يعرض
erpc storage keys listمفاتيح الوصول إلى التخزين، ويُبطلerpc storage keys revoke <n>واحدًا منها.
erpc backup
ينسخ
erpc backup الجهاز احتياطيًا إلى ERPC Global Storage باستخدام restic. تُشفَّر الملفات على جهازك قبل أن تغادره، ولا يحتفظ ERPC أبدًا بكلمة مرور تفتح النسخ الاحتياطية.- يحصل كل جهاز على مفتاح للإلحاق فقط لا يستطيع حذف نسخه الاحتياطية. أما الجهاز الذي شغّلت عليه
erpc backup initفيحتفظ أيضًا بالمفاتيح التي تستطيع ذلك، لذا لا تصمد هذه الحماية إلا على جهاز لا يحتفظ بجلسة erpc ولا بأسرار النسخ الاحتياطي الخاصة بالحساب. - احتفظ بنسخة من
erpc backup password --showبعيدًا عن الأجهزة. فقدان كلمة المرور الرئيسية وملفاتbackup.envلجميع الأجهزة يعني فقدان النسخ الاحتياطية. - يستبعد النسخ الاحتياطي ملفات المفاتيح المعروفة وأسرار النظام، مثل
.ssh/id_*و.config/solana/id.jsonوجلسة erpc ومفاتيح مضيف SSH. أما مادة المفاتيح التي تحمل اسمًا آخر أو توجد في مكان آخر فتُنسخ احتياطيًا مثل أي ملف آخر: استبعدها باستخدام--exclude. - يثبّت erpc الإصدار 0.19.1 من restic، ويتحقق من الأرشيف ومن البرنامج كليهما مقابل ملخصات SHA-256 المضمَّنة في erpc عند بنائه.
- الجدولة: على Linux، شغّل
sudo erpc backup init، ثمsudo erpc backup schedule daily. وعلى macOS،erpc backup schedule daily ~/Documents؛ وتعمل المهمة باسمك، ما دمت مسجّل الدخول. - تذهب النسخ الاحتياطية إلى المنطقة الافتراضية للحساب. يعمل
erpc backupعلى الجهاز الذي ينسخه احتياطيًا؛ أما خادم الـ worker فيُعدّ باستخدامerpc worker backup onبدلًا من ذلك (النسخ الاحتياطي لبيانات حالة التطبيق).