Register-ServiceFabricApplicationType
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 sfpkg
slož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