Register-ServiceFabricApplicationType

Service Fabric uygulama türünü kaydeder.

Sözdizimi

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ü deposunda göreli bir konumda bulunabilir veya daha önce bir dış konuma yüklenmiş sfpkg dosyası olabilir.

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

Bir dış depodan sfpkg dosyası kullanılırken, sağlamanın sfpkg daha önce karşıya yüklendiği indirme URI'sini ve uygulama türü bilgilerini sağlaması gerekir. sfpkg dosyası, 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. Zip içindeki uygulama paketinin sıkıştırması kod, paket ve veri paketlerinde yapılır.

sfpkgoluşturmak için, özgün uygulama paketini içeren bir klasörle başlayın. Gerekirse, -CompressPackage ve -SkipCopy anahtarlarıyla Copy-ServiceFabricApplicationPackage paketi 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, 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'i başlatın. Service Fabric kümesinde herhangi bir işlem yapmadan ö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 yapılmaz 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 tamamleneceğini 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ü 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 OKUMA 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 OKUMA erişimine izin vermesi gerekir. -Async belirtildiğinden, komut küme bunu kabul eder etmez 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 neden olabilir. Bu parametre, uygulama türünü başarıyla kaydettikten (başarılı sağlama) sonra uygulama paketinin nasıl yönetileceğini belirtir.

Automaticolarak ayarlandığında Service 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.

Manualolarak ayarlandığında, 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 Default seçeneğini belirtin. CleanupApplicationPackageOnProvisionSuccess küme yapılandırması , temizleme işleminin nasıl gerçekleşeceğini belirler. true olarak ayarlanırsa, uygulama paketleri başarıyla sağlandıktan sonra 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 true olarak ayarlama planları vardır.

Tür:ApplicationPackageCleanupPolicy
Kabul edilen değerler:Invalid, Default, Automatic, Manual
Position:Named
Default value:Default
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ApplicationPackageDownloadUri

Http veya HTTPS protokolleri kullanılarak uygulama paketinin indirilebildiği sfpkg 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. sfpkg dosyası, 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. Zip içindeki uygulama paketinin sıkıştırması kod, paket ve veri paketlerinde yapılır. Bu sıkıştırma, -CompressPackage anahtarıyla Copy-ServiceFabricApplicationPackage kullanılarak elde edilebilir. sfpkg dosyasının uzantısı ".sfpkg" olmalıdır.

Tür:Uri
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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, dış depodan bir sfpkg sağlarken gereklidir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 sfpkg uygulama paketi dosyası sağlanırken gereklidir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Async

Komut, kayıt isteği küme tarafından kabul edilir kabul edilir etmez geri döner. 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 kalmamasını sağlar.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TimeoutSec

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

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Çıkışlar

System.Object