sfctl replica

Mengelola replika yang termasuk dalam partisi layanan.

Perintah

Perintah	Deskripsi
deployed	Mendapatkan detail replika yang digunakan pada node Service Fabric.
deployed-list	Mendapatkan daftar replika yang digunakan pada node Service Fabric.
health	Mendapatkan kesehatan replika layanan stateful Service Fabric atau instans layanan stateless.
info	Mendapatkan informasi tentang replika partisi Service Fabric.
list	Mendapatkan informasi tentang replika partisi layanan Service Fabric.
buka	Menghapus replika layanan yang berjalan pada sebuah node.
report-health	Mengirimkan laporan kesehatan tentang replika Service Fabric.
hidupkan ulang	Memulai ulang replika layanan dari layanan bertahan yang berjalan pada sebuah node.

sfctl replica deployed

Mendapatkan detail replika yang digunakan pada node Service Fabric.

Mendapatkan detail replika yang digunakan pada node Service Fabric. Informasi ini mencakup jenis layanan, nama layanan, operasi layanan saat ini, waktu tanggal mulai operasi layanan saat ini, ID partisi, ID replika/instans, beban yang dilaporkan, dan informasi lainnya.

Argumen

Argumen	Deskripsi
--node-name [Required]	Nama node.
--partition-id [Required]	Identitas partisi.
--replica-id [Diperlukan]	Pengenal replika.
--timeout -t	Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik. Default: 60.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

sfctl replica deployed-list

Mendapatkan daftar replika yang digunakan pada node Service Fabric.

Mendapatkan daftar yang berisi informasi tentang replika yang digunakan pada node Service Fabric. Informasi tersebut termasuk ID partisi, ID replika, status replika, nama layanan, nama jenis layanan, dan informasi lainnya. Gunakan parameter kueri PartitionId atau ServiceManifestName untuk mengembalikan informasi tentang replika yang digunakan yang cocok dengan nilai yang ditentukan untuk parameter tersebut.

Argumen

Argumen	Deskripsi
--application-id [Required]	Identitas aplikasi. Ini biasanya nama lengkap aplikasi tanpa skema URI 'fabric:'. Mulai dari versi 6.0, nama hierarki dibatasi dengan karakter “~”. Misalnya, jika nama aplikasi adalah "fabric:/myapp/app1", identitas aplikasi akan menjadi "myapp~app1" di versi 6.0+ dan "myapp/app1" di versi sebelumnya.
--node-name [Required]	Nama node.
--partition-id	Identitas partisi.
--service-manifest-name	Nama manifes layanan yang terdaftar sebagai bagian dari jenis aplikasi dalam kluster Service Fabric.
--timeout -t	Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik. Default: 60.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

sfctl replica health

Mendapatkan kesehatan replika layanan stateful Service Fabric atau instans layanan stateless.

Mendapatkan kesehatan dari kluster Service Fabric. Gunakan EventsHealthStateFilter untuk memfilter pengumpulan peristiwa kesehatan yang dilaporkan pada kluster berdasarkan status kesehatan.

Argumen

Argumen	Deskripsi
--partition-id [Required]	Identitas partisi.
--replica-id [Diperlukan]	Pengenal replika.
--events-health-state-filter	Memungkinkan pemfilteran koleksi objek HealthEvent yang dikembalikan berdasarkan status kesehatan. Kemungkinan nilai untuk parameter ini antara lain nilai bilangan bulat dari salah satu status kesehatan berikut. Hanya peristiwa yang cocok dengan filter yang dikembalikan. Semua peristiwa digunakan untuk mengevaluasi status kesehatan agregat. Jika tidak ditentukan, semua entri akan dikembalikan. Nilai status adalah enumerasi berbasis bendera, sehingga nilainya bisa berupa kombinasi dari nilai-nilai ini, yang diperoleh menggunakan operator 'OR' bitwise. Misalnya, Jika nilai yang diberikan adalah 6, maka semua peristiwa dengan nilai HealthState OK (2) dan Warning (4) dikembalikan. - Default - Nilai default. Mencocokkan dengan HealthState. Nilainya berbasis nol. - None - Filter yang tidak cocok dengan nilai HealthState apa pun. Digunakan untuk mengembalikan tanpa hasil pada koleksi status tertentu. Nilainya adalah 1. - Ok - Filter yang mencocokkan input dengan nilai HealthState Ok. Nilainya adalah 2. - Warning - Filter yang mencocokkan input dengan nilai HealthState Warning. Nilainya adalah 4. - Error - Filter yang mencocokkan input dengan nilai HealthState Error. Nilainya adalah 8. - All - Filter yang mencocokkan input dengan nilai HealthState apa pun. Nilainya adalah 65535.
--timeout -t	Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik. Default: 60.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

sfctl replica info

Mendapatkan informasi tentang replika partisi Service Fabric.

Respons termasuk ID, peran, status, kesehatan, nama node, uptime, dan detail lainnya tentang replika.

Argumen

Argumen	Deskripsi
--partition-id [Required]	Identitas partisi.
--replica-id [Diperlukan]	Pengenal replika.
--timeout -t	Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik. Default: 60.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

sfctl replica list

Mendapatkan informasi tentang replika partisi layanan Service Fabric.

Titik akhir GetReplicas mengembalikan informasi tentang replika partisi yang ditentukan. Respons termasuk ID, peran, status, kesehatan, nama node, uptime, dan detail lainnya tentang replika.

Argumen

Argumen	Deskripsi
--partition-id [Required]	Identitas partisi.
--continuation-token	Parameter token kelanjutan digunakan untuk mendapatkan serangkaian hasil berikutnya. Token kelanjutan dengan nilai tidak kosong disertakan dalam respons API ketika hasil dari sistem tidak sesuai dalam respons tunggal. Ketika nilai ini diteruskan ke panggilan API berikutnya, API mengembalikan serangkaian hasil berikutnya. Jika tidak ada hasil lebih lanjut, maka token kelanjutan tidak berisi nilai. Nilai parameter ini tidak boleh dikodekan URL.
--timeout -t	Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik. Default: 60.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

sfctl replica remove

Menghapus replika layanan yang berjalan pada sebuah node.

API ini mensimulasikan kegagalan replika Service Fabric dengan menghapus replika dari kluster Service Fabric. Penghapusan menutup replika, mengubah replika ke peran None, dan kemudian menghapus semua informasi status replika dari kluster. API ini menguji jalur penghapusan status replika, dan mensimulasikan jalur permanen kesalahan laporan melalui API klien. Peringatan - Tidak ada pemeriksaan keamanan yang dilakukan saat API ini digunakan. Penggunaan API ini yang salah dapat menyebabkan hilangnya data untuk layanan stateful. Selain itu, bendera forceRemove berdampak pada semua replika lain yang dihosting dalam proses yang sama.

Argumen

Argumen	Deskripsi
--node-name [Required]	Nama node.
--partition-id [Required]	Identitas partisi.
--replica-id [Diperlukan]	Pengenal replika.
--force-remove	Hapus aplikasi atau layanan Service Fabric dengan paksa tanpa melalui urutan pematian sesuai prosedur. Parameter ini dapat digunakan untuk menghapus aplikasi atau layanan secara paksa yang penghapusannya kehabisan waktu karena masalah dalam kode layanan yang mencegah penutupan replika sesuai prosedur.
--timeout -t	Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik. Default: 60.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

sfctl replica report-health

Mengirimkan laporan kesehatan tentang replika Service Fabric.

Melaporkan status kesehatan dari replika Service Fabric yang ditentukan. Laporan harus berisi informasi tentang sumber laporan kesehatan dan properti tempat laporan tersebut dilaporkan. Laporan dikirimkan ke replika gateway Service Fabric, yang diteruskan ke penyimpanan kesehatan. Laporan dapat diterima oleh gateway, tetapi ditolak oleh penyimpanan kesehatan setelah validasi ekstra. Misalnya, penyimpanan kesehatan dapat menolak laporan karena parameter yang tidak valid, seperti nomor urutan kedaluwarsa. Untuk melihat apakah laporan tersebut diterapkan di penyimpanan kesehatan, jalankan dapatkan kesehatan replika dan periksa apakah laporan tersebut muncul di bagian HealthEvents.

Argumen

Argumen	Deskripsi
--health-property [Required]	Milik informasi kesehatan. Entitas dapat memiliki laporan kesehatan untuk properti yang berbeda. Properti adalah sebuah string dan bukan enumerasi tetap untuk memungkinkan fleksibilitas reporter untuk mengkategorikan kondisi status yang memicu laporan tersebut. Misalnya, pelapor dengan SourceId "LocalWatchdog" dapat memantau status disk yang tersedia pada sebuah node, sehingga dapat melaporkan properti "AvailableDisk" pada node tersebut. Reporter yang sama dapat memantau konektivitas node, sehingga dapat melaporkan properti "Connectivity" pada node yang sama. Di penyimpanan kesehatan, laporan ini diperlakukan sebagai peristiwa kesehatan terpisah untuk node yang ditentukan. Bersama dengan SourceId, properti ini secara unik mengidentifikasi informasi kesehatan.
--health-state [Wajib]	Nilai yang mungkin termasuk: 'Tidak Valid', 'Oke', 'Peringatan', 'Kesalahan', 'Tidak Diketahui'.
--partition-id [Required]	Identitas partisi.
--replica-id [Diperlukan]	Identitas partisi.
--source-id [Diperlukan]	Nama sumber yang mengidentifikasi komponen klien/pengawas/sistem yang menghasilkan informasi kesehatan.
--description	Penjabaran informasi kesehatan. Ini mewakili teks bebas yang digunakan untuk menambahkan informasi yang dapat dibaca manusia tentang laporan. Panjang string maksimum untuk deskripsi adalah 4096 karakter. Jika string yang disediakan lebih panjang, string tersebut akan dipotong secara otomatis. Ketika dipotong, karakter terakhir dari deskripsi berisi penanda "[Truncated]", dan ukuran total stringnya adalah 4096 karakter. Munculnya penanda menunjukkan kepada pengguna bahwa pemotongan terjadi. Perhatikan bahwa ketika dipotong, deskripsi memiliki kurang dari 4096 karakter dari string asli.
--immediate	Bendera yang menunjukkan apakah laporan harus segera dikirim. Laporan dikirimkan ke Aplikasi gateway Service Fabric, yang diteruskan ke penyimpanan kesehatan. Jika Immediate diatur ke true, laporan dikirim segera dari HTTP Gateway ke penyimpanan kesehatan, terlepas dari pengaturan klien fabric yang digunakan Aplikasi GATEWAY HTTP. Ini berguna untuk laporan kritis yang harus dikirim sesegera mungkin. Tergantung waktu dan kondisi lainnya, mengirim laporan mungkin masih gagal, misalnya jika Gateway HTTP ditutup atau pesan tidak mencapai Gateway. Jika Immediate diatur ke false, laporan dikirim berdasarkan pengaturan klien kesehatan dari HTTP Gateway. Oleh karena itu, laporan akan ditumpuk sesuai konfigurasi HealthReportSendInterval. Ini adalah pengaturan yang direkomendasikan karena memungkinkan klien kesehatan untuk mengoptimalkan pesan pelaporan kesehatan ke penyimpanan kesehatan serta pemrosesan laporan kesehatan. Secara default, laporan tidak segera dikirim.
--remove-when-expired	Nilai yang menunjukkan apakah laporan dihapus dari penyimpanan kesehatan saat kedaluwarsa. Jika diatur ke true, laporan dihapus dari penyimpanan kesehatan setelah kedaluwarsa. Jika diatur ke false, laporan diperlakukan sebagai kesalahan saat kedaluwarsa. Nilai properti ini salah secara default. Ketika klien melaporkan secara berkala, maka harus mengatur RemoveWhenExpired ke false (default). Dengan demikian, ketika pelapor mengalami masalah (misalnya kebuntuan) dan tidak dapat melaporkan, entitas dievaluasi karena kesalahan ketika laporan kesehatan kedaluwarsa. Ini menandai entitas sebagai dalam status kesehatan dalam Kesalahan.
--sequence-number	Nomor urut untuk laporan kesehatan ini sebagai string numerik. Nomor urutan laporan digunakan oleh penyimpanan kesehatan untuk mendeteksi laporan kedaluwarsa. Jika tidak ditentukan, nomor urut dibuat secara otomatis oleh klien kesehatan saat laporan ditambahkan.
--service-kind	Jenis replika layanan (stateless atau stateful) yang dilaporkan oleh kesehatan. Berikut adalah nilai yang mungkin: 'Tanpa status', 'Berstatus'. Default: Berstatus.
--timeout -t	Default: 60.
--ttl	Durasi ketika laporan kesehatan ini valid. Bidang ini menggunakan format ISO8601 untuk menentukan durasi. Ketika klien melaporkan secara berkala, mereka akan mengirim laporan dengan frekuensi yang lebih tinggi daripada time to live. Jika klien melaporkan transisi, mereka dapat mengatur time to live ke tak terbatas. Ketika time to live kedaluwarsa, peristiwa kesehatan yang berisi informasi kesehatan dihapus dari penyimpanan kesehatan, jika RemoveWhenExpired adalah true, atau dievaluasi karena kesalahan, jika RemoveWhenExpired false. Jika tidak ditentukan, time to live menggunakan nilai default ke nilai tak terbatas.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

sfctl replica restart

Memulai ulang replika layanan dari layanan bertahan yang berjalan pada sebuah node.

Memulai ulang replika layanan dari layanan bertahan yang berjalan pada sebuah node. Peringatan - Tidak ada pemeriksaan keamanan yang dilakukan saat API ini digunakan. Penggunaan API ini yang salah dapat menyebabkan hilangnya ketersediaan untuk layanan stateful.

Argumen

Argumen	Deskripsi
--node-name [Required]	Nama node.
--partition-id [Required]	Identitas partisi.
--replica-id [Diperlukan]	Pengenal replika.
--timeout -t	Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik. Default: 60.

Argumen Global

Argumen	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan ini dan keluar.
--output -o	Format output. Nilai yang diizinkan: json, jsonc, tabel, tsv. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

Langkah berikutnya

• Siapkan Service Fabric CLI.
• Pelajari cara menggunakan Service Fabric CLI menggunakan contoh skrip.