Bagikan melalui

Register-ServiceFabricApplicationType

  • Referensi
Modul:
ServiceFabric

Mendaftarkan jenis aplikasi Service Fabric.

Sintaks

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

Deskripsi

Cmdlet Register-ServiceFabricApplicationType mendaftarkan jenis aplikasi Service Fabric. Baca selengkapnya tentang penyebaran aplikasi Service Fabric.

Paket aplikasi dapat ada di lokasi relatif di penyimpanan citra atau dapat menjadi file yang sfpkg sebelumnya diunggah ke lokasi eksternal.

Saat menggunakan jalur relatif toko, paket aplikasi harus ada di penyimpanan citra. Paket dapat disalin ke penyimpanan citra dengan Copy-ServiceFabricApplicationPackage.

Saat menggunakan sfpkg file dari penyimpanan eksternal, penyediaan harus menyediakan URI unduhan sfpkg ke tempat yang sebelumnya diunggah, serta informasi jenis aplikasi. File sfpkg adalah zip yang berisi paket aplikasi awal dan memiliki ekstensi ".sfpkg". Di dalam zip, paket aplikasi dapat dikompresi atau tidak dikompresi. Pemadatan paket aplikasi di dalam zip dilakukan pada paket kode, paket, dan data.

Untuk membuat sfpkg, mulailah dengan folder yang berisi paket aplikasi asli. Jika diperlukan, kompres paket dengan Copy-ServiceFabricApplicationPackage dengan sakelar -CompressPackage dan -SkipCopy. Kemudian, gunakan utilitas untuk zip folder dengan ekstensi ".sfpkg". Misalnya, gunakan ZipFile.CreateFromDirectory pada folder paket aplikasi.

Setelah mendaftarkan jenis aplikasi, Anda dapat menggunakan cmdlet New-ServiceFabricApplication untuk membuat instans aplikasi. Gunakan cmdlet Start-ServiceFabricApplicationUpgrade untuk meningkatkan aplikasi yang ada.

Ketika jenis aplikasi dengan versi yang ditentukan tidak diperlukan lagi, Anda dapat membatalkan pendaftarannya menggunakan cmdlet Unregister-ServiceFabricApplicationType .

Untuk mengelola kluster Service Fabric, mulai Windows PowerShell dengan menggunakan opsi Jalankan sebagai administrator. Sebelum Anda melakukan operasi apa pun pada kluster Service Fabric, buat koneksi ke kluster dengan menggunakan cmdlet Connect-ServiceFabricCluster .

Contoh

Contoh 1: Mendaftarkan jenis aplikasi dengan jalur relatif penyimpanan gambar

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

Copy-ServiceFabricApplicationPackage menyalin paket aplikasi yang ditemukan di folder "c:\work\PersistentToDoListService" ke penyimpanan gambar. Paket disalin di jalur relatif "PersistentToDoListService" di penyimpanan gambar.

Perintah Register-ServiceFabricApplicationType mendaftarkan jenis aplikasi yang ditemukan di jalur relatif "PersistentToDoListService".

Contoh 2: Mendaftarkan jenis aplikasi dengan asinkron jalur relatif penyimpanan gambar

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 menyalin paket aplikasi yang ditemukan di folder "c:\work\PersistentToDoListService" ke penyimpanan gambar. Paket aplikasi disalin di jalur relatif "PersistentToDoListService" di penyimpanan gambar. Cmdlet menggunakan kompresi untuk mengurangi ukuran paket.

Perintah Register-ServiceFabricApplicationType mendaftarkan jenis aplikasi yang ditemukan di jalur relatif "PersistentToDoListService". Daftar dilakukan asinkron, dan kembali segera setelah perintah diterima oleh kluster.

Get-ServiceFabricApplicationType mendapatkan jenis aplikasi yang terdaftar di kluster. Setiap jenis aplikasi menyertakan status pendaftaran. Cmdlet dapat digunakan untuk menentukan kapan pendaftaran selesai.

Contoh 3: Mendaftarkan jenis aplikasi untuk paket aplikasi besar dengan jalur relatif penyimpanan citra

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 menyalin paket aplikasi yang ditemukan di folder "c:\work\PersistentToDoListService" ke penyimpanan citra, di lokasi relatif penyimpanan citra "PersistentToDoListService". Karena paket awal sangat besar, perintah mengompresinya dan menyertakan batas waktu yang lebih tinggi untuk memungkinkan cukup waktu untuk menyalin.

Perintah Register-ServiceFabricApplicationType mendaftarkan jenis aplikasi yang ditemukan di jalur relatif "PersistentToDoListService". Perintah ini mencakup batas waktu yang lebih tinggi untuk memungkinkan pekerjaan selesai meskipun paket aplikasi besar.

Contoh 4: Mendaftarkan jenis aplikasi dari penyimpanan eksternal

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

Mendaftarkan paket aplikasi yang ditemukan di URI yang ditentukan. Paket aplikasi harus telah diunggah sebelumnya di lokasi tersebut dan harus mengizinkan akses READ. Karena paket mungkin besar, perintah menentukan batas waktu provisi yang besar.

Contoh 5: Mendaftarkan jenis aplikasi dari asinkron penyimpanan eksternal

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

Mendaftarkan paket aplikasi yang ditemukan di URI yang ditentukan. Paket aplikasi harus telah diunggah sebelumnya di lokasi tersebut dan harus mengizinkan akses READ. Karena -Async ditentukan, perintah akan kembali segera setelah kluster menerimanya. Get-ServiceFabricApplicationType mendapatkan jenis aplikasi yang terdaftar di kluster yang cocok dengan filter. Setiap jenis aplikasi menyertakan status pendaftaran. Cmdlet dapat digunakan untuk mengikuti kemajuan pendaftaran dan untuk menentukan kapan pendaftaran selesai.

Contoh 6: Mendaftarkan jenis aplikasi dengan jalur relatif penyimpanan gambar dan pembersihan paket otomatis

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.

Parameter

-ApplicationPackageCleanupPolicy

Menentukan kebijakan pembersihan paket aplikasi yang digunakan untuk mendaftarkan jenis aplikasi. Jika tidak dibersihkan, paket aplikasi menggunakan ruang disk dan dapat menyebabkan kegagalan. Parameter ini menentukan cara mengelola paket aplikasi setelah berhasil mendaftarkan jenis aplikasi (penyediaan yang berhasil).

Ketika diatur ke Automatic, runtime Service Fabric menentukan kapan harus melakukan pembersihan paket aplikasi. Implementasi runtime saat ini menghapus paket aplikasi setelah berhasil mendaftarkan jenis aplikasi. Jika pendaftaran gagal, maka paket aplikasi tidak dihapus dari penyimpanan citra.

Ketika diatur ke Manual, paket aplikasi tidak dihapus dari penyimpanan citra dan pengguna harus secara eksplisit memanggil cmdlet Remove-ServiceFabricApplicationPackage untuk menghapusnya dari penyimpanan citra.

Kluster Service Fabric dikonfigurasi dengan kebijakan pembersihan. Untuk menggunakan kebijakan kluster, tentukan Default opsi. Konfigurasi kluster CleanupApplicationPackageOnProvisionSuccess di bawah Management bagian menentukan bagaimana pembersihan harus terjadi. Jika diatur ke true, paket aplikasi secara otomatis dihapus oleh runtime service fabric setelah provisi berhasil. Jika diatur ke false, paket aplikasi tidak dihapus dari penyimpanan citra. Nilai default konfigurasi kluster ini telah diatur ke false hingga v6.4, tetapi ada rencana untuk mengaturnya ke true untuk rilis mendatang.

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

-ApplicationPackageDownloadUri

Mewakili jalur ke sfpkg paket aplikasi dari mana paket aplikasi dapat diunduh menggunakan protokol HTTP atau HTTPS. Paket harus telah diunggah sebelumnya ke lokasi eksternal ini. URI harus mengizinkan akses BACA sehingga Service Fabric dapat mengunduh file. File sfpkg adalah zip yang berisi paket aplikasi awal. Di dalam zip, paket aplikasi dapat dikompresi atau tidak dikompresi. Pemadatan paket aplikasi di dalam zip dilakukan pada paket kode, paket, dan data. Kompresi ini dapat dicapai menggunakan Copy-ServiceFabricApplicationPackage dengan switch -CompressPackage. File sfpkg harus memiliki ekstensi ".sfpkg".

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

-ApplicationPathInImageStore

Menentukan jalur relatif paket jenis aplikasi di penyimpanan citra. Jalur ini ditentukan oleh cmdlet Copy-ServiceFabricApplicationPackage ketika paket aplikasi disalin ke penyimpanan citra.

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

-ApplicationTypeName

Menentukan nama jenis aplikasi, karena didefinisikan dalam manifes aplikasi. Nama jenis aplikasi dan versi jenis aplikasi secara unik mengidentifikasi jenis aplikasi. Ini diperlukan saat menyediakan sfpkg dari penyimpanan eksternal.

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

-ApplicationTypeVersion

Menentukan versi jenis aplikasi, seperti yang didefinisikan dalam manifes aplikasi. Nama jenis aplikasi dan versi jenis aplikasi secara unik mengidentifikasi jenis aplikasi. Ini diperlukan saat menyediakan sfpkg file paket aplikasi dari penyimpanan eksternal.

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

-Async

Perintah kembali segera setelah permintaan pendaftaran diterima oleh kluster. Gunakan perintah Get-ServiceFabricApplicationType untuk mengkueri status permintaan pendaftaran. Menggunakan sakelar ini menghindari harus memberikan nilai -TimeoutSec besar saat mendaftarkan paket aplikasi besar.

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

-TimeoutSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

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

Input

None

Output

System.Object