# كيفية استخدام أدوات الطرفية والمزامنة وVS Code مع Rediacc

يتضمن CLI أدوات إنتاجية للعمليات اليومية: الوصول إلى الطرفية عبر SSH، ومزامنة الملفات عبر rsync، والتطوير عن بُعد باستخدام VS Code، وتحديثات CLI. في هذا الدرس، ستقوم بتشغيل أوامر عن بُعد، ومزامنة الملفات إلى مستودع، والتحقق من تكامل VS Code، والتحقق من إصدار CLI الخاص بك.

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

- تثبيت `rdc` CLI مع تهيئة الإعدادات
- جهاز مُجهّز مع مستودع قيد التشغيل (انظر [درس: دورة حياة المستودع](/ar/docs/tutorial-repos))

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

![Tutorial: Tools](/assets/tutorials/tools-tutorial.cast)

### الخطوة 1: الاتصال بجهاز

قم بتشغيل أوامر مضمّنة على جهاز بعيد عبر SSH دون فتح جلسة تفاعلية.

```bash
rdc term connect -m server-1 -c "hostname"
rdc term connect -m server-1 -c "uptime"
```

يقوم العلم `-c` بتنفيذ أمر واحد وإرجاع الناتج. احذف `-c` لفتح جلسة SSH تفاعلية.

### الخطوة 2: الاتصال بمستودع

لتشغيل الأوامر داخل بيئة Docker المعزولة للمستودع:

```bash
rdc term connect -m server-1 -r my-app -c "docker ps"
```

عند الاتصال بمستودع، يتم تعيين `DOCKER_HOST` تلقائيًا إلى مقبس Docker المعزول الخاص بالمستودع. أي أمر Docker يعمل فقط على حاويات ذلك المستودع.

### الخطوة 3: معاينة مزامنة الملفات (تجريبي)

قبل نقل الملفات، قم بمعاينة التغييرات المتوقعة.

```bash
rdc repo sync upload -m server-1 -r my-app --local ./src --dry-run
```

يعرض العلم `--dry-run` الملفات الجديدة والملفات المتغيرة وحجم النقل الإجمالي دون تحميل أي شيء فعليًا.

### الخطوة 4: تحميل الملفات

انقل الملفات من جهازك المحلي إلى نقطة تحميل المستودع البعيد.

```bash
rdc repo sync upload -m server-1 -r my-app --local ./src
```

يتم نقل الملفات عبر rsync من خلال SSH. يتم إرسال الملفات المتغيرة فقط في عمليات التحميل اللاحقة.

### الخطوة 5: التحقق من الملفات المحمّلة

تأكد من وصول الملفات عن طريق عرض محتويات دليل تحميل المستودع.

```bash
rdc term connect -m server-1 -r my-app -c "ls -la"
```

### الخطوة 6: فحص تكامل VS Code

للتطوير عن بُعد باستخدام VS Code، تحقق من تثبيت المكونات المطلوبة.

```bash
rdc vscode check
```

يتحقق من تثبيت VS Code وإضافة Remote SSH وتهيئة SSH. اتبع الناتج لحل أي متطلبات مفقودة، ثم اتصل باستخدام `rdc vscode connect -m <machine> [-r <repo>]`.

### الخطوة 7: التحقق من تحديثات CLI

```bash
rdc update --check-only
```

يُبلغ عما إذا كان إصدار أحدث من CLI متاحًا. لتثبيت التحديث، قم بتشغيل `rdc update` بدون `--check-only`.

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

**"rsync: command not found" أثناء مزامنة الملفات**
قم بتثبيت rsync على كل من جهازك المحلي والخادم البعيد. على Debian/Ubuntu: `sudo apt install rsync`. على macOS: rsync مضمّن افتراضيًا.

**"Permission denied" أثناء تحميل المزامنة**
تحقق من أن مستخدم SSH لديه صلاحيات الكتابة على دليل تحميل المستودع. نقاط تحميل المستودعات مملوكة للمستخدم المحدد أثناء تسجيل الجهاز.

**"VS Code Remote SSH extension not found"**
قم بتثبيت الإضافة من سوق VS Code: ابحث عن "Remote - SSH" من Microsoft. بعد التثبيت، أعد تشغيل VS Code وقم بتشغيل `rdc vscode check` مرة أخرى.

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

لقد قمت بتشغيل أوامر عن بُعد، ومزامنة الملفات، والتحقق من تكامل VS Code، والتحقق من تحديثات CLI. لحماية بياناتك:

- [Tools](/ar/docs/tools), مرجع كامل لأوامر الطرفية والمزامنة وVS Code والتحديث
- [درس: النسخ الاحتياطي والشبكات](/ar/docs/tutorial-backup), جدولة النسخ الاحتياطي وتهيئة الشبكة
- [الخدمات](/ar/docs/services), مرجع Rediaccfile وشبكات الخدمات