كيفية إعداد جهاز باستخدام Rediacc

يبدأ كل نشر Rediacc بملف تعريف تكوين وجهاز مسجل. في هذا الدرس التعليمي، ستقوم بإنشاء تكوين، وتسجيل خادم بعيد، والتحقق من اتصال SSH، وتشغيل تشخيصات البيئة، وتكوين شبكة البنية التحتية. عند الانتهاء، سيكون جهازك جاهزاً لنشر المستودعات.

المتطلبات الأساسية

• تثبيت أداة rdc CLI
• خادم بعيد (أو جهاز افتراضي محلي) يمكن الوصول إليه عبر SSH
• مفتاح SSH خاص يمكنه المصادقة على الخادم

التسجيل التفاعلي

الخطوة 1: إنشاء تكوين جديد

يخزّن ملف تعريف التكوين تعريفات الأجهزة وبيانات اعتماد SSH وإعدادات البنية التحتية. أنشئ واحداً لهذه البيئة.

rdc config init --name tutorial-demo --ssh-key ~/.ssh/id_ed25519

ينشئ هذا ملف تكوين مسمى في ~/.config/rediacc/tutorial-demo.json.

الخطوة 2: عرض التكوينات

تحقق من ظهور الملف التعريفي الجديد في قائمة التكوينات.

rdc config list

يعرض جميع التكوينات المتاحة مع نوع المحول (محلي أو سحابي) وعدد الأجهزة.

الخطوة 3: إضافة جهاز

سجّل جهازاً بعنوان IP الخاص به ومستخدم SSH. يقوم CLI تلقائياً بجلب وتخزين مفاتيح المضيف للخادم عبر ssh-keyscan.

rdc config machine add --name bridge-vm --ip 192.168.111.1 --user muhammed --config tutorial-demo

الخطوة 4: عرض الأجهزة

تأكد من تسجيل الجهاز بشكل صحيح.

rdc config machine list --config tutorial-demo

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

الخطوة 5: تعيين الجهاز الافتراضي

تعيين جهاز افتراضي يغنيك عن تكرار -m bridge-vm في كل أمر.

rdc config set --key machine --value bridge-vm --config tutorial-demo

الخطوة 6: اختبار الاتصال

قبل نشر أي شيء، تحقق من إمكانية الوصول إلى الجهاز عبر SSH.

rdc term connect -m bridge-vm -c "hostname"
rdc term connect -m bridge-vm -c "uptime"

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

الخطوة 7: تشغيل التشخيصات

rdc doctor

يفحص بيئتك المحلية: إصدار CLI، وDocker، وملف renet الثنائي، وحالة التكوين، ومفتاح SSH، ومتطلبات المحاكاة الافتراضية. يُبلغ كل فحص عن OK أو Warning أو Error.

الخطوة 8: تكوين البنية التحتية

للخدمات العامة، يحتاج الجهاز إلى تكوين الشبكة, عنوان IP الخارجي، ونطاق أساسي، وبريد إلكتروني للشهادة لـ TLS.

rdc config infra set -m bridge-vm \
  --public-ipv4 192.168.111.1 \
  --base-domain test.local \
  --cert-email admin@test.local

تحقق من التكوين:

rdc config infra show -m bridge-vm

انشر تكوين وكيل Traefik المُنشأ إلى الخادم باستخدام rdc config infra push bridge-vm.

استكشاف الأخطاء وإصلاحها

“SSH key not found” أو “Permission denied (publickey)” تحقق من وجود مسار المفتاح الذي تم تمريره إلى config init ومطابقته لـ authorized_keys على الخادم. تحقق من الأذونات: يجب أن يكون ملف المفتاح الخاص 600 (chmod 600 ~/.ssh/id_ed25519).

“Connection refused” عند أوامر SSH تأكد من تشغيل الخادم وصحة عنوان IP. تحقق من أن المنفذ 22 مفتوح: nc -zv <ip> 22. إذا كنت تستخدم منفذاً غير قياسي، مرّر --port عند إضافة الجهاز.

“Host key verification failed” المفتاح المخزن لا يتطابق مع مفتاح الخادم الحالي. يحدث هذا بعد إعادة بناء الخادم أو إعادة تعيين عنوان IP. شغّل rdc config machine scan-keys <machine> لتحديث المفتاح.

الخطوات التالية

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

• إعداد الجهاز, المرجع الكامل لجميع أوامر التكوين والإعداد
• درس تعليمي: دورة حياة المستودع, إنشاء المستودعات ونشرها وإدارتها
• البدء السريع, نشر تطبيق محتوى من البداية إلى النهاية