Share via

Register-ServiceFabricApplicationType

  • Referencia
Modul:
ServiceFabric

Service Fabric-alkalmazástípust regisztrál.

Syntax

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

Description

A Register-ServiceFabricApplicationType parancsmag egy Service Fabric-alkalmazástípust regisztrál. További információ a Service Fabric-alkalmazások üzembe helyezéséről.

Az alkalmazáscsomag létezhet egy relatív helyen a képtárolóban, vagy lehet egy sfpkg korábban egy külső helyre feltöltött fájl.

Tároló relatív elérési útjának használatakor az alkalmazáscsomagnak léteznie kell a lemezképtárolóban. A csomag a Copy-ServiceFabricApplicationPackage használatával másolható a képtárolóba.

Külső tárolóból származó fájl használatakor sfpkg a kiépítésnek meg kell adnia a letöltési URI-t arra a helyre, ahová korábban feltöltötték, sfpkg valamint az alkalmazás típusadatait. A sfpkg fájl egy zip, amely tartalmazza a kezdeti alkalmazáscsomagot, és a kiterjesztése ".sfpkg". A zip-fájlon belül az alkalmazáscsomag tömöríthető vagy tömörítetlen is lehet. Az alkalmazáscsomag tömörítése a zip-fájlban kód, csomag és adatcsomagok használatával történik.

Hozzon létre egy sfpkgmappát, amely az eredeti alkalmazáscsomagot tartalmazza. Szükség esetén tömörítse a csomagot a Copy-ServiceFabricApplicationPackage és a -CompressPackage és a -SkipCopy kapcsolókkal. Ezután egy segédprogrammal tömörítse a mappát ".sfpkg" kiterjesztéssel. Használja például a ZipFile.CreateFromDirectory parancsot az alkalmazáscsomag mappájában.

Az alkalmazástípus regisztrálása után a New-ServiceFabricApplication parancsmaggal létrehozhat egy alkalmazáspéldányt. Meglévő alkalmazás frissítéséhez használja a Start-ServiceFabricApplicationUpgrade parancsmagot.

Ha a megadott verziójú alkalmazástípusra már nincs szükség, az Unregister-ServiceFabricApplicationType parancsmaggal törölheti a regisztrációt.

A Service Fabric-fürtök kezeléséhez indítsa el a Windows PowerShell a Futtatás rendszergazdaként lehetőséggel. Mielőtt bármilyen műveletet végrehajt egy Service Fabric-fürtön, hozzon létre kapcsolatot a fürttel a Connect-ServiceFabricCluster parancsmag használatával.

Példák

1. példa: Alkalmazástípus regisztrálása a képtároló relatív elérési útjával

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

A Copy-ServiceFabricApplicationPackage a "c:\work\PersistentToDoListService" mappában található alkalmazáscsomagot a képtárolóba másolja. A csomag másolása a képtároló "PersistentToDoListService" relatív útvonalán történik.

A Register-ServiceFabricApplicationType parancs regisztrálja a "PersistentToDoListService" relatív elérési úton található alkalmazástípust.

2. példa: Alkalmazástípus regisztrálása a képtároló relatív elérési útjának aszinkron használatával

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

A Copy-ServiceFabricApplicationPackage a "c:\work\PersistentToDoListService" mappában található alkalmazáscsomagot a képtárolóba másolja. Az alkalmazáscsomagot a rendszer a képtároló "PersistentToDoListService" relatív elérési útjára másolja. A parancsmag tömörítéssel csökkenti a csomag méretét.

A Register-ServiceFabricApplicationType parancs regisztrálja a "PersistentToDoListService" relatív elérési úton található alkalmazástípust. A regisztráció aszinkron módon történik, és amint a fürt elfogadja a parancsot, visszatér.

A Get-ServiceFabricApplicationType lekéri a fürtben regisztrált alkalmazástípusokat. Minden alkalmazástípus tartalmazza a regisztrációs állapotot. A parancsmaggal megállapítható, hogy mikor fejeződik be a regisztráció.

3. példa: Alkalmazástípus regisztrálása nagyméretű alkalmazáscsomaghoz a képtároló relatív elérési útjával

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

A Copy-ServiceFabricApplicationPackage a "c:\work\PersistentToDoListService" mappában található alkalmazáscsomagot a rendszerképtárba másolja a "PersistentToDoListService" képtároló relatív helyén. Mivel a kezdeti csomag nagyon nagy, a parancs tömöríti, és nagyobb időtúllépést tartalmaz, hogy elegendő időt hagyjon a másolásra.

A Register-ServiceFabricApplicationType parancs regisztrálja a "PersistentToDoListService" relatív elérési úton található alkalmazástípust. A parancs nagyobb időtúllépést tartalmaz, így a munka akkor is befejeződhet, ha az alkalmazáscsomag nagy.

4. példa: Alkalmazástípus regisztrálása külső tárolóból

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

Regisztrálja a megadott URI-n található alkalmazáscsomagot. Az alkalmazáscsomagot korábban fel kell tölteni ezen a helyen, és engedélyeznie kell az OLVASÁSi hozzáférést. Mivel a csomag nagy méretű lehet, a parancs nagy kiépítési időtúllépést határoz meg.

5. példa: Alkalmazástípus regisztrálása külső tárolószinkronizálásból

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

Regisztrálja a megadott URI-n található alkalmazáscsomagot. Az alkalmazáscsomagot korábban fel kell tölteni ezen a helyen, és engedélyeznie kell az OLVASÁSi hozzáférést. Mivel az -Async meg van adva, a parancs azonnal visszatér, amint a fürt elfogadja. A Get-ServiceFabricApplicationType lekéri a szűrőnek megfelelő alkalmazástípusokat a fürtben. Minden alkalmazástípus tartalmazza a regisztrációs állapotot. A parancsmaggal nyomon követheti a regisztrációs folyamatot, és meghatározhatja, hogy mikor fejeződik be a regisztráció.

6. példa: Alkalmazástípus regisztrálása a képtároló relatív elérési útjával és az automatikus csomagkarbantartóval

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.

Paraméterek

-ApplicationPackageCleanupPolicy

Meghatározza az alkalmazástípus regisztrálásához használt alkalmazáscsomag törlési szabályzatát. Ha nem távolítja el, az alkalmazáscsomagok lemezterületet használnak fel, és hibákhoz vezethetnek. Ez a paraméter azt határozza meg, hogyan kezelhető az alkalmazáscsomag az alkalmazástípus sikeres regisztrálása (sikeres kiépítés) után.

Ha be van állítva, a AutomaticService Fabric-futtatókörnyezet határozza meg, hogy mikor végezze el az alkalmazáscsomagok törlését. A futtatókörnyezet jelenlegi implementációja törli az alkalmazáscsomagot az alkalmazástípus sikeres regisztrálása után. Ha a regisztráció sikertelen, az alkalmazáscsomag nem törlődik a lemezképtárolóból.

Ha be van állítva Manual, az alkalmazáscsomag nem törlődik a lemezképtárolóból, és a felhasználóknak explicit módon meg kell hívniuk a Remove-ServiceFabricApplicationPackage parancsmagot, hogy eltávolítsák a lemezképtárolóból.

A Service Fabric-fürtök karbantartási szabályzattal konfigurálhatók. A fürt házirendjének használatához adja meg Default a beállítást. A szakasz alatt Management található CleanupApplicationPackageOnProvisionSuccess fürtkonfiguráció határozza meg a törlés módját. Ha igaz értékre van állítva, a Service Fabric-futtatókörnyezet automatikusan törli az alkalmazáscsomagokat a sikeres kiépítés után. Ha false (hamis) értékre van állítva, az alkalmazáscsomag nem törlődik a lemezképtárolóból. A fürtkonfiguráció alapértelmezett értéke false (hamis) értékre lett beállítva a 6.4-es verzióig, de a tervek szerint igaz értékre állítja a jövőbeli kiadásokban.

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

-ApplicationPackageDownloadUri

Az alkalmazáscsomag elérési útját sfpkg jelöli, ahonnan az alkalmazáscsomag LETÖLTHETŐ HTTP- vagy HTTPS-protokollokkal. A csomagot korábban fel kellett tölteni erre a külső helyre. Az URI-nak engedélyeznie kell a READ-hozzáférést, hogy a Service Fabric letölthesse a fájlt. A sfpkg fájl egy zip, amely a kezdeti alkalmazáscsomagot tartalmazza. A zip-fájlon belül az alkalmazáscsomag tömöríthető vagy tömörítetlen is lehet. Az alkalmazáscsomag tömörítése a zip-fájlban kód, csomag és adatcsomagok használatával történik. Ez a tömörítés a Copy-ServiceFabricApplicationPackage és a -CompressPackage kapcsoló használatával érhető el. A sfpkg fájlnak ".sfpkg" kiterjesztésűnek kell lennie.

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

-ApplicationPathInImageStore

Megadja az alkalmazástípus-csomag relatív elérési útját a képtárolóban. Ezt az elérési utat a Copy-ServiceFabricApplicationPackage parancsmag adta meg, amikor az alkalmazáscsomagot átmásolta a képtárolóba.

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

-ApplicationTypeName

Megadja az alkalmazástípus nevét, mivel az az alkalmazásjegyzékben van definiálva. Az alkalmazástípus neve és az alkalmazástípus verziója egyedileg azonosítja az alkalmazástípust. Erre akkor van szükség, ha külső tárolóból épít ki egy sfpkg tárolót.

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

-ApplicationTypeVersion

Megadja az alkalmazástípus verzióját, mivel az az alkalmazásjegyzékben lett definiálva. Az alkalmazástípus neve és az alkalmazástípus verziója egyedileg azonosítja az alkalmazástípust. Erre akkor van szükség, ha alkalmazáscsomag-fájlt sfpkg épít ki egy külső tárolóból.

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

-Async

A parancs azonnal visszatér, amint a fürt elfogadja a regisztrációs kérést. A Get-ServiceFabricApplicationType paranccsal kérdezheti le a regisztrációs kérelem állapotát. Ezzel a kapcsolóval nem kell nagy -TimeoutSec értékeket megadnia a nagy alkalmazáscsomagok regisztrálásakor.

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

-TimeoutSec

A művelet időtúllépési időtartamát adja meg másodpercben.

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

Bevitelek

None

Kimenetek

System.Object