sfctl replica
Hizmet bölümlerine ait çoğaltmaları yönetin.
Komutlar
| Komut | Açıklama |
|---|---|
| Dağıtılan | Service Fabric düğümünde dağıtılan çoğaltmanın ayrıntılarını alır. |
| dağıtılmış liste | Service Fabric düğümünde dağıtılan çoğaltmaların listesini alır. |
| sağlık | Durum bilgisi olan bir Service Fabric hizmet çoğaltmasının veya durum bilgisi olmayan hizmet örneğinin durumunu alır. |
| Bilgi | Service Fabric bölümünün çoğaltması hakkındaki bilgileri alır. |
| listele | Service Fabric hizmet bölümünün çoğaltmaları hakkındaki bilgileri alır. |
| remove | Düğümde çalışan bir hizmet çoğaltmasını kaldırır. |
| rapor durumu | Service Fabric çoğaltması üzerinde bir sistem durumu raporu gönderir. |
| restart | Bir düğümde çalışan kalıcı bir hizmetin hizmet çoğaltmasını yeniden başlatır. |
dağıtılan sfctl çoğaltması
Service Fabric düğümünde dağıtılan çoğaltmanın ayrıntılarını alır.
Service Fabric düğümünde dağıtılan çoğaltmanın ayrıntılarını alır. Bilgiler hizmet türünü, hizmet adını, geçerli hizmet işlemini, geçerli hizmet işleminin başlangıç tarihini, bölüm kimliğini, çoğaltma/örnek kimliğini, bildirilen yükü ve diğer bilgileri içerir.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --node-name [Gerekli] | Düğümün adı. |
| --partition-id [Gerekli] | Bölümün kimliği. |
| --replica-id [Gerekli] | Çoğaltmanın tanımlayıcısı. |
| --timeout -t | İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir. Varsayılan: 60. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
sfctl replica deployed-list
Service Fabric düğümünde dağıtılan çoğaltmaların listesini alır.
Service Fabric düğümünde dağıtılan çoğaltmalar hakkındaki bilgileri içeren listeyi alır. Bilgiler bölüm kimliği, çoğaltma kimliği, çoğaltmanın durumu, hizmetin adı, hizmet türünün adı ve diğer bilgileri içerir. Bu parametreler için belirtilen değerlerle eşleşen dağıtılan çoğaltmalar hakkında bilgi döndürmek için PartitionId veya ServiceManifestName sorgu parametrelerini kullanın.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --application-id [Gerekli] | Uygulamanın kimliği. Bu genellikle 'fabric:' URI şeması olmayan uygulamanın tam adıdır. Sürüm 6.0'dan başlayarak hiyerarşik adlar "~" karakteriyle sınırlandırılır. Örneğin, uygulama adı "fabric:/myapp/app1" ise, uygulama kimliği 6.0+ sürümünde "myapp~app1" ve önceki sürümlerde "myapp/app1" olacaktır. |
| --node-name [Gerekli] | Düğümün adı. |
| --partition-id | Bölümün kimliği. |
| --service-manifest-name | Service Fabric kümesindeki bir uygulama türünün parçası olarak kaydedilen hizmet bildiriminin adı. |
| --timeout -t | İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir. Varsayılan: 60. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
sfctl çoğaltma durumu
Durum bilgisi olan bir Service Fabric hizmet çoğaltmasının veya durum bilgisi olmayan hizmet örneğinin durumunu alır.
Service Fabric çoğaltmasının sistem durumunu alır. Çoğaltmada bildirilen sistem durumu olaylarının koleksiyonunu sistem durumu temelinde filtrelemek için EventsHealthStateFilter kullanın.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --partition-id [Gerekli] | Bölümün kimliği. |
| --replica-id [Gerekli] | Çoğaltmanın tanımlayıcısı. |
| --events-health-state-filter | Sistem durumu temelinde döndürülen HealthEvent nesnelerinin koleksiyonunu filtrelemeye izin verir. Bu parametrenin olası değerleri aşağıdaki sistem durumu durumlarından birinin tamsayı değerini içerir. Yalnızca filtreyle eşleşen olaylar döndürülür. Toplanan sistem durumunu değerlendirmek için tüm olaylar kullanılır. Belirtilmezse, tüm girdiler döndürülür. Durum değerleri bayrak tabanlı numaralandırmadır, bu nedenle değer bit tabanlı 'OR' işleci kullanılarak elde edilen bu değerlerin bir bileşimi olabilir. Örneğin, sağlanan değer 6 ise, HealthState değeri Tamam (2) ve Uyarı (4) olan tüm olaylar döndürülür. - Varsayılan - Varsayılan değer. Herhangi bir HealthState ile eşleşir. Değer sıfırdır. - Hiçbiri - Herhangi bir HealthState değeriyle eşleşmeyen filtre. Belirli bir durum koleksiyonunda sonuç döndürmemek için kullanılır. Değer 1'dir. - Tamam - HealthState değeriYle eşleşen filtre Tamam. Değer 2'dir. - Uyarı - HealthState değeri Uyarı ile girişle eşleşen filtre. Değer 4'dür. - Hata - Giriş ile HealthState değeriYle eşleşen filtre Error. Değer 8'dir. - Tümü - Herhangi bir HealthState değeriyle girişle eşleşen filtre. Değer 65535'tir. |
| --timeout -t | İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir. Varsayılan: 60. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
sfctl çoğaltma bilgileri
Service Fabric bölümünün çoğaltması hakkındaki bilgileri alır.
Yanıt, kimlik, rol, durum, sistem durumu, düğüm adı, çalışma süresi ve çoğaltma hakkındaki diğer ayrıntıları içerir.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --partition-id [Gerekli] | Bölümün kimliği. |
| --replica-id [Gerekli] | Çoğaltmanın tanımlayıcısı. |
| --timeout -t | İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir. Varsayılan: 60. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
sfctl çoğaltma listesi
Service Fabric hizmet bölümünün çoğaltmaları hakkındaki bilgileri alır.
GetReplicas uç noktası, belirtilen bölümün çoğaltmaları hakkında bilgi döndürür. Yanıt, kimlik, rol, durum, sistem durumu, düğüm adı, çalışma süresi ve çoğaltma hakkındaki diğer ayrıntıları içerir.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --partition-id [Gerekli] | Bölümün kimliği. |
| --continuation-token | Devam belirteci parametresi, sonraki sonuç kümesini almak için kullanılır. Sistemden alınan sonuçlar tek bir yanıta sığmadığında API'nin yanıtına boş olmayan bir değer içeren bir devamlılık belirteci eklenir. Bu değer bir sonraki API çağrısına geçirildiğinde, API bir sonraki sonuç kümesini döndürür. Başka sonuç yoksa, devamlılık belirteci bir değer içermez. Bu parametrenin değeri URL kodlanmış olmamalıdır. |
| --timeout -t | İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir. Varsayılan: 60. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
sfctl replica remove
Düğümde çalışan bir hizmet çoğaltmasını kaldırır.
Bu API, bir Service Fabric kümesinden bir çoğaltmayı kaldırarak bir Service Fabric çoğaltma hatasının benzetimini gerçekleştirir. Kaldırma işlemi çoğaltmayı kapatır, çoğaltmayı Yok rolüne geçirir ve ardından çoğaltmanın tüm durum bilgilerini kümeden kaldırır. Bu API, çoğaltma durumu kaldırma yolunu test eder ve istemci API'leri aracılığıyla rapor hatası kalıcı yolunun benzetimini gerçekleştirir. Uyarı - Bu API kullanıldığında hiçbir güvenlik denetimi yapılmaz. Bu API'nin yanlış kullanılması durum bilgisi olan hizmetler için veri kaybına neden olabilir. Ayrıca forceRemove bayrağı aynı işlemde barındırılan diğer tüm çoğaltmaları etkiler.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --node-name [Gerekli] | Düğümün adı. |
| --partition-id [Gerekli] | Bölümün kimliği. |
| --replica-id [Gerekli] | Çoğaltmanın tanımlayıcısı. |
| --force-remove | Bir Service Fabric uygulamasını veya hizmetini düzgün kapatma sırasına girmeden zorla kaldırın. Bu parametre, hizmet kodundaki çoğaltmaların düzgün bir şekilde kapatılmasını engelleyen sorunlardan dolayı silme işleminin zaman aşımına neden olduğu bir uygulamayı veya hizmeti zorla silmek için kullanılabilir. |
| --timeout -t | İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir. Varsayılan: 60. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
sfctl replica report-health
Service Fabric çoğaltması üzerinde bir sistem durumu raporu gönderir.
Belirtilen Service Fabric çoğaltmasının sistem durumunu bildirir. Rapor, raporlandığı sistem durumu raporunun ve özelliğin kaynağı hakkındaki bilgileri içermelidir. Rapor, sistem durumu deposuna iletilen bir Service Fabric ağ geçidi Çoğaltmasına gönderilir. Rapor ağ geçidi tarafından kabul edilebilir, ancak ek doğrulamadan sonra sistem durumu deposu tarafından reddedilir. Örneğin, sistem durumu deposu eski bir sıra numarası gibi geçersiz bir parametre nedeniyle raporu reddedebilir. Raporun sistem durumu deposunda uygulanıp uygulanmadığını görmek için Get replica health komutunu çalıştırın ve raporun HealthEvents bölümünde görünüp görünmediğini denetleyin.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --health-property [Gerekli] | Sistem durumu bilgilerinin özelliği. Bir varlığın farklı özellikler için sistem durumu raporları olabilir. özelliği, raporlayıcının raporu tetikleyen durum koşulunu kategorilere ayırma esnekliğine olanak sağlayan sabit bir numaralandırma değil bir dizedir. Örneğin, SourceId "LocalWatchdog" olan bir muhabir düğümdeki kullanılabilir diskin durumunu izleyebilir, böylece bu düğümde "AvailableDisk" özelliğini bildirebilir. Aynı muhabir düğüm bağlantısını izleyebilir, böylece aynı düğümde "Bağlantı" özelliğini bildirebilir. Sistem durumu deposunda, bu raporlar belirtilen düğüm için ayrı sistem durumu olayları olarak değerlendirilir. SourceId ile birlikte özelliği, sistem durumu bilgilerini benzersiz olarak tanımlar. |
| --health-state [Gerekli] | Olası değerler şunlardır: 'Invalid', 'Ok', 'Warning', 'Error', 'Unknown'. |
| --partition-id [Gerekli] | Bölümün kimliği. |
| --replica-id [Gerekli] | Bölümün kimliği. |
| --source-id [Gerekli] | Sistem durumu bilgilerini oluşturan istemci/watchdog/sistem bileşenini tanımlayan kaynak adı. |
| --Açıklama | Sistem durumu bilgilerinin açıklaması. Rapor hakkında okunabilir bilgiler eklemek için kullanılan serbest metni temsil eder. Açıklama için en fazla dize uzunluğu 4096 karakterdir. Sağlanan dize daha uzunsa, otomatik olarak kesilir. Kesildiğinde, açıklamanın son karakterleri "[Kesilmiş]" işaretçisini içerir ve toplam dize boyutu 4096 karakterdir. İşaretçinin varlığı, kullanıcılara kesme işleminin gerçekleştiğini gösterir. Kesildiğinde, açıklamanın özgün dizeden 4096 karakterden az olduğunu unutmayın. |
| --hazır | Raporun hemen gönderilmesi gerekip gerekmediğini gösteren bir bayrak. Sistem durumu raporu, sistem durumu deposuna iletilen bir Service Fabric ağ geçidi uygulamasına gönderilir. Anında değeri true olarak ayarlanırsa rapor, HTTP Gateway Uygulamasının kullandığı doku istemci ayarlarına bakılmaksızın http ağ geçidinden sistem durumu deposuna hemen gönderilir. Bu, en kısa sürede gönderilmesi gereken kritik raporlar için kullanışlıdır. Zamanlamaya ve diğer koşullara bağlı olarak, örneğin HTTP Ağ Geçidi kapatılırsa veya ileti Ağ Geçidi'ne ulaşmazsa raporu gönderme işlemi yine başarısız olabilir. Anlık değer false olarak ayarlanırsa rapor, HTTP Ağ Geçidi'nden sistem durumu istemci ayarlarına göre gönderilir. Bu nedenle, HealthReportSendInterval yapılandırmasına göre toplu işlenecektir. Sistem durumu istemcisinin sistem durumu raporu işlemenin yanı sıra sistem durumu raporlama iletilerini sistem durumu deposuna en iyi duruma getirmesine izin verdiğinden, bu önerilen ayardır. Varsayılan olarak, raporlar hemen gönderilmez. |
| --remove-when-expired | Raporun süresi dolduğunda sistem durumu deposundan kaldırılıp kaldırılmadığını gösteren değer. True olarak ayarlanırsa, rapor süresi dolduktan sonra sistem durumu deposundan kaldırılır. False olarak ayarlanırsa, süresi dolduğunda rapor hata olarak değerlendirilir. Bu özelliğin değeri varsayılan olarak false'tur. İstemciler düzenli aralıklarla raporladığında RemoveWhenExpired false (varsayılan) olarak ayarlanmalıdır. Bu şekilde, muhabirin sorunları (kilitlenme gibi) vardır ve raporlayamazsa, durum raporunun süresi dolduğunda varlık hatayla değerlendirilir. Bu, varlığı Hata durumu durumunda olarak işaretler. |
| --sequence-number | Bu sistem durumu raporunun sayısal dize olarak sıra numarası. Rapor dizisi numarası, sistem durumu deposu tarafından eski raporları algılamak için kullanılır. Belirtilmezse, bir rapor eklendiğinde sistem durumu istemcisi tarafından bir sıra numarası otomatik olarak oluşturulur. |
| --service-kind | Sistem durumunun bildirildiği hizmet çoğaltması türü (durum bilgisi olmayan veya durum bilgisi olan). Olası değerler şunlardır: 'Stateless', 'Stateful'. Varsayılan: Durum bilgisi olan. |
| --timeout -t | Varsayılan: 60. |
| --Ttl | Bu sistem durumu raporunun geçerli olduğu süre. Bu alan, süreyi belirtmek için ISO8601 biçimi kullanır. İstemciler düzenli aralıklarla rapor gönderdiğinde, yaşam süresinden daha yüksek sıklıkta raporlar göndermelidir. İstemciler geçişle ilgili rapor verirse yaşam süresini sonsuz olarak ayarlayabilir. Yaşam süresi dolduğunda, sistem durumu bilgilerini içeren sistem durumu olayı, RemoveWhenExpired true ise sistem durumu deposundan kaldırılır veya RemoveWhenExpired false olduğunda hata olarak değerlendirilir. Belirtilmezse, yaşam süresi varsayılan olarak sonsuz değerdir. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
sfctl çoğaltma yeniden başlatma
Bir düğümde çalışan kalıcı bir hizmetin hizmet çoğaltmasını yeniden başlatır.
Bir düğümde çalışan kalıcı bir hizmetin hizmet çoğaltmasını yeniden başlatır. Uyarı - Bu API kullanıldığında hiçbir güvenlik denetimi yapılmaz. Bu API'nin yanlış kullanılması durum bilgisi olan hizmetler için kullanılabilirlik kaybına neden olabilir.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --node-name [Gerekli] | Düğümün adı. |
| --partition-id [Gerekli] | Bölümün kimliği. |
| --replica-id [Gerekli] | Çoğaltmanın tanımlayıcısı. |
| --timeout -t | İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir. Varsayılan: 60. |
Genel Bağımsız Değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
| --help -h | Bu yardım iletisini göster ve çık. |
| --output -o | Çıkış biçimi. İzin verilen değerler: json, jsonc, table, tsv. Varsayılan: json. |
| --sorgu | JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
| --Ayrıntılı | Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın. |
Sonraki adımlar
- Service Fabric CLI'yi ayarlayın .
- Örnek betikleri kullanarak Service Fabric CLI'yi kullanmayı öğrenin.