Mengelola aplikasi Azure Service Fabric menggunakan Azure Service Fabric CLI (sfctl)
Pelajari cara membuat dan menghapus aplikasi yang berjalan di kluster Azure Service Fabric.
Prasyarat
Pasang Service Fabric CLI. Selanjutnya, pilih kluster Service Fabric Anda. Untuk informasi selengkapnya, lihat Mulai menggunakan Service Fabric CLI.
Siapkan paket aplikasi Service Fabric untuk disebarkan. Untuk informasi lebih lanjut tentang cara menulis dan mengemas aplikasi, baca tentang model aplikasi Service Fabric.
Gambaran Umum
Untuk menerapkan aplikasi baru, selesaikan langkah-langkah berikut:
- Unggah paket aplikasi ke penyimpanan citra Service Fabric.
- Sediakan jenis aplikasi.
- Hapus konten penyimpanan citra.
- Tentukan dan buat aplikasi.
- Tentukan dan buat layanan.
Untuk menghapus aplikasi yang sudah ada, selesaikan langkah-langkah berikut:
- Hapus aplikasi.
- Batalkan penyediaan jenis aplikasi terkait.
Menyebarkan aplikasi baru
Untuk menggunakan aplikasi baru, selesaikan tugas berikut:
Mengunggah paket aplikasi baru ke penyimpanan citra
Sebelum Anda membuat aplikasi, unggah paket aplikasi ke penyimpanan citra Service Fabric.
Misalnya, jika paket aplikasi Anda berada di direktori app_package_dir, gunakan perintah berikut untuk mengunggah direktori:
sfctl application upload --path ~/app_package_dir
Untuk paket aplikasi besar, Anda dapat menentukan opsi --show-progress untuk menampilkan kemajuan unggahan.
Menyediakan jenis aplikasi
Setelah unggahan selesai, sediakan aplikasi. Untuk menyediakan aplikasi, gunakan perintah berikut:
sfctl application provision --application-type-build-path app_package_dir
Nilai untuk application-type-build-path adalah nama direktori tempat Anda mengunggah paket aplikasi Anda.
Menghapus paket aplikasi
Disarankan agar Anda menghapus paket aplikasi setelah aplikasi berhasil didaftarkan. Menghapus paket aplikasi dari penyimpanan citra akan membebaskan sumber daya sistem. Menyimpan paket aplikasi yang tidak digunakan akan menggunakan penyimpanan disk dan menyebabkan masalah performa aplikasi.
Untuk menghapus paket aplikasi dari penyimpanan citra, gunakan perintah berikut:
sfctl store delete --content-path app_package_dir
content-path harus berupa nama direktori yang Anda unggah saat membuat aplikasi.
Membuat aplikasi dari jenis aplikasi
Setelah menyediakan aplikasi, gunakan perintah berikut untuk memberi nama dan buat aplikasi Anda:
sfctl application create --app-name fabric:/TestApp --app-type TestAppType --app-version 1.0
app-name adalah nama yang ingin Anda gunakan untuk instans aplikasi. Anda bisa mendapatkan parameter tambahan dari manifes aplikasi yang disediakan sebelumnya.
Nama aplikasi harus dimulai dengan awalan fabric:/.
Membuat layanan untuk aplikasi baru
Setelah Anda membuat aplikasi, buat layanan dari aplikasi. Dalam contoh berikut, kita membuat layanan stateless baru dari aplikasi kita. Layanan yang dapat Anda buat dari aplikasi didefinisikan dalam manifes layanan dalam paket aplikasi yang disediakan sebelumnya.
sfctl service create --app-id TestApp --name fabric:/TestApp/TestSvc --service-type TestServiceType \
--stateless --instance-count 1 --singleton-scheme
Memverifikasi penyebaran aplikasi dan kesehatan
Untuk memverifikasi bahwa semuanya sehat, gunakan perintah kesehatan berikut:
sfctl application list
sfctl service list --application-id TestApp
Untuk memverifikasi bahwa layanan sehat, gunakan perintah serupa untuk mengambil informasi kesehatan layanan dan aplikasi:
sfctl application health --application-id TestApp
sfctl service health --service-id TestApp/TestSvc
Layanan dan aplikasi sehat memiliki nilai HealthState dari Ok.
Menghapus aplikasi yang ada
Untuk menghapus aplikasi, selesaikan tugas berikut:
Menghapus aplikasi
Untuk menghapus aplikasi, gunakan perintah berikut:
sfctl application delete --application-id TestEdApp
Membatalkan penyediaan jenis aplikasi
Setelah menghapus aplikasi, Anda dapat membuka bayangkan jenis aplikasi jika Anda tidak lagi membutuhkannya. Untuk membatalkan bayangkan tipe aplikasi, gunakan perintah berikut:
sfctl application unprovision --application-type-name TestAppType --application-type-version 1.0
Nama jenis dan versi jenis harus sesuai dengan nama dan versi dalam manifes aplikasi yang disediakan sebelumnya.
Meningkatkan aplikasi
Setelah membuat aplikasi, Anda dapat mengulangi serangkaian langkah yang sama untuk menyediakan versi kedua aplikasi Anda. Selanjutnya, dengan meningkatkan aplikasi Service Fabric, Anda dapat beralih ke menjalankan versi kedua aplikasi. Untuk informasi selengkapnya, lihat dokumentasi tentang peningkatan aplikasi Service Fabric.
Untuk melakukan peningkatan, pertama-tama sediakan versi aplikasi berikutnya menggunakan perintah yang sama seperti sebelumnya:
sfctl application upload --path ~/app_package_dir_2
sfctl application provision --application-type-build-path app_package_dir_2
sfctl store delete --content-path app_package_dir_2
Disarankan kemudian untuk melakukan peningkatan otomatis yang dipantau, meluncurkan peningkatan dengan menjalankan perintah berikut:
sfctl application upgrade --app-id TestApp --app-version 2.0.0 --parameters "{\"test\":\"value\"}" --mode Monitored
Peningkatan akan menimpa parameter yang ada dengan set apa pun yang telah ditentukan. Parameter aplikasi harus diteruskan sebagai argumen ke perintah peningkatan, jika perlu. Parameter aplikasi harus dikodekan sebagai objek JSON.
Untuk mengambil parameter apa pun yang ditentukan sebelumnya, Anda dapat menggunakan perintah sfctl application info.
Ketika peningkatan aplikasi sedang berlangsung, status dapat diambil menggunakan perintah sfctl application upgrade-status.
Akhirnya, jika peningkatan sedang berlangsung dan perlu dibatalkan, Anda dapat menggunakan sfctl application upgrade-rollback untuk mengembalikan peningkatan.