اختبار العاملين باستخدام أنفاق التطوير

باستخدام Dev Tunnels، يمكنك اختبار عامل Agent 365 مع تطبيقات Microsoft 365 (مثل Teams أو Outlook أو Word) بينما يعمل الوكيل محليا على جهاز التطوير الخاص بك. هذا النهج يربط بين التطوير المحلي والاختبار في العالم الحقيقي، بحيث يمكنك التحقق من صحة سلوك العامل في بيئات Microsoft 365 الفعلية قبل النشر على السحابة.

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

قبل استخدام أنفاق المطورين، تأكد من تثبيت أداة سطر الأوامر الخاصة ب Dev Tunnels.

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: تحميل من aka.ms/devtunnels/download

إعداد نفق التطوير

قم بتكوين Dev Tunnel لتعريض نقطة نهاية الوكيل المحلي إلى خدمات Microsoft 365.

إنشاء وبدء نفق

1. تسجيل الدخول إلى نفق المطورين:

   devtunnel user login
   

2. أنشئ نفقًا مستمرًا:

   devtunnel create --allow-anonymous
   

   هذا الأمر يعيد معرف النفق. احفظ هذا المعرف للاستخدام المستقبلي.

3. تكوين منفذ النفق:

   تعيين المنفذ الذي يستخدمه خادم الوكيل الخاص بك (عادة 3978):

   devtunnel port create <tunnel-id> -p <port-number>
   

4. ابدأ النفق:

   devtunnel host <tunnel-id>
   

   يعرض الأمر عنوان URL الخاص بك (على سبيل المثال، https://abc123xyz.devtunnels.ms:3978). انسخ هذا الرابط للخطوة التالية.

Tip

استخدمها devtunnel listdevtunnel delete <tunnel-id> لرؤية جميع أنفاق وإزالة الأنفاق التي لم تعد بحاجة إليها.

تكوين نقطة نهاية رسائل الوكيل

سجل عنوان URL الخاص ب Dev Tunnel (على سبيل المثال، https://abc123xyz.devtunnels.ms:3978/api/messages) كنقطة نهاية مراسلة العامل حتى يعرف Microsoft 365 مكان توجيه الرسائل. لا تنس اللاحقة /api/messages إلى نقطة النهاية.

يرجى مراجعة تعيين نقطة نهاية رسائل الوكيل

اختبار مع Microsoft 365

باستخدام Dev Tunnel النشط ونقطة النهاية المسجلة، اختبر وكيلك في تطبيقات Microsoft 365.

الاختبار في Microsoft Teams

1. ابدأ الوكيل المحلي باستخدام التعليمات في تثبيت التبعيات ثم بدء خادم تطبيق الوكيل.

2. تحقق من اتصال النفق:

   devtunnel list
   

   تحقق من أن النفق يظهر اتصالات المضيف النشطة. يجب أن يظهر عمود "اتصالات المضيف" رقما أكبر من 0.

3. تفاعل مع وكيلك في Teams:

   • فتح Microsoft Teams (الويب أو سطح المكتب)
   • في شريط بحث Teams، ابحث عن وكيلك بالاسم أو البريد الإلكتروني
   • ابدأ محادثة مع الوكيل
   • أرسل رسالة وراقب الرد
   • تحقق من وحدة التحكم المحلية لديك بحثا عن الطلبات الواردة ونشاط الوكيل

إشعارات البريد الإلكتروني التجريبي

إذا كان وكيلك مهيئا لإشعارات البريد الإلكتروني:

1. أرسل بريدا إلكترونيا إلى بريد وكيلك الإلكتروني
2. قم بتسجيل وكيلك في سلسلة بريد إلكتروني
3. راقب وحدة التحكم المحلية الخاصة بك لرؤية إشعار الويبهوك
4. تحقق من أن الوكلاء يعالجون البريد الإلكتروني ويردون عليه

اختبار تكامل Word

بالنسبة للوكلاء الذين يستجيبون لتعليقات برنامج Word:

1. افتح مستند Word حيث يمكن لوكيلك الوصول إليه.
2. أضف تعليقا يذكر وكيلك.
3. تحقق من جهاز التحكم المحلي لديك للحصول على الإشعار.
4. تحقق من ظهور استجابة وكيلك في Word.

مراقبة نشاط الأنفاق

يوفر Dev Tunnels فحص حركة المرور للمساعدة في تصحيح مشاكل الاتصال وفهم تدفق الطلبات:

devtunnel show <tunnel-id>

يعرض هذا الأمر:

• الاتصالات النشطة وتفاصيل الجلسة.
• معلومات الطلبات والرد.
• إحصائيات حجم حركة المرور.
• أخطاء الاتصال وتحذيرات.

يمكنك أيضا مراقبة نشاط الأنفاق في الوقت الحقيقي من خلال مراقبة مخرجات الأمر devtunnel host .

الحفاظ على وصلات الأنفاق

يجب أن تستمر عملية devtunnel host في التشغيل لتفعيل أنفاق التطوير. إذا كان عدم النشاط، أو مشاكل الشبكة، أو دخول جهازك في وضع السكون تسببت في انقطاع الاتصال، عليك إعادة تشغيله.

تحقق من حالة النفق

تحقق مما إذا كان نفقك نشطا:

devtunnel list

يعرض الإخراج:

• معرف النفق: معرف النفق الخاص بك
• اتصالات المضيف: عدد الاتصالات النشطة (يجب أن يكون واحدا أو أكثر عند devtunnel host التشغيل)
• المنافذ: المنافذ المكونة
• انتهاء الصلاحية: وقت انتهاء النفق

إذا كانت Host Connections تشير إلى 0، فهذا يعني أن النفق موجود ولكنه غير مستضاف حالياً.

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

إذا انقطع الاتصال بالنفق، أعد تشغيله باستخدام نفس معرف النفق:

devtunnel host <tunnel-id>

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

حافظ على نشاط الأنفاق أثناء التطوير

للحفاظ على اتصالات مستقرة:

• أبق نافذة الطرفية مفتوحة - لا تغلق المحطة وهي تعمل devtunnel host.
• منع سبات الكمبيوتر - قم بتكوين نظامك ليبقى مستيقظا أثناء جلسات الاختبار.
• راقب أخطاء الاتصال - راقب devtunnel host مخرج الطرفية بحثا عن رسائل الانقطاع.
• أعد التشغيل بعد تغييرات الشبكة - إذا قمت بتغيير الشبكة أو إعادة الاتصال بشبكة VPN، أعد تشغيل النفق.

Tip

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

تنظيف

عندما تنتهي من الاختبار باستخدام أنفاق المطورين:

أوقف النفق

اضغط Ctrl+C في الطرفية التي تعمل بـ devtunnel host لإيقاف النفق.

يقوم هذا الأمر بإزالة رابط Dev Tunnel من نقطة نهاية رسائل وكيلك. عند النشر في الإنتاج، قم بتعيين رابط نقطة النهاية المستضافة في السحابة.

ملاحظة

يظل النفق متاحا للاستخدام المستقبلي حتى تقوم بحذفه صراحة باستخدام devtunnel delete <tunnel-id>.

القيود

ضع هذه القيود في الاعتبار عند الاختبار باستخدام أنفاق المطورين:

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

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

بعد اختبار نفق المطور بنجاح:

• انشر وكيلك على السحابة: انشر في Azure، قم بتعيين نقطة نهاية مراسلة الوكيل في AWS، أو قم بتعيين نقطة نهاية مراسلة الوكيل في GCP.
• تكوين نقاط نهاية رسائل الوكيل: نقطة نهاية رسائل الوكيل.
• اتبع دورة حياة التطوير الكاملة: دورة حياة تطوير الوكيل 365.

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

إذا واجهت مشاكل أثناء الاختبار عبر أنفاق المطورين، ابدأ هنا لإصلاح الأنفاق الشائعة والاتصال ونقاط النهاية. للمزيد من استكشاف أخطاء العميل 365 (الإعداد، المصادقة، والرسائل)، راجع استكشاف المشكلات.

فشل اتصال النفق

الأعراض: نفق التطوير (Dev Tunnel) لا يبدأ أو ينقطع الاتصال فوراً.

الحلول‏‎:

• تحقق من تسجيل الدخول: devtunnel user login
• تحقق مما إذا كانت عملية أخرى تستخدم نفس المنفذ
• تأكد من أن جدار الحماية الخاص بك يسمح باتصالات Dev Tunnel
• احذف وأعد إنشاء النفق: devtunnel delete <tunnel-id> ثم أنشئ واحدا جديدا

الرسائل لا تصل إلى الوكيل المحلي

Symptoms: تشير Microsoft 365 إلى إرسال الرسالة، ولكن الوكيل المحلي لا يتلقىها.

الحلول‏‎:

• تأكد من أن وكيلك يعمل محليا
• تحقق من أن النفق نشط: devtunnel list يجب أن يظهر "متصل"
• تحقق من تكوين نقطة النهاية في a365.config.json وتحقق من تعيين عنوان URL الخاص ب Dev Tunnel كنقطة نهاية المراسلة
• راجع سجلات نفق التطوير في الجهاز التشغيلي devtunnel host بحثا عن أخطاء الاتصال
• تأكد من أن منفذك المحلي يطابق منفذ النفق (كلاهما يجب أن يكون 3978 افتراضيا)

أخطاء المصادقة عبر نفق التطوير

الأعراض: أخطاء 401 أو 403 عند الاختبار عبر Dev Tunnel.

الحلول‏‎:

• تحقق من تكوين المصادقة القائمة على العاملين (مصادقة الرمز المميز للمالك لا تعمل مع أنفاق التطوير لتكامل Microsoft 365).
• تحقق من بيانات اعتماد مخطط العامل في a365.generated.config.json.
• تأكد من أن وكيلك لديه الأذونات المطلوبة للعمليات التي تختبرها.
• تأكد من أن رموز المصادقة الخاصة بك لم تنتهي صلاحيتها.

تم تغيير أو انتهاء صلاحية عنوان URL الخاص بالأنفاق

الأعراض: رابط النفق الذي كان يعمل سابقا لم يعد يوجه إلى وكيلك.

الحلول‏‎:

• تحقق من حالة النفق باستخدام devtunnel list.
• أعد تشغيل النفق باستخدام devtunnel host <tunnel-id>.
• قم بتحديث نقطة نهاية الرسائل إذا تغير الرابط باستخدام a365 setup blueprint --endpoint-only --m365.