Sdílet prostřednictvím

Register-ServiceFabricApplicationType

  • Reference
Modul:
ServiceFabric

Zaregistruje typ aplikace Service Fabric.

Syntaxe

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 soubor sfpkg dříve nahraný do externího umístění.

Pokud používáte relativní cestu k úložišti, 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í souboru sfpkg z externího úložiště musí zřízení poskytnout identifikátor URI pro stahování, do kterého se dříve nahrál sfpkg, 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 může být balíček aplikace komprimován nebo nekomprimován. 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, začněte složkou, která obsahuje původní balíček aplikace. V případě potřeby komprimujte balíček pomocí Copy-ServiceFabricApplicationPackage s přepínači -CompressPackage a -SkipCopy. Pak pomocí nástroje zazipujte složku s příponou ".sfpkg". Například použijte ZipFile.CreateFromDirectory ve složce balíčku aplikace.

Po registraci typu aplikace můžete k vytvoření instance aplikace použít rutinu New-ServiceFabricApplication. K upgradu existující aplikace použijte rutinu Start-ServiceFabricApplicationUpgrade.

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 v relativní cestě 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ě imagí. Balíček se zkopíruje do relativní cesty PersistentToDoListService v úložišti imagí.

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

Příklad 2: Registrace typu aplikace s relativní cestou k úložišti imagí

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ě imagí. Balíček aplikace se zkopíruje do relativní cesty PersistentToDoListService v úložišti imagí. Rutina pomocí komprese zmenšuje velikost balíčku.

Register-ServiceFabricApplicationType příkaz registruje typ aplikace nalezený v relativní cestě PersistentToDoListService. Zaregistruje se 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 zahrnuje stav registrace. Pomocí této rutiny můžete určit, 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ě imagí v relativním umístění úložiště obrázků PersistentToDoListService. Vzhledem k tomu, že je počáteční balíček velmi velký, příkaz ho zkomprimuje a obsahuje vyšší časový limit, který umožňuje dostatek času pro kopírování.

Register-ServiceFabricApplicationType příkaz registruje typ aplikace nalezený v relativní cestě PersistentToDoListService. Příkaz obsahuje vyšší časový limit, který umožní 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 pro č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 pro čtení. Vzhledem k tomu, -Async je zadán, 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 zahrnuje 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 imagí 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ásady 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 Automaticurčuje modul runtime Service Fabric, kdy provést vyčištění balíčku aplikace. Aktuální implementace modulu runtime odstraní balíček aplikace po úspěšné registraci typu aplikace. Pokud se registrace nezdaří, balíček aplikace se z úložiště imagí neodstraní.

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

Cluster Service Fabric je nakonfigurovaný se zásadami vyčištění. Pokud chcete použít zásady clusteru, zadejte možnost Default. Konfigurace clusteru CleanupApplicationPackageOnProvisionSuccess v části Management 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 je nastavená na hodnotu false až v6.4, ale pro budoucí verze je potřeba ji nastavit na true.

Typ:ApplicationPackageCleanupPolicy
Přípustné hodnoty:Invalid, Default, Automatic, Manual
Position:Named
Default value:Default
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationPackageDownloadUri

Představuje cestu k balíčku aplikace sfpkg, 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 může být balíček aplikace komprimován nebo nekomprimován. 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".

Typ:Uri
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationPathInImageStore

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

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeName

Určuje název typu aplikace, protože 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ě.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeVersion

Určuje verzi typu aplikace, která 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í souboru balíčku aplikace sfpkg z externího úložiště.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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. Při použití tohoto přepínače není nutné při registraci velkých balíčků aplikací zadávat velké -TimeoutSec hodnoty.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeoutSec

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

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

System.Object