Register-ServiceFabricApplicationType

  • Başvuru
Modül:
ServiceFabric

Service Fabric uygulama türünü kaydeder.

Syntax

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

Description

Register-ServiceFabricApplicationType cmdlet'i bir Service Fabric uygulama türü kaydeder. Service Fabric uygulama dağıtımı hakkında daha fazla bilgi edinin.

Uygulama paketi görüntü deposundaki göreli bir konumda bulunabilir veya daha önce bir dış konuma yüklenmiş bir dosya olabilir sfpkg .

Depolama göreli yolu kullanılırken, uygulama paketinin görüntü deposunda mevcut olması gerekir. Paket , Copy-ServiceFabricApplicationPackage ile görüntü deposuna kopyalanabilir.

Dış depodan bir sfpkg dosya kullanılırken, sağlamanın daha önce karşıya yüklendiği yere sfpkg indirme URI'sini ve uygulama türü bilgilerini sağlaması gerekir. Dosya sfpkg , ilk uygulama paketini içeren ve ".sfpkg" uzantısına sahip bir zip dosyasıdır. Zip içinde uygulama paketi sıkıştırılabilir veya sıkıştırılamaz. Uygulama paketinin zip içindeki sıkıştırma işlemi kod, paket ve veri paketlerinde gerçekleştirilir.

oluşturmak sfpkgiçin özgün uygulama paketini içeren bir klasörle başlayın. Gerekirse, paketi Copy-ServiceFabricApplicationPackage ile -CompressPackage ve -SkipCopy anahtarlarıyla sıkıştırın. Ardından, ".sfpkg" uzantısına sahip klasörü sıkıştırmak için bir yardımcı program kullanın. Örneğin, uygulama paketi klasöründe ZipFile.CreateFromDirectory kullanın.

Bir uygulama türünü kaydettikten sonra, bir uygulama örneği oluşturmak için New-ServiceFabricApplication cmdlet'ini kullanabilirsiniz. Mevcut bir uygulamayı yükseltmek için Start-ServiceFabricApplicationUpgrade cmdlet'ini kullanın.

Belirtilen sürüme sahip uygulama türüne artık ihtiyaç duyulmadığında, Unregister-ServiceFabricApplicationType cmdlet'ini kullanarak kaydı kaldırabilirsiniz.

Service Fabric kümelerini yönetmek için Yönetici olarak çalıştır seçeneğini kullanarak Windows PowerShell başlatın. Service Fabric kümesinde herhangi bir işlem gerçekleştirmeden önce Connect-ServiceFabricCluster cmdlet'ini kullanarak kümeyle bağlantı kurun.

Örnekler

Örnek 1: Bir uygulama türünü görüntü deposu göreli yoluna kaydetme

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

Copy-ServiceFabricApplicationPackage , "c:\work\PersistentToDoListService" klasöründe bulunan uygulama paketini görüntü deposuna kopyalar. Paket, görüntü deposundaki "PersistentToDoListService" göreli yoluna kopyalanır.

Register-ServiceFabricApplicationType komutu, "PersistentToDoListService" göreli yolunda bulunan uygulama türünü kaydeder.

Örnek 2: Bir uygulama türünü görüntü deposu göreli yolu zaman uyumsuz olarak kaydetme

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 , "c:\work\PersistentToDoListService" klasöründe bulunan uygulama paketini görüntü deposuna kopyalar. Uygulama paketi, görüntü deposundaki "PersistentToDoListService" göreli yoluna kopyalanır. Cmdlet, paket boyutunu küçültmek için sıkıştırmayı kullanır.

Register-ServiceFabricApplicationType komutu, "PersistentToDoListService" göreli yolunda bulunan uygulama türünü kaydeder. Kayıt işlemi zaman uyumsuz olarak yapılır ve komut küme tarafından kabul edilir kabul edilir edilmezse geri döner.

Get-ServiceFabricApplicationType , kümede kayıtlı uygulama türlerini alır. Her uygulama türü kayıt durumunu içerir. Cmdlet, kaydın ne zaman tamamlanmasını belirlemek için kullanılabilir.

Örnek 3: Görüntü deposu göreli yolu ile büyük bir uygulama paketi için uygulama türünü kaydetme

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 , "c:\work\PersistentToDoListService" klasöründe bulunan uygulama paketini "PersistentToDoListService" görüntü deposu göreli konumundaki görüntü deposuna kopyalar. İlk paket çok büyük olduğundan, komut onu sıkıştırır ve kopyalama için yeterli zaman aşımına izin vermek için daha yüksek bir zaman aşımı içerir.

Register-ServiceFabricApplicationType komutu, "PersistentToDoListService" göreli yolunda bulunan uygulama türünü kaydeder. Komut, uygulama paketi büyük olsa bile çalışmanın bitebilmesi için daha yüksek bir zaman aşımı içerir.

Örnek 4: Dış depodan uygulama türü kaydetme

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

Belirtilen URI'de bulunan uygulama paketini kaydeder. Uygulama paketinin daha önce bu konuma yüklenmiş olması ve READ erişimine izin vermesi gerekir. Paket büyük olabileceğinden, komutu büyük bir sağlama zaman aşımı belirtir.

Örnek 5: Zaman uyumsuz bir dış depodan uygulama türü kaydetme

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

Belirtilen URI'de bulunan uygulama paketini kaydeder. Uygulama paketinin daha önce bu konuma yüklenmiş olması ve READ erişimine izin vermesi gerekir. -Async belirtildiğinden, komut küme kabul eder almaz döndürür. Get-ServiceFabricApplicationType , filtreyle eşleşen kümede kayıtlı uygulama türlerini alır. Her uygulama türü kayıt durumunu içerir. Cmdlet, kayıt ilerleme durumunu izlemek ve kaydın ne zaman tamamlanıp tamamlanmadığını belirlemek için kullanılabilir.

Örnek 6: Bir uygulama türünü görüntü deposu göreli yolu ve otomatik paket temizleme ile kaydetme

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.

Parametreler

-ApplicationPackageCleanupPolicy

Uygulama türünü kaydetmek için kullanılan uygulama paketinin temizleme ilkesini belirler. Temizlenmezse, uygulama paketleri disk alanı kullanır ve hatalara yol açabilir. Bu parametre, uygulama türünü (başarılı sağlama) kaydettikten sonra uygulama paketinin nasıl yönetileceğini belirtir.

olarak ayarlandığında AutomaticService Fabric çalışma zamanı, uygulama paketi temizleme işleminin ne zaman gerçekleştirileceğini belirler. Geçerli çalışma zamanı uygulaması, uygulama türünü başarıyla kaydettikten sonra uygulama paketini siler. Kayıt başarısız olursa uygulama paketi görüntü deposundan silinmez.

olarak ayarlandığında Manual, uygulama paketi görüntü deposundan silinmez ve kullanıcıların görüntü deposundan kaldırmak için Remove-ServiceFabricApplicationPackage cmdlet'ini açıkça çağırması gerekir.

Service Fabric kümesi temizleme ilkesiyle yapılandırılır. Kümenin ilkesini kullanmak için seçeneğini belirtin Default . Bölümün altındaki CleanupApplicationPackageOnProvisionSuccess küme yapılandırması, temizleme işleminin nasıl gerçekleşmesi gerektiğini belirler.Management true olarak ayarlanırsa, başarılı sağlama sonrasında uygulama paketleri service fabric çalışma zamanı tarafından otomatik olarak silinir. false olarak ayarlanırsa, uygulama paketi görüntü deposundan silinmez. Bu küme yapılandırmasının varsayılan değeri v6.4'e kadar false olarak ayarlanmıştır, ancak gelecek sürümler için bunu true olarak ayarlama planları vardır.

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

-ApplicationPackageDownloadUri

Uygulama paketinin sfpkg HTTP veya HTTPS protokolleri kullanılarak indirilebildiği uygulama paketinin yolunu temsil eder. Paket daha önce bu dış konuma yüklenmiş olmalıdır. Service Fabric'in dosyayı indirebilmesi için URI'nin OKUMA erişimine izin vermesi gerekir. Dosya, sfpkg ilk uygulama paketini içeren bir zip dosyasıdır. Zip içinde uygulama paketi sıkıştırılabilir veya sıkıştırılamaz. Uygulama paketinin zip içindeki sıkıştırma işlemi kod, paket ve veri paketlerinde gerçekleştirilir. Bu sıkıştırma, -CompressPackage anahtarıyla Copy-ServiceFabricApplicationPackage kullanılarak elde edilebilir. Dosya " sfpkg .sfpkg" uzantısına sahip olmalıdır.

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

-ApplicationPathInImageStore

Görüntü deposundaki uygulama türü paketinin göreli yolunu belirtir. Bu yol, uygulama paketi görüntü deposuna kopyalandığında Copy-ServiceFabricApplicationPackage cmdlet'i tarafından belirtildi.

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

-ApplicationTypeName

Uygulama bildiriminde tanımlandığı gibi uygulama türü adını belirtir. Uygulama türü adı ve uygulama türü sürümü, uygulama türünü benzersiz olarak tanımlar. Bu, bir dış depodan sağlama sfpkg sırasında gereklidir.

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

-ApplicationTypeVersion

Uygulama bildiriminde tanımlandığı gibi uygulama türü sürümünü belirtir. Uygulama türü adı ve uygulama türü sürümü, uygulama türünü benzersiz olarak tanımlar. Bu, bir dış depodan uygulama sfpkg paketi dosyası sağlarken gereklidir.

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

-Async

Kayıt isteği küme tarafından kabul edilir edilmezse komut döndürülur. Kayıt isteğinin durumunu sorgulamak için Get-ServiceFabricApplicationType komutunu kullanın. Bu anahtarın kullanılması, büyük uygulama paketlerini kaydederken büyük -TimeoutSec değerleri sağlamak zorunda kalmamayı sağlar.

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

-TimeoutSec

İşlem için zaman aşımı süresini saniye cinsinden belirtir.

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

Girişler

None

Çıkışlar

System.Object