Dela via

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 lagringsrelativ sökväg 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 sfpkg tidigare laddades upp samt information om programtyp. Den sfpkg filen är en zip som innehåller det första programpaketet och har tillägget ".sfpkg". Inuti zip-filen kan programpaketet komprimeras eller okomprimeras. Komprimering av programpaketet i zip görs i 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äxlar -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 hjälp av 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 avbildningsarkivet.

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 avbildningsarkivet. Cmdleten använder komprimering för att minska paketstorleken.

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

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

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å den angivna URI:n. 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å den angivna URI:n. Programpaketet måste ha laddats upp tidigare på den platsen och måste tillåta LÄS-åtkomst. Eftersom -Async har angetts returneras kommandot så snart klustret accepterar det. Get-ServiceFabricApplicationType hämtar de programtyper som registrerats 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 har slutförts.

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 service fabric-körningen är inställd på Automaticavgörs 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 Remove-ServiceFabricApplicationPackage cmdlet 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 alternativ. Klusterkonfigurationen CleanupApplicationPackageOnProvisionSuccess under avsnittet Management avgör hur rensningen ska ske. Om värdet är true tas programpaketen bort automatiskt av Service Fabric-körningen efter en lyckad etablering. 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.

Typ:ApplicationPackageCleanupPolicy
Godkända värden:Invalid, Default, Automatic, Manual
Position:Named
Standardvärde:Default
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationPackageDownloadUri

Representerar sökvägen till sfpkg programpaket 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 LÄS-åtkomst så att Service Fabric kan ladda ned filen. Filen sfpkg är en zip som innehåller det första programpaketet. Inuti zip-filen kan programpaketet komprimeras eller okomprimeras. Komprimering av programpaketet i zip görs i kod-, paket- och datapaket. Den här komprimering kan uppnås med Copy-ServiceFabricApplicationPackage med växeln -CompressPackage. Filen sfpkg måste ha tillägget ".sfpkg".

Typ:Uri
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationTypeName

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationTypeVersion

Anger programtypsversionen, 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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Async

Kommandot returnerar så snart registreringsbegäran godkänns av klustret. Använd kommandot Get-ServiceFabricApplicationType för att fråga efter status för registreringsbegäran. Med den här växeln slipper du ange stora -TimeoutSec värden när du registrerar stora programpaket.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

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

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

System.Object