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.
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.
sfpkg
oluş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
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.
Automatic
olarak 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.
Manual
olarak 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
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
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