مشاركة عبر

توزيع الحزم باستخدام Package Deployer وWindows PowerShell

  • مقالة

يمكّن Microsoft Dynamics CRM Package Deployer المسؤولين من نشر الحزم في بيئة.

‏‫ملاحظة‬

يعمل Package Deployer أيضًا مع مؤسسات Dynamics 365 Customer Engagement (on-premises).

يمكن أن تتكون "المجموعة" من أي من أو كل الإجراءات التالية:

  • ملف حلول Dataverse واحدًا أو أكثر.

  • ملفات ثابتة أو ملفات بيانات تم تصديرها من أداة Configuration Migration. لمزيد من المعلومات حول أداة Configuration Migration، راجع إدارة بيانات التكوين.

  • تعليمات برمجية مخصصة يمكن تشغيلها أثناء نشر الحزمة في بيئة أو بعد نشرها.

  • محتوى HTML المحدد للحزمة والذي يمكن عرضه في بداية ونهاية عملية نشر الحزمة. قد يكون ذلك الأمر مفيداً لتوفير وصف للحلول والملفات التي يتم نشرها في الحزمة.

    يقوم المطورون بإنشاء الحزم باستخدام قالب نشر الحزمة في Visual Studio. معلومات إضافية: إنشاء حزم لـ Package Deployer

    بعد إنشاء حزمة، يمكنك نشرها إما عن طريق تشغيل CRM Package Deployer أو باستخدام Windows PowerShell cmdlets للأداة.

هام

قبل استيراد حزمة في مؤسسة إنتاج وتشغيلها، اختبر الحزمة على صورة طبق الأصل بدون إنتاج لمؤسسة الإنتاج.

احرص دائمًا على عمل نسخة احتياطية لمؤسسة الإنتاج قبل نشر حزمة.


نشر الحزم باستخدام أداة Package Deployer

يمكنك استخدام أداة Package Deployer ‏(packagedeployer.exe) لنشر الحزم بالطرق التالية.

استخدام أداة CRM Package Deployer لنشر الحزم

استخدام أداة CRM Package Deployer في سطر الأوامر

استخدام أداة Package Deployer لنشر الحزم

تستطيع أداة Package Deployer القيام بمعالجة حزمة واحدة فقط في كل مرة. ومع ذلك، يوفر للمستخدمين القدرة على تحديد حزمة لنشرها من بين حزم متعددة متاحة في دليل أداة Package Deployer. وتختلف بعض الشاشات والإجراءات في الأداة استناداً إلى تعريف الحزمة. ولست مضطرًا إلى تثبيت أداة Package Deployer. فقط قم بتنزيلها وتشغيلها.

  1. قم بالحصول على الحزمة لنشرها. الحزمة عبارة عن مجموعة من الملفات والمجلدات التي تم إنشاؤها في مجلد مشروع Visual Studio (<Project>\Bin\Debug) عندما تنشئ مشروع الحزمة في Visual Studio. انسخ ما يلي من مجلد تصحيح المشروع الخاص بك:

    • <مجلد PackageName>: يحتوي هذا المجلد على الحلول وتكوين الاستيراد ومحتويات الحزمة.

    • <PackageName>.dll: يحتوي التجميع على التعليمات البرمجية للحزمة. يكون اسم التجميع بشكل افتراضي هو نفس اسم مشروع Visual Studio الخاص بك.

      للحصول على معلومات مفصلة حول إنشاء حزمة باستخدام Visual Studio، راجع إنشاء حزمة لأداة Package Deployer.

      بالنسبة لهذا الموضوع، لنفترض أنه يتم نسخ مجلد الحزمة والتجميع من مجلد تصحيح المشروع Visual Studio (<Project>\Bin\Debug) إلى مجلد c:\DeployPackage.

  2. احصل على أداة Package Deployer. تتوفر أداة Package Deployer في صورة حزمة NuGet. ‏‫ولكي تستخدم Package Deployer، يجب تنزيلها واستخراجها إلى الكمبيوتر المحلي الخاص بك باستخدام nuget.exe.

    قم بتنزيل nuget.exe من https://www.nuget.org/downloads، واحفظه في الكمبيوتر، على سبيل المثال، d:\. ‏‫ثم نفذ الأمر التالي في موجه الأوامر لاستخراج محتويات الحزمة إلى مجلد، ولنفترض PD، على الكمبيوتر الخاص بك:
    d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD

    بعد استخراج أداة Package Deployer، استعرض مجلد [ExtractedLocation]\tools للعثور على ملف PackageDeployer.exe.

  3. انسخ مجلد الحزمة والتجميع من c:\DeployPackage إلى المجلد [ExtractedLocation]\tools.

  4. وبعد نسخ الملفات، قم بتشغيل الأداة من خلال النقر بشكل مزدوج فوق ملف PackageDeployer.exe في المجلد [ExtractedLocation]\tools.

  5. انقر فوق متابعة في الشاشة الرئيسية للأداة.

  6. في شاشة الاتصال بـ Microsoft Dynamics 365 for Customer Engagement، قدم تفاصيل المصادقة للاتصال بخادم Dynamics 365 Server حيث تريد نشر الحزمة. إذا كان لديك مؤسسات متعددة، وترغب في تحديد المؤسسة حيث تريد نشر الحزمة، فحدد خانة الاختيار عرض قائمة المؤسسات المتوفرة دائمًا. انقر فوق تسجيل الدخول.

  7. إذا كان لديك مؤسسات متعددة على Dynamics 365 Server، فحدد مؤسسة تطبيقات Dynamics 365 للاتصال بها.

  8. حدد الحزمة لنشرها، انقر فوق التالي.

    حدد حزمتك في أداة Package Deployer.

  9. واتبع الإرشادات على الشاشات اللاحقة لإكمال نشر الحزمة الخاصة بك.

    وتظهر الشاشات استناداً إلى تعريف الحزمة المحددة للنشر. للنشر المتكامل للحزمة التي تستخدم أداة Package Deployer، شاهد الموضوع الخاص بنشر حزم Unified Service Desk: نشر عينة تطبيقات Unified Service Desk في CRM Server باستخدام Package Deployer

استخدام أداة Package Deployer في سطر الأوامر

باستطاعة المسؤولين عن النظام والمخصصين تمرير المعلمات، مثل تعليمة برمجية لغة إقليمية، إلى packagedeployer.exe من سطر الأوامر. لا يمكن تكوين هذه المعلمات إلا بتشغيل أداة Package Deployer في سطر الأوامر.

‏‫ملاحظة‬

تم تقديم هذه الميزة للمرة الأولى في Dynamics CRM Online 2016 Update 0.1.

يتضمن هذا الجدول المعلمات المتوفرة.

المعلمة الوصف القيمة الافتراضية
RuntimePackageSettings ترشد packagedeployer.exe إلى قبول معلمات سطر الأوامر مثل LCID وSkipChecks. غير قابل للتطبيق
LCID=localeID تعيّن معرف الإعدادات المحلية، مثل 1033 للغة الإنجليزية-الولايات المتحدة أو 1036 للغة الفرنسية-فرنسا من معرفات الإعدادات المحلية المتوفرة في الحزمة. إذا لم يتم تحديدها، فيتم استخدام اللغة الافتراضية. استخدام اللغة الافتراضية
SkipChecks=true/false استخدام هذه المعلمة فقط عندما لا تتضمن البيئة المستهدفة أية حلول أو تخصيصات أخرى. عند تعيين هذه المعلمة إلى true، سيتجاوز استيراد الحل بعض اختبارات السلامة، مما يؤدي إلى تحسين أداء الاستيراد. خطأ

المثال التالي يرشد CRM Package Deployer لتجاوز بعض اختبارات السلامة ويقوم بتعيين لغة الاستيراد إلى اللغة البولندية.

packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"

‏‫ملاحظة‬

استخدم حرف التوجيه | لفصل المعلمات عند تشغيل packagedeployer.exe في سطر الأوامر باستخدام عدة معلمات.

لمزيد من المعلومات حول المعلمات والقيم التي يمكن تمريرها إلى packagedeployer.exe، راجع إنشاء حزم CRM Package Deployer.

استخدام Windows PowerShell لنشر الحزم

يتوفر أيضًا دعم Windows PowerShell بواسطة أداة Package Deployer لنشر الحزم. مزيد من المعلومات: بدء العمل باستخدام وحدة نشر الحزمة

استكشاف مشكلات نشر الحزمة وإصلاحها باستخدام ملفات السجل

توفر أداة Package Deployer دعم التسجيل للحصول على معلومات تفصيلية حول الأخطاء التي يمكن أن تحدث عندما يقوم أحد الأشخاص بتسجيل دخوله إلى مثيل Microsoft Dynamics 365 for Customer Engagement باستخدام الأداة ونشر الحزم. بشكل افتراضي، تقوم الأداة بإنشاء ثلاثة ملفات تسجيل تكون متوفرة في الموقع التالي على الكمبيوتر حيث تقوم بتشغيل الأداة: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. لتحديد مجلد آخر، استخدم معلمة -LogWriteDirectory PowerShell cmdlet. مزيد من المعلومات: استخدام cmdlet لاسترداد الحزم

  • Login_ErrorLog.log: يوفر معلومات حول المشكلات التي حدثت عندما تستخدم الأداة لتسجيل الدخول إلى مثيل Dynamics 365. وإذا كان هناك أي مشكلات أثناء تسجيل الدخول، فستظهر رسالة على شاشة تسجيل دخول الأداة مع ارتباط إلى ملف السجل هذا. وتفيد الرسالة أنه حدث خطأ أثناء معالجة طلب تسجيل الدخول ويمكن للمستخدم عرض سجل الخطأ. يمكنك النقر فوق الارتباط الموجود في الرسالة لعرض ملف السجل هذا. يتم إنشاء ملف السجل في المرة الأولى لمواجهتك أية مشكلات خاصة بتسجيل الدخول في الأداة. ولذلك، يُستخدم ملف السجل لتسجيل المعلومات التي تخص المشكلات الخاصة بتسجيل الدخول، متى تحدث.

  • PackageDeployer.log: يوفر معلومات تفصيلية حول كل مهمة يتم تنفيذها في الأداة أثناء توزيع الحزم. يمكنك عرض ملف السجل من الأداة بالنقر فوق ارتباط عرض ملف السجل أسفل الشاشة.

  • ComplexImportDetail.log: يوفر معلومات إضافية حول البيانات التي تم استيرادها في آخر توزيع باستخدام الأداة. وفي كل مرة يتم نشر حزمة باستخدام هذه الأداة، يتم نقل التفاصيل الموجودة من ملف السجل إلى ملف يسمى ComplexImportDetail._old.log في نفس الدليل، ويعرض الملف ComplexImportDetail.log معلومات حول الاستيراد الأحدث الذي تم باستخدام الأداة.

‏‫أفضل الممارسات لنشر الحزم

أثناء نشر الحزم، يلزم على مسؤولي Dynamics 365:

  • الإصرار على تجميع حزمة تم تسجيل دخولها بحيث يتمكن من تتبع تجميع ما إلى مصدره.

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

  • إجراء نسخ احتياطي لمثيل الإنتاج قبل نشر الحزمة.

راجع أيضًا

إنشاء حزم لـ CRM Package Deployer