Register-ServiceFabricApplicationType

  • Reference
Modul:
ServiceFabric

Zaregistruje typ aplikace Service Fabric.

Syntax

Register-ServiceFabricApplicationType
        [-ApplicationPathInImageStore] <String>
        [-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]
Register-ServiceFabricApplicationType
        [-ApplicationPackageDownloadUri] <Uri>
        -ApplicationTypeName <String>
        -ApplicationTypeVersion <String>
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

Description

Rutina Register-ServiceFabricApplicationType registruje typ aplikace Service Fabric. Přečtěte si další informace o nasazení aplikace Service Fabric.

Balíček aplikace může existovat v relativním umístění v úložišti obrázků nebo může být sfpkg soubor dříve nahraný do externího umístění.

Při použití relativní cesty úložiště musí balíček aplikace existovat v úložišti imagí. Balíček lze zkopírovat do úložiště imagí pomocí copy-ServiceFabricApplicationPackage.

Při použití sfpkg souboru z externího úložiště musí zřízení poskytnout identifikátor URI pro stahování, do kterého sfpkg byl dříve nahraný, a také informace o typu aplikace. Soubor sfpkg je zip, který obsahuje počáteční balíček aplikace a má příponu ".sfpkg". Uvnitř souboru ZIP lze balíček aplikace komprimovat nebo nekomprimovat. Komprese balíčku aplikace uvnitř zip se provádí v kódu, balíčku a datových balíčcích.

Pokud chcete vytvořit sfpkgsložku, která obsahuje původní balíček aplikace, začněte složkou. V případě potřeby komprimujte balíček pomocí copy-ServiceFabricApplicationPackage s přepínači -CompressPackage a -SkipCopy. Potom pomocí nástroje zazipujte složku s příponou .sfpkg. Použijte například ZipFile.CreateFromDirectory ve složce balíčku aplikace.

Po registraci typu aplikace můžete k vytvoření instance aplikace použít rutinu New-ServiceFabricApplication . Pomocí rutiny Start-ServiceFabricApplicationUpgrade upgradujte existující aplikaci.

Pokud už typ aplikace se zadanou verzí nepotřebujete, můžete ji zrušit pomocí rutiny Unregister-ServiceFabricApplicationType .

Pokud chcete spravovat clustery Service Fabric, spusťte Windows PowerShell pomocí možnosti Spustit jako správce. Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .

Příklady

Příklad 1: Registrace typu aplikace s relativní cestou k úložišti obrázků

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "file:C:\SfDevCluster\Data\ImageStoreShare" -ApplicationPackagePathInImageStore "PersistentToDoListService"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService"

Copy-ServiceFabricApplicationPackage zkopíruje balíček aplikace nalezený ve složce c:\work\PersistentToDoListService do úložiště obrázků. Balíček se zkopíruje v relativní cestě PersistentToDoListService v úložišti obrázků.

Příkaz Register-ServiceFabricApplicationType registruje typ aplikace nalezený v relativní cestě PersistentToDoListService.

Příklad 2: Registrace typu aplikace v asynchronní cestě úložiště obrázků

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

Copy-ServiceFabricApplicationPackage zkopíruje balíček aplikace nalezený ve složce c:\work\PersistentToDoListService do úložiště obrázků. Balíček aplikace se zkopíruje v relativní cestě "PersistentToDoListService" v úložišti imagí. Rutina používá kompresi ke zmenšení velikosti balíčku.

Příkaz Register-ServiceFabricApplicationType registruje typ aplikace nalezený v relativní cestě PersistentToDoListService. Registrace se provádí async a vrátí se hned po přijetí příkazu clusterem.

Get-ServiceFabricApplicationType získá typy aplikací zaregistrované v clusteru. Každý typ aplikace obsahuje stav registrace. Rutinu můžete použít k určení, kdy se registrace dokončí.

Příklad 3: Registrace typu aplikace pro velký balíček aplikace s relativní cestou k úložišti imagí

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage -TimeoutSec 2700
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -TimeoutSec 2700

Copy-ServiceFabricApplicationPackage zkopíruje balíček aplikace nalezený ve složce c:\work\PersistentToDoListService do úložiště obrázků v relativním umístění úložiště obrázků PersistentToDoListService. Vzhledem k tomu, že počáteční balíček je velmi velký, příkaz ho komprimuje a obsahuje vyšší časový limit, který umožňuje dostatek času pro kopírování.

Příkaz Register-ServiceFabricApplicationType registruje typ aplikace nalezený v relativní cestě PersistentToDoListService. Příkaz obsahuje vyšší časový limit, který umožňuje dokončení práce, i když je balíček aplikace velký.

Příklad 4: Registrace typu aplikace z externího úložiště

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -TimeoutSec 2700

Zaregistruje balíček aplikace nalezený v zadaném identifikátoru URI. Balíček aplikace musí být dříve nahraný v daném umístění a musí povolit přístup ke čtení. Vzhledem k tomu, že balíček může být velký, příkaz určuje velký časový limit zřizování.

Příklad 5: Registrace typu aplikace z externího úložiště async

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

Zaregistruje balíček aplikace nalezený v zadaném identifikátoru URI. Balíček aplikace musí být dříve nahraný v daném umístění a musí povolit přístup ke čtení. Protože je zadán parametr -Async, příkaz se vrátí, jakmile ho cluster přijme. Get-ServiceFabricApplicationType získá typy aplikací zaregistrované v clusteru, který odpovídá filtru. Každý typ aplikace obsahuje stav registrace. Pomocí rutiny můžete sledovat průběh registrace a určit, kdy se registrace dokončí.

Příklad 6: Registrace typu aplikace s relativní cestou k úložišti obrázků a automatickým vyčištěním balíčku

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.

Parametry

-ApplicationPackageCleanupPolicy

Určuje zásadu vyčištění balíčku aplikace použitého k registraci typu aplikace. Pokud se nevyčistí, balíčky aplikací spotřebovávají místo na disku a můžou vést k selháním. Tento parametr určuje, jak spravovat balíček aplikace po úspěšné registraci typu aplikace (úspěšné zřízení).

Při nastavení na Automatic, modul runtime Service Fabric určuje, kdy provést vyčištění balíčku aplikace. Aktuální implementace modulu runtime odstraní balíček aplikace po úspěšném registraci typu aplikace. Pokud se registrace nezdaří, balíček aplikace se z úložiště imagí neodstraní.

Pokud je nastavený na Manual, balíček aplikace se z úložiště imagí neodstraní a uživatelé musí explicitně volat rutinu Remove-ServiceFabricApplicationPackage , aby ji odebrali z úložiště imagí.

Cluster Service Fabric je nakonfigurovaný pomocí zásad vyčištění. Pokud chcete použít zásady clusteru, zadejte Default možnost. Konfigurace clusteru CleanupApplicationPackageOnProvisionSuccess v Management části určuje, jak má dojít k vyčištění. Pokud je nastavená hodnota true, balíčky aplikací se po úspěšném zřízení automaticky odstraní modulem runtime Service Fabric. Pokud je nastavená hodnota false, balíček aplikace se z úložiště imagí neodstraní. Výchozí hodnota této konfigurace clusteru byla nastavena na hodnotu false až v6.4, ale pro budoucí verze je možné ji nastavit na hodnotu 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

Představuje cestu k sfpkg balíčku aplikace, ze kterého lze balíček aplikace stáhnout pomocí protokolů HTTP nebo HTTPS. Balíček musel být dříve odeslán do tohoto externího umístění. Identifikátor URI musí povolit přístup pro čtení, aby služba Service Fabric mohla soubor stáhnout. Soubor sfpkg je zip, který obsahuje počáteční balíček aplikace. Uvnitř souboru ZIP lze balíček aplikace komprimovat nebo nekomprimovat. Komprese balíčku aplikace uvnitř zip se provádí v kódu, balíčku a datových balíčcích. Tuto kompresi lze dosáhnout pomocí copy-ServiceFabricApplicationPackage s přepínačem -CompressPackage. Soubor sfpkg musí mít příponu .sfpkg.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationPathInImageStore

Určuje relativní cestu balíčku typu aplikace v úložišti imagí. Tuto cestu určila rutina Copy-ServiceFabricApplicationPackage při zkopírování balíčku aplikace do úložiště imagí.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeName

Určuje název typu aplikace, jak je definován v manifestu aplikace. Název typu aplikace a verze typu aplikace jednoznačně identifikují typ aplikace. To je potřeba při zřizování sfpkg z externího úložiště.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeVersion

Určuje verzi typu aplikace, jak byla definována v manifestu aplikace. Název typu aplikace a verze typu aplikace jednoznačně identifikují typ aplikace. To je potřeba při zřizování sfpkg souboru balíčku aplikace z externího úložiště.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Async

Příkaz se vrátí, jakmile cluster přijme žádost o registraci. Pomocí příkazu Get-ServiceFabricApplicationType zadejte dotaz na stav žádosti o registraci. Pomocí tohoto přepínače se nemusíte při registraci velkých balíčků aplikací zadávat velké hodnoty -TimeoutSec.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

Určuje časový limit operace v sekundách.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Výstupy

System.Object