Register-ServiceFabricApplicationType
تسجيل نوع تطبيق "Service Fabric".
بناء الجملة
Register-ServiceFabricApplicationType
[-ApplicationPathInImageStore] <String>
[-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
[-Async]
[-TimeoutSec <Int32>]
[<CommonParameters>] Register-ServiceFabricApplicationType
[-ApplicationPackageDownloadUri] <Uri>
-ApplicationTypeName <String>
-ApplicationTypeVersion <String>
[-Async]
[-TimeoutSec <Int32>]
[<CommonParameters>] الوصف
يسجل Cmdlet Register-ServiceFabricApplicationType نوع تطبيق Service Fabric. اقرأ المزيد حول نشر تطبيق Service Fabric.
يمكن أن توجد حزمة التطبيق في موقع نسبي في مخزن الصور أو يمكن أن تكون ملفا sfpkg تم تحميله مسبقا إلى موقع خارجي.
عند استخدام المسار النسبي للمخزن، يجب أن تكون حزمة التطبيق موجودة في مخزن الصور. يمكن نسخ الحزمة إلى مخزن الصور باستخدام Copy-ServiceFabricApplicationPackage.
عند استخدام sfpkg ملف من متجر خارجي، يجب أن يوفر التوفير عنوان URI للتنزيل إلى المكان الذي sfpkg تم تحميله مسبقا، بالإضافة إلى معلومات نوع التطبيق.
sfpkg الملف هو zip يحتوي على حزمة التطبيق الأولية ويحتوي على الملحق ".sfpkg".
داخل الملف المضغوط، يمكن ضغط حزمة التطبيق أو عدم ضغطها. يتم ضغط حزمة التطبيق داخل الرمز البريدي في التعليمات البرمجية والحزمة وحزم البيانات.
لإنشاء sfpkg، ابدأ بمجلد يحتوي على حزمة التطبيق الأصلية. إذا لزم الأمر، قم بضغط الحزمة باستخدام Copy-ServiceFabricApplicationPackage مع مفاتيح التبديل -CompressPackage و-SkipCopy.
ثم استخدم أداة مساعدة لضغط المجلد بالملحق ".sfpkg". على سبيل المثال، استخدم ZipFile.CreateFromDirectory في مجلد حزمة التطبيق.
بعد تسجيل نوع تطبيق، يمكنك استخدام الأمر Cmdlet New-ServiceFabricApplication لإنشاء مثيل تطبيق. استخدم الأمر cmdlet Start-ServiceFabricApplicationUpgrade لترقية تطبيق موجود.
عندما لا يكون نوع التطبيق مع الإصدار المحدد مطلوبا بعد الآن، يمكنك إلغاء تسجيله باستخدام الأمر cmdlet Unregister-ServiceFabricApplicationType .
لإدارة مجموعات Service Fabric، ابدأ Windows PowerShell باستخدام الخيار تشغيل كمسؤول. قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام Connect-ServiceFabricCluster cmdlet.
أمثلة
مثال 1: تسجيل نوع تطبيق مع المسار النسبي لمخزن الصور
PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "file:C:\SfDevCluster\Data\ImageStoreShare" -ApplicationPackagePathInImageStore "PersistentToDoListService"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService"نسخ-ServiceFabricApplicationPackage نسخ حزمة التطبيق الموجودة في المجلد "c:\work\PersistentToDoListService" إلى مخزن الصور. يتم نسخ الحزمة في المسار النسبي "PersistentToDoListService" في مخزن الصور.
يسجل الأمر Register-ServiceFabricApplicationType نوع التطبيق الموجود في المسار النسبي "PersistentToDoListService".
مثال 2: تسجيل نوع تطبيق باستخدام المسار النسبي لمخزن الصور غير متزامن
PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -Async
PS C:\> Get-ServiceFabricApplicationTypeنسخ-ServiceFabricApplicationPackage نسخ حزمة التطبيق الموجودة في المجلد "c:\work\PersistentToDoListService" إلى مخزن الصور. يتم نسخ حزمة التطبيق في المسار النسبي "PersistentToDoListService" في مخزن الصور. يستخدم cmdlet الضغط لتقليل حجم الحزمة.
يسجل الأمر Register-ServiceFabricApplicationType نوع التطبيق الموجود في المسار النسبي "PersistentToDoListService". يتم التسجيل بشكل غير متزامن، ويرجع بمجرد قبول الأمر من قبل نظام المجموعة.
يحصل Get-ServiceFabricApplicationType على أنواع التطبيقات المسجلة في نظام المجموعة. يتضمن كل نوع تطبيق حالة التسجيل. يمكن استخدام cmdlet لتحديد وقت اكتمال التسجيل.
مثال 3: تسجيل نوع تطبيق لحزمة تطبيق كبيرة مع مسار نسبي لمخزن الصور
PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage -TimeoutSec 2700
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -TimeoutSec 2700نسخ-ServiceFabricApplicationPackage ينسخ حزمة التطبيق الموجودة في المجلد "c:\work\PersistentToDoListService" إلى مخزن الصور، في الموقع النسبي لمخزن الصور "PersistentToDoListService". نظرا لأن الحزمة الأولية كبيرة جدا، فإن الأمر يضغطها ويتضمن مهلة أعلى للسماح بوقت كاف للنسخ.
يسجل الأمر Register-ServiceFabricApplicationType نوع التطبيق الموجود في المسار النسبي "PersistentToDoListService". يتضمن الأمر مهلة أعلى للسماح بإنهاء العمل حتى إذا كانت حزمة التطبيق كبيرة.
مثال 4: تسجيل نوع تطبيق من متجر خارجي
PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -TimeoutSec 2700تسجيل حزمة التطبيق الموجودة في URI المحدد. يجب أن تكون حزمة التطبيق قد تم تحميلها مسبقا في هذا الموقع ويجب أن تسمح بالوصول للقراءة. نظرا لأن الحزمة قد تكون كبيرة، يحدد الأمر مهلة توفير كبيرة.
مثال 5: تسجيل نوع تطبيق من متجر خارجي غير متزامن
PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -Async
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName MyApp -ApplicationTypeVersion V1تسجيل حزمة التطبيق الموجودة في URI المحدد. يجب أن تكون حزمة التطبيق قد تم تحميلها مسبقا في هذا الموقع ويجب أن تسمح بالوصول للقراءة. لأنه تم تحديد -Async، يرجع الأمر بمجرد قبول نظام المجموعة له. يحصل Get-ServiceFabricApplicationType على أنواع التطبيقات المسجلة في نظام المجموعة التي تطابق عامل التصفية. يتضمن كل نوع تطبيق حالة التسجيل. يمكن استخدام cmdlet لمتابعة تقدم التسجيل ولتحديد وقت اكتمال التسجيل.
مثال 6: تسجيل نوع تطبيق مع المسار النسبي لمخزن الصور وتنظيف الحزمة التلقائي
PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -ApplicationPackageCleanupPolicy Automatic
[Copy-ServiceFabricApplicationPackage](./Copy-ServiceFabricApplicationPackage.yml) copies the application package found in the "c:\work\PersistentToDoListService" folder to the image store. The package is copied at the relative path "PersistentToDoListService" in image store.
[Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command registers the application type found in the relative path "PersistentToDoListService" and deletes the application package "PersistentToDoListService" in the image store after successfully registering the application type. Deleting the application package from the image store after [Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command is recommended because it removes the temporary package as soon as it's not needed, which ensures that disk space is not consumed unnecessarily.المعلمات
-ApplicationPackageCleanupPolicy
تحديد نهج التنظيف لحزمة التطبيق المستخدمة لتسجيل نوع التطبيق. إذا لم يتم التنظيف، تستهلك حزم التطبيقات مساحة القرص ويمكن أن تؤدي إلى حالات فشل. تحدد هذه المعلمة كيفية إدارة حزمة التطبيق بعد تسجيل نوع التطبيق بنجاح (توفير ناجح).
عند التعيين إلى Automatic، يحدد وقت تشغيل Service Fabric وقت إجراء تنظيف حزمة التطبيق. يحذف تطبيق وقت التشغيل الحالي حزمة التطبيق بعد تسجيل نوع التطبيق بنجاح. إذا فشل التسجيل، فلن يتم حذف حزمة التطبيق من مخزن الصور.
عند التعيين إلى Manual، لا يتم حذف حزمة التطبيق من مخزن الصور ويجب على المستخدمين استدعاء Remove-ServiceFabricApplicationPackage cmdlet بشكل صريح لإزالتها من مخزن الصور.
يتم تكوين مجموعة Service Fabric مع نهج تنظيف. لاستخدام نهج نظام المجموعة، حدد Default الخيار . يحدد تكوين نظام المجموعة CleanupApplicationPackageOnProvisionSuccess ضمن Management القسم كيفية حدوث التنظيف. إذا تم تعيينها إلى true، يتم حذف حزم التطبيق تلقائيا بواسطة وقت تشغيل نسيج الخدمة بعد التوفير الناجح. إذا تم تعيينها إلى خطأ، فلن يتم حذف حزمة التطبيق من مخزن الصور. تم تعيين القيمة الافتراضية لتكوين نظام المجموعة هذا إلى خطأ حتى v6.4، ولكن هناك خطط لتعيينها إلى true للإصدارات المستقبلية.
| Type: | ApplicationPackageCleanupPolicy |
| Accepted values: | Invalid, Default, Automatic, Manual |
| Position: | Named |
| Default value: | Default |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationPackageDownloadUri
يمثل المسار إلى حزمة sfpkg التطبيق حيث يمكن تنزيل حزمة التطبيق باستخدام بروتوكولات HTTP أو HTTPS. يجب أن تكون الحزمة قد تم تحميلها مسبقاً إلى هذا الموقع الخارجي. يجب أن يسمح عنوان URI بالوصول إلى READ حتى يتمكن نظام Service Fabric من تنزيل الملف.
sfpkg الملف هو مضغوط يحتوي على حزمة التطبيق الأولية. داخل الملف المضغوط، يمكن ضغط حزمة التطبيق أو عدم ضغطها. يتم ضغط حزمة التطبيق داخل الرمز البريدي في التعليمات البرمجية والحزمة وحزم البيانات. يمكن تحقيق هذا الضغط باستخدام Copy-ServiceFabricApplicationPackage مع مفتاح -ضغط الحزمة.
يجب أن يكون الملف sfpkg الملحق ".sfpkg".
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationPathInImageStore
تحديد المسار النسبي لحزمة نوع التطبيق في مخزن الصور. تم تحديد هذا المسار بواسطة Copy-ServiceFabricApplicationPackage cmdlet عند نسخ حزمة التطبيق إلى مخزن الصور.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeName
تحديد اسم نوع التطبيق، كما هو محدد في بيان التطبيق. يحدد اسم نوع التطبيق وإصدار نوع التطبيق نوع التطبيق بشكل فريد.
هذا مطلوب عند توفير من sfpkg متجر خارجي.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeVersion
يحدد إصدار نوع التطبيق، كما تم تعريفه في بيان التطبيق. يحدد اسم نوع التطبيق وإصدار نوع التطبيق نوع التطبيق بشكل فريد.
هذا مطلوب عند توفير ملف حزمة sfpkg تطبيق من متجر خارجي.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Async
يرجع الأمر بمجرد قبول طلب التسجيل من قبل نظام المجموعة. استخدم الأمر Get-ServiceFabricApplicationType للاستعلام عن حالة طلب التسجيل. يؤدي استخدام مفتاح التبديل هذا إلى تجنب الحاجة إلى توفير قيم كبيرة -TimeoutSec عند تسجيل حزم التطبيقات الكبيرة.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
تحديد فترة المهلة، بالثوان، للعملية.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
الإدخالات
None
المخرجات
System.Object