Register-ServiceFabricApplicationType

  • Referens
Modul:
ServiceFabric

Registrerar en Service Fabric-programtyp.

Syntax

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

Description

Cmdleten Register-ServiceFabricApplicationType registrerar en Service Fabric-programtyp. Läs mer om distribution av Service Fabric-program.

Programpaketet kan finnas på en relativ plats i avbildningsarkivet eller vara en sfpkg fil som tidigare laddats upp till en extern plats.

När du använder den relativa sökvägen för arkivet måste programpaketet finnas i avbildningsarkivet. Paketet kan kopieras till avbildningsarkivet med Copy-ServiceFabricApplicationPackage.

När du använder en sfpkg fil från ett externt arkiv måste etableringen tillhandahålla nedladdnings-URI:n till den plats där den sfpkg tidigare laddades upp, samt information om programtyp. Filen sfpkg är en zip som innehåller det ursprungliga programpaketet och har tillägget ".sfpkg". I zip-filen kan programpaketet komprimeras eller okomprimeras. Komprimering av programpaketet i zip görs på kod-, paket- och datapaket.

Om du vill skapa en sfpkgbörjar du med en mapp som innehåller det ursprungliga programpaketet. Om det behövs komprimerar du paketet med Copy-ServiceFabricApplicationPackage med växlarna -CompressPackage och -SkipCopy. Använd sedan ett verktyg för att zippa mappen med tillägget ".sfpkg". Använd till exempel ZipFile.CreateFromDirectory i programpaketmappen.

När du har registrerat en programtyp kan du använda cmdleten New-ServiceFabricApplication för att skapa en programinstans. Använd cmdleten Start-ServiceFabricApplicationUpgrade för att uppgradera ett befintligt program.

När programtypen med den angivna versionen inte längre behövs kan du avregistrera den med cmdleten Unregister-ServiceFabricApplicationType .

Om du vill hantera Service Fabric-kluster startar du Windows PowerShell med alternativet Kör som administratör. Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster .

Exempel

Exempel 1: Registrera en programtyp med relativ sökväg för bildarkiv

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

Copy-ServiceFabricApplicationPackage kopierar programpaketet som finns i mappen "c:\work\PersistentToDoListService" till avbildningsarkivet. Paketet kopieras på den relativa sökvägen "PersistentToDoListService" i bildarkivet.

Register-ServiceFabricApplicationType-kommandot registrerar programtypen som finns i den relativa sökvägen "PersistentToDoListService".

Exempel 2: Registrera en programtyp med asynkron sökväg för bildarkiv

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 kopierar programpaketet som finns i mappen "c:\work\PersistentToDoListService" till avbildningsarkivet. Programpaketet kopieras på den relativa sökvägen "PersistentToDoListService" i bildarkivet. Cmdleten använder komprimering för att minska paketstorleken.

Register-ServiceFabricApplicationType-kommandot registrerar programtypen som finns i den relativa sökvägen "PersistentToDoListService". Registreringen görs asynkron och returneras så snart kommandot godkänns av klustret.

Get-ServiceFabricApplicationType hämtar de programtyper som är registrerade i klustret. Varje programtyp innehåller registreringsstatus. Cmdleten kan användas för att avgöra när registreringen har slutförts.

Exempel 3: Registrera en programtyp för ett stort programpaket med relativ sökväg för avbildningsarkiv

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 kopierar programpaketet som finns i mappen "c:\work\PersistentToDoListService" till avbildningsarkivet på den relativa platsen för avbildningsarkivet "PersistentToDoListService". Eftersom det ursprungliga paketet är mycket stort komprimerar kommandot det och innehåller en högre tidsgräns för att ge tillräckligt med tid för kopiering.

Register-ServiceFabricApplicationType-kommandot registrerar programtypen som finns i den relativa sökvägen "PersistentToDoListService". Kommandot innehåller en högre tidsgräns så att arbetet kan slutföras även om programpaketet är stort.

Exempel 4: Registrera en programtyp från ett externt arkiv

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

Registrerar programpaketet som finns på angiven URI. Programpaketet måste ha laddats upp tidigare på den platsen och måste tillåta LÄS-åtkomst. Eftersom paketet kan vara stort anger kommandot en stor tidsgräns för etablering.

Exempel 5: Registrera en programtyp från en asynkron extern lagring

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

Registrerar programpaketet som finns på angiven URI. Programpaketet måste ha laddats upp tidigare på den platsen och måste tillåta LÄS-åtkomst. Eftersom -Async har angetts returnerar kommandot så snart klustret accepterar det. Get-ServiceFabricApplicationType hämtar de programtyper som är registrerade i klustret som matchar filtret. Varje programtyp innehåller registreringsstatus. Cmdleten kan användas för att följa registreringens förlopp och för att avgöra när registreringen slutförs.

Exempel 6: Registrera en programtyp med relativ sökväg för avbildningsarkiv och automatisk rensning av paket

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.

Parametrar

-ApplicationPackageCleanupPolicy

Avgör rensningsprincipen för det programpaket som används för att registrera programtypen. Om de inte rensas förbrukar programpaketen diskutrymme och kan leda till fel. Den här parametern anger hur du hanterar programpaketet när programtypen har registrerats (lyckad etablering).

När det är inställt på Automaticavgör Service Fabric-körningen när programpaketet ska rensas. Den aktuella körningsimplementeringen tar bort programpaketet när programtypen har registrerats. Om registreringen misslyckas tas inte programpaketet bort från avbildningsarkivet.

När det är inställt på Manualtas inte programpaketet bort från avbildningsarkivet och användarna måste uttryckligen anropa cmdleten Remove-ServiceFabricApplicationPackage för att ta bort det från avbildningsarkivet.

Ett Service Fabric-kluster konfigureras med en rensningsprincip. Om du vill använda klustrets princip anger du Default alternativet . Klusterkonfigurationen CleanupApplicationPackageOnProvisionSuccess i Management avsnittet bestämmer hur rensningen ska ske. Om värdet är true tas programpaketen automatiskt bort av Service Fabric-körningen efter att etableringen har slutförts. Om värdet är falskt tas inte programpaketet bort från avbildningsarkivet. Standardvärdet för den här klusterkonfigurationen har angetts till falskt upp till v6.4, men det finns planer på att ställa in det på sant för framtida versioner.

Type:ApplicationPackageCleanupPolicy
Accepted values:Invalid, Default, Automatic, Manual
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationPackageDownloadUri

Representerar sökvägen till sfpkg programpaketet där programpaketet kan laddas ned med hjälp av HTTP- eller HTTPS-protokoll. Paketet måste ha laddats upp tidigare till den här externa platsen. URI:n måste tillåta READ-åtkomst så att Service Fabric kan ladda ned filen. Filen sfpkg är en zip som innehåller det första programpaketet. I zip-filen kan programpaketet komprimeras eller okomprimeras. Komprimering av programpaketet i zip görs på kod-, paket- och datapaket. Den här komprimering kan uppnås med hjälp av Copy-ServiceFabricApplicationPackage med växeln -CompressPackage. Filen sfpkg måste ha tillägget ".sfpkg".

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

-ApplicationPathInImageStore

Anger den relativa sökvägen för programtypspaketet i avbildningsarkivet. Den här sökvägen angavs av cmdleten Copy-ServiceFabricApplicationPackage när programpaketet kopierades till avbildningsarkivet.

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

-ApplicationTypeName

Anger namnet på programtypen, som det definieras i programmanifestet. Programtypens namn och programtypsversionen identifierar unikt programtypen. Detta behövs när du etablerar en sfpkg från ett externt arkiv.

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

-ApplicationTypeVersion

Anger programtypens version, som den definierades i programmanifestet. Programtypens namn och programtypsversionen identifierar unikt programtypen. Detta krävs när du etablerar en sfpkg programpaketfil från ett externt arkiv.

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

-Async

Kommandot returneras så snart registreringsbegäran godkänns av klustret. Använd kommandot Get-ServiceFabricApplicationType för att fråga status för registreringsbegäran. Med den här växeln undviker du att behöva ange stora timeoutSec-värden när stora programpaket registreras.

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

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

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

Indata

None

Utdata

System.Object