sfctl-replika
A szolgáltatáspartíciókhoz tartozó replikák kezelése.
Parancsok
Parancs | Leírás |
---|---|
Telepített | Lekéri a Service Fabric-csomóponton üzembe helyezett replika részleteit. |
üzembe helyezett lista | Lekéri a Service Fabric-csomóponton üzembe helyezett replikák listáját. |
egészségügy | Lekéri egy Service Fabric állapotalapú szolgáltatásreplika vagy állapot nélküli szolgáltatáspéldány állapotát. |
infó | Lekéri a Service Fabric-partíció replikájára vonatkozó információkat. |
list | Lekéri a Service Fabric szolgáltatáspartíció replikáival kapcsolatos információkat. |
eltávolít | Eltávolít egy csomóponton futó szolgáltatásreplikát. |
jelentés-állapot | Állapotjelentést küld a Service Fabric-replikáról. |
restart | Újraindítja egy csomóponton futó, tartósan megmaradó szolgáltatás szolgáltatásreplikáját. |
üzembe helyezett sfctl-replika
Lekéri a Service Fabric-csomóponton üzembe helyezett replika részleteit.
Lekéri a Service Fabric-csomóponton üzembe helyezett replika részleteit. Az információk közé tartozik a szolgáltatás típusa, a szolgáltatás neve, az aktuális szolgáltatásművelet, az aktuális szolgáltatásművelet kezdési dátuma, a partícióazonosító, a replika/példány azonosítója, a jelentett terhelés és egyéb információk.
Argumentumok
Argumentum | Leírás |
---|---|
--node-name [Kötelező] | A csomópont neve. |
--partition-id [Kötelező] | A partíció identitása. |
--replica-id [Kötelező] | A replika azonosítója. |
--időtúllépés -t | A kiszolgáló időtúllépése a művelet másodpercek alatt történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
üzembe helyezett sfctl-replika listája
Lekéri a Service Fabric-csomóponton üzembe helyezett replikák listáját.
Lekéri a Service Fabric-csomóponton üzembe helyezett replikák adatait tartalmazó listát. Az információk közé tartozik a partícióazonosító, a replika azonosítója, a replika állapota, a szolgáltatás neve, a szolgáltatástípus neve és egyéb információk. A PartitionId vagy a ServiceManifestName lekérdezési paraméterek használatával adja vissza az adott paraméterek megadott értékeinek megfelelő telepített replikák adatait.
Argumentumok
Argumentum | Leírás |
---|---|
--application-id [Kötelező] | Az alkalmazás identitása. Ez általában az alkalmazás teljes neve a "fabric:" URI-séma nélkül. A 6.0-s verziótól kezdődően a hierarchikus nevek "~" karakterrel vannak elválasztva. Ha például az alkalmazás neve "fabric:/myapp/app1", akkor az alkalmazás identitása a "myapp~app1" lesz a 6.0-s vagy újabb verziókban, a "myapp/app1" pedig a korábbi verziókban. |
--node-name [Kötelező] | A csomópont neve. |
--partition-id | A partíció identitása. |
--service-manifest-name | Egy Service Fabric-fürtben egy alkalmazástípus részeként regisztrált szolgáltatásjegyzék neve. |
--időtúllépés -t | A kiszolgáló időtúllépése a művelet másodpercek alatt történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
sfctl replika állapota
Lekéri egy Service Fabric állapotalapú szolgáltatásreplika vagy állapot nélküli szolgáltatáspéldány állapotát.
Lekéri egy Service Fabric-replika állapotát. Az EventsHealthStateFilter használatával szűrheti a replikán jelentett állapotesemények gyűjteményét az állapot alapján.
Argumentumok
Argumentum | Leírás |
---|---|
--partition-id [Kötelező] | A partíció identitása. |
--replica-id [Kötelező] | A replika azonosítója. |
--events-health-state-filter | Lehetővé teszi az állapot alapján visszaadott HealthEvent-objektumok gyűjteményének szűrését. A paraméter lehetséges értékei közé tartozik az alábbi állapotok egyikének egész száma. A rendszer csak a szűrőnek megfelelő eseményeket adja vissza. Az összes esemény az összesített állapot kiértékelésére szolgál. Ha nincs megadva, a rendszer minden bejegyzést visszaad. Az állapotértékek jelölőalapú számbavételek, így az érték az értékek kombinációja lehet, amely a bitenkénti "OR" operátorral érhető el. Ha például a megadott érték 6, akkor a rendszer az ok (2) és a figyelmeztetés (4) állapotértékkel rendelkező összes eseményt visszaadja. - Alapértelmezett – Alapértelmezett érték. Egyezik bármely HealthState-tal. Az érték nulla. - Nincs – Szűrő, amely nem egyezik a HealthState értékeivel. Egy adott állapotgyűjtemény eredményeinek visszaadására szolgál. Az érték 1. - Ok – Szűrő, amely megfelel a bemenetnek az Ok HealthState értékkel. Az érték 2. - Figyelmeztetés – A HealthState érték figyelmeztetésével egyező szűrő. Az érték 4. - Hiba – A HealthState értékével egyező szűrő. Az érték 8. - Minden – Szűrő, amely megfelel a bemenetnek bármilyen HealthState-értékkel. Az érték 65535. |
--időtúllépés -t | A kiszolgáló időtúllépése a művelet másodpercek alatt történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
sfctl replika adatai
Lekéri a Service Fabric-partíció replikájára vonatkozó információkat.
A válasz tartalmazza a replika azonosítóját, szerepkörét, állapotát, állapotát, csomópontnevét, üzemidejét és egyéb adatait.
Argumentumok
Argumentum | Leírás |
---|---|
--partition-id [Kötelező] | A partíció identitása. |
--replica-id [Kötelező] | A replika azonosítója. |
--időtúllépés -t | A kiszolgáló időtúllépése a művelet másodpercek alatt történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
sfctl replikalista
Lekéri a Service Fabric szolgáltatáspartíció replikáival kapcsolatos információkat.
A GetReplicas-végpont információt ad vissza a megadott partíció replikáiról. A válasz tartalmazza a replika azonosítóját, szerepkörét, állapotát, állapotát, csomópontnevét, üzemidejét és egyéb adatait.
Argumentumok
Argumentum | Leírás |
---|---|
--partition-id [Kötelező] | A partíció identitása. |
--folytatási jogkivonat | A folytatási jogkivonat paramétere a következő eredmények lekérésére szolgál. Az API válaszában szerepel egy nem üres értékkel rendelkező folytatási jogkivonat, ha a rendszer eredményei nem férnek el egyetlen válaszban. Amikor ezt az értéket átadja a következő API-hívásnak, az API a következő eredményhalmazt adja vissza. Ha nincsenek további eredmények, akkor a folytatási jogkivonat nem tartalmaz értéket. Ennek a paraméternek az értéke nem lehet URL-kódolva. |
--időtúllépés -t | A kiszolgáló időtúllépése a művelet másodpercek alatt történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
sfctl replika eltávolítása
Eltávolít egy csomóponton futó szolgáltatásreplikát.
Ez az API egy Service Fabric-replika meghibásodását szimulálja, ha eltávolít egy replikát egy Service Fabric-fürtből. Az eltávolítás bezárja a replikát, áttűnés a replikát a Nincs szerepkörre, majd eltávolítja a replika összes állapotinformációját a fürtből. Ez az API teszteli a replikaállapot-eltávolítási útvonalat, és az ügyfél API-kon keresztül szimulálja a jelentés hiba állandó elérési útját. Figyelmeztetés – Az API használatakor nem végeznek biztonsági ellenőrzéseket. Az API helytelen használata adatvesztéshez vezethet az állapotalapú szolgáltatások esetében. Emellett a forceRemove jelző hatással van az ugyanazon folyamat során üzemeltetett összes többi replikára is.
Argumentumok
Argumentum | Leírás |
---|---|
--node-name [Kötelező] | A csomópont neve. |
--partition-id [Kötelező] | A partíció identitása. |
--replica-id [Kötelező] | A replika azonosítója. |
--force-remove | A Service Fabric-alkalmazás vagy szolgáltatás kényszerített eltávolítása a kecses leállítási sorrend végiglépése nélkül. Ez a paraméter olyan alkalmazás vagy szolgáltatás kényszerített törlésére használható, amelynek törlése a szolgáltatáskód azon hibái miatt, amelyek megakadályozzák a replikák kecses bezárását. |
--időtúllépés -t | A kiszolgáló időtúllépése a művelet másodpercek alatt történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
sfctl replica report-health
Állapotjelentést küld a Service Fabric-replikáról.
A megadott Service Fabric-replika állapotának jelentése. A jelentésnek tartalmaznia kell az állapotjelentés forrására és a jelentés alapjául szolgáló tulajdonságra vonatkozó információkat. A jelentés egy Service Fabric-átjáró replikájába kerül, amely az állapottárolóba továbbítja. Előfordulhat, hogy az átjáró elfogadja a jelentést, de az állapottároló a további ellenőrzés után elutasítja. Az állapottároló például elvetheti a jelentést egy érvénytelen paraméter, például egy elavult sorszám miatt. Annak ellenőrzéséhez, hogy a jelentést alkalmazták-e az állapottárolóban, futtassa a replika állapotának lekérését, és ellenőrizze, hogy a jelentés megjelenik-e a HealthEvents szakaszban.
Argumentumok
Argumentum | Leírás |
---|---|
--health-property [Kötelező] | Az állapotinformáció tulajdonsága. Az entitások különböző tulajdonságok állapotjelentéseivel rendelkezhetnek. A tulajdonság egy sztring, és nem rögzített számbavétel, amely lehetővé teszi, hogy a riporter rugalmasan kategorizálja a jelentést kiváltó állapot feltételét. A SourceId "LocalWatchdog" nevű riporter például figyelheti a csomóponton elérhető lemez állapotát, így a csomópont "AvailableDisk" tulajdonságát is jelentheti. Ugyanaz a riporter figyelheti a csomópontok kapcsolatát, így egy "Connectivity" tulajdonságot jelenthet ugyanazon a csomóponton. Az állapottárolóban ezek a jelentések külön állapoteseményként lesznek kezelve a megadott csomóponthoz. A SourceId azonosítóval együtt a tulajdonság egyedileg azonosítja az állapotadatokat. |
--health-state [Kötelező] | A lehetséges értékek a következők: 'Invalid', 'Ok', 'Warning', 'Error', 'Unknown'. |
--partition-id [Kötelező] | A partíció identitása. |
--replica-id [Kötelező] | A partíció identitása. |
--source-id [Kötelező] | Az állapotinformációt létrehozó ügyfél-/watchdog/rendszerösszetevőt azonosító forrásnév. |
--leírás | Az állapotinformációk leírása. A jelentés emberi olvasásra alkalmas információinak hozzáadására használt szabad szöveget jelöli. A leírás maximális sztringhossza 4096 karakter. Ha a megadott sztring hosszabb, a program automatikusan csonkolja. Csonkításkor a leírás utolsó karakterei egy "[Csonkolt]" jelölőt tartalmaznak, a teljes sztringméret pedig 4096 karakter. A jelölő jelenléte azt jelzi a felhasználóknak, hogy csonkolás történt. Vegye figyelembe, hogy csonkításkor a leírás kevesebb mint 4096 karaktert tartalmaz az eredeti sztringből. |
--azonnali | Egy jelző, amely jelzi, hogy a jelentést azonnal el kell-e küldeni. A rendszer állapotjelentést küld egy Service Fabric-átjáróalkalmazásnak, amely az állapottárolóba továbbítja. Ha az Azonnali értéke igaz, a rendszer azonnal elküldi a jelentést a HTTP Gatewayről az állapottárolóba, függetlenül attól, hogy a HTTP Gateway-alkalmazás milyen hálóügyfél-beállításokat használ. Ez olyan kritikus jelentések esetében hasznos, amelyeket a lehető leghamarabb el kell küldeni. Az időzítéstől és egyéb feltételektől függően a jelentés elküldése továbbra is sikertelen lehet, például ha a HTTP-átjáró bezárult, vagy az üzenet nem éri el az átjárót. Ha az Azonnali értéke hamis, a rendszer a HTTP-átjáró állapotügyfél-beállításai alapján küldi el a jelentést. Ezért a rendszer a HealthReportSendInterval konfigurációnak megfelelően kötegelve lesz. Ez az ajánlott beállítás, mivel lehetővé teszi az állapotügyfél számára, hogy optimalizálja az állapotjelentési üzeneteket az állapottárba, valamint az állapotjelentések feldolgozását. Alapértelmezés szerint a jelentések nem lesznek azonnal elküldve. |
--remove-when-expired | Az az érték, amely jelzi, hogy a jelentés el lesz-e távolítva az állapottárolóból a lejáratkor. Ha igaz értékre van állítva, a jelentés a lejárat után törlődik az állapottárból. Ha hamis értékre van állítva, a rendszer a jelentést hibaként kezeli, ha lejárt. A tulajdonság értéke alapértelmezés szerint hamis. Amikor az ügyfelek rendszeresen jelentést tesznek, a RemoveWhenExpired false (alapértelmezett) értéket kell beállítaniuk. Így a riporter problémákat (például holtpontot) tapasztal, és nem tud jelentést kiadni, az entitás kiértékelése hiba esetén történik, amikor az állapotjelentés lejár. Ez az entitás hibaállapotúként jelöli meg az entitást. |
--sorszám | Az állapotjelentés sorszáma numerikus sztringként. Az állapottároló a jelentésütemezési számot használja az elavult jelentések észlelésére. Ha nincs megadva, az állapotügyfél automatikusan generál egy sorszámot a jelentés hozzáadásakor. |
--service-kind | Az a szolgáltatásreplika típusa (állapot nélküli vagy állapotalapú), amelyhez az állapotot jelentik. A lehetséges értékek a következők: "Állapot nélküli", "Állapotalapú". Alapértelmezett: Állapotalapú. |
--időtúllépés -t | Alapértelmezett: 60. |
--Ttl | Az az időtartam, amelyre az állapotjelentés érvényes. Ez a mező ISO8601 formátumot használ az időtartam megadásához. Amikor az ügyfelek rendszeresen jelentést küldenek, az élettartamnál nagyobb gyakoriságú jelentéseket kell küldeniük. Ha az ügyfelek az áttűnésről számolnak be, az élettartamot végtelenre állíthatják be. Ha lejár az élettartam, az állapotinformációkat tartalmazó állapotesemény vagy törlődik az állapottárolóból, ha a RemoveWhenExpired igaz, vagy hiba esetén kiértékelik, ha a RemoveWhenExpired hamis. Ha nincs megadva, az élettartam alapértelmezés szerint végtelen értékű. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
sfctl replika újraindítása
Újraindítja egy csomóponton futó, tartósan megmaradó szolgáltatás szolgáltatásreplikáját.
Újraindítja egy csomóponton futó, tartósan megmaradó szolgáltatás szolgáltatásreplikáját. Figyelmeztetés – Az API használatakor nem végeznek biztonsági ellenőrzéseket. Az API helytelen használata az állapotalapú szolgáltatások rendelkezésre állásának elvesztéséhez vezethet.
Argumentumok
Argumentum | Leírás |
---|---|
--node-name [Kötelező] | A csomópont neve. |
--partition-id [Kötelező] | A partíció identitása. |
--replica-id [Kötelező] | A replika azonosítója. |
--időtúllépés -t | A kiszolgáló időtúllépése a művelet másodpercek alatt történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60. |
Globális argumentumok
Argumentum | Leírás |
---|---|
--Debug | Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. |
--súgó -h | Jelenítse meg ezt a súgóüzenetet, és lépjen ki. |
--output -o | Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json. |
--lekérdezés | JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ . |
--bőbeszédű | A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz. |
Következő lépések
- A Service Fabric parancssori felületének beállítása .
- Megtudhatja, hogyan használhatja a Service Fabric PARANCSSOR-t a mintaszkriptekkel.