sfctl replica
Spravujte repliky, které patří do oddílů služby.
Příkazy
| Příkaz | Popis |
|---|---|
| rozvinutý | Získá podrobnosti o replice nasazené v uzlu Service Fabric. |
| nasazený seznam | Získá seznam replik nasazených v uzlu Service Fabric. |
| zdravotnictví | Získá stav repliky stavové služby Service Fabric nebo bezstavové instance služby. |
| informace | Získá informace o replice oddílu Service Fabric. |
| list | Získá informace o replikách oddílu služby Service Fabric. |
| remove | Odebere repliku služby spuštěnou na uzlu. |
| stav sestavy | Odešle zprávu o stavu repliky Service Fabric. |
| restart | Restartuje repliku služby trvalé služby spuštěné na uzlu. |
nasazená replika sfctl
Získá podrobnosti o replice nasazené v uzlu Service Fabric.
Získá podrobnosti o replice nasazené v uzlu Service Fabric. Mezi tyto informace patří druh služby, název služby, aktuální operace služby, datum spuštění aktuální operace služby, ID oddílu, ID repliky/instance, nahlášené načtení a další informace.
Argumenty
| Argument | Popis |
|---|---|
| --node-name [Povinné] | Název uzlu |
| --partition-id [Povinné] | Identita oddílu. |
| --replica-id [Povinné] | Identifikátor repliky. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl replica deployed-list
Získá seznam replik nasazených v uzlu Service Fabric.
Získá seznam obsahující informace o replikách nasazených v uzlu Service Fabric. Mezi informace patří ID oddílu, ID repliky, stav repliky, název služby, název typu služby a další informace. Pomocí parametrů dotazu PartitionId nebo ServiceManifestName vrátíte informace o nasazených replikách odpovídajících zadaným hodnotám pro tyto parametry.
Argumenty
| Argument | Popis |
|---|---|
| --application-id [Povinné] | Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název aplikace fabric:/myapp/app1, identita aplikace by byla "myapp~app1" v 6.0+ a "myapp/app1" v předchozích verzích. |
| --node-name [Povinné] | Název uzlu |
| --partition-id | Identita oddílu. |
| --service-manifest-name | Název manifestu služby zaregistrovaného jako součást typu aplikace v clusteru Service Fabric. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl replica health
Získá stav repliky stavové služby Service Fabric nebo bezstavové instance služby.
Získá stav repliky Service Fabric. Pomocí EventsHealthStateFilter můžete filtrovat kolekci událostí stavu hlášených na replikě na základě stavu.
Argumenty
| Argument | Popis |
|---|---|
| --partition-id [Povinné] | Identita oddílu. |
| --replica-id [Povinné] | Identifikátor repliky. |
| --events-health-state-filter | Umožňuje filtrovat kolekci objektů HealthEvent vrácených na základě stavu. Možné hodnoty pro tento parametr zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze události, které odpovídají filtru. Všechny události se používají k vyhodnocení agregovaného stavu. Pokud není zadáno, vrátí se všechny položky. Hodnoty stavu jsou výčty založené na příznaku, takže hodnota by mohla být kombinací těchto hodnot, získaná pomocí bitového operátoru OR. Pokud je zadaná hodnota například 6, vrátí se všechny události s hodnotou HealthState OK (2) a Warning (4). - Výchozí – Výchozí hodnota. Odpovídá stavu. Hodnota je nula. – Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Slouží k vrácení žádných výsledků pro danou kolekci stavů. Hodnota je 1. - OK - Filtr, který odpovídá vstupu s hodnotou HealthState OK. Hodnota je 2. - Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4. - Chyba – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8. - Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl replica info
Získá informace o replice oddílu Service Fabric.
Odpověď zahrnuje ID, roli, stav, stav, název uzlu, dobu provozu a další podrobnosti o replice.
Argumenty
| Argument | Popis |
|---|---|
| --partition-id [Povinné] | Identita oddílu. |
| --replica-id [Povinné] | Identifikátor repliky. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
seznam replik sfctl
Získá informace o replikách oddílu služby Service Fabric.
Koncový bod GetReplicas vrátí informace o replikách zadaného oddílu. Odpověď zahrnuje ID, roli, stav, stav, název uzlu, dobu provozu a další podrobnosti o replice.
Argumenty
| Argument | Popis |
|---|---|
| --partition-id [Povinné] | Identita oddílu. |
| --continuation-token | Parametr tokenu pokračování slouží k získání další sady výsledků. Token pro pokračování s neprázdnou hodnotou se zahrne do odpovědi rozhraní API, když se výsledky ze systému nevejdou do jedné odpovědi. Když se tato hodnota předá dalšímu volání rozhraní API, vrátí rozhraní API další sadu výsledků. Pokud neexistují žádné další výsledky, token pokračování neobsahuje hodnotu. Hodnota tohoto parametru by neměla být zakódovaná adresou URL. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
Odebrání repliky sfctl
Odebere repliku služby spuštěnou na uzlu.
Toto rozhraní API simuluje selhání repliky Service Fabric odebráním repliky z clusteru Service Fabric. Odebrání zavře repliku, přemísí repliku do role Žádné a pak odebere všechny informace o stavu repliky z clusteru. Toto rozhraní API testuje cestu odebrání stavu repliky a simuluje trvalou cestu k chybě sestavy prostřednictvím klientských rozhraní API. Upozornění – Při použití tohoto rozhraní API nejsou provedeny žádné bezpečnostní kontroly. Nesprávné použití tohoto rozhraní API může vést ke ztrátě dat pro stavové služby. Příznak forceRemove má navíc vliv na všechny ostatní repliky hostované ve stejném procesu.
Argumenty
| Argument | Popis |
|---|---|
| --node-name [Povinné] | Název uzlu |
| --partition-id [Povinné] | Identita oddílu. |
| --replica-id [Povinné] | Identifikátor repliky. |
| --force-remove | Odeberte aplikaci Service Fabric nebo službu vynuceně, aniž byste prošli sekvencí odkladu vypnutí. Tento parametr lze použít k vynucenému odstranění aplikace nebo služby, u které dochází k časovému limitu odstranění kvůli problémům v kódu služby, které brání řádnému zavření replik. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl replica report-health
Odešle zprávu o stavu repliky Service Fabric.
Zaznamenává stav zadané repliky Service Fabric. Sestava musí obsahovat informace o zdroji sestavy stavu a vlastnosti, na které je hlášena. Sestava se odešle do repliky brány Service Fabric, která se předá do úložiště stavu. Sestavu může brána přijmout, ale po dodatečném ověření ji odmítne úložiště stavu. Úložiště stavu může například odmítnout sestavu kvůli neplatnému parametru, jako je zastaralé pořadové číslo. Pokud chcete zjistit, jestli se sestava použila v úložišti stavu, spusťte příkaz Získat stav repliky a zkontrolujte, jestli se sestava zobrazí v části HealthEvents.
Argumenty
| Argument | Popis |
|---|---|
| --health-property [Povinné] | Vlastnost informací o stavu. Entita může mít sestavy stavu pro různé vlastnosti. Vlastnost je řetězec, nikoli pevný výčet, který umožňuje flexibilitu reporteru zařadit do kategorií stavovou podmínku, která aktivuje sestavu. Například reportér s Id SourceId "LocalWatchdog" může monitorovat stav dostupného disku na uzlu, takže může na tomto uzlu hlásit vlastnost AvailableDisk. Stejný reportér může monitorovat připojení uzlu, takže může na stejném uzlu hlásit vlastnost Připojení. V úložišti stavu se tyto sestavy považují za samostatné události stavu pro zadaný uzel. Spolu s SourceId vlastnost jedinečně identifikuje informace o stavu. |
| --health-state [Povinné] | Mezi možné hodnoty patří: Invalid, Ok, Warning, Error, Unknown. |
| --partition-id [Povinné] | Identita oddílu. |
| --replica-id [Povinné] | Identita oddílu. |
| --source-id [Povinné] | Název zdroje identifikující komponentu client/watchdog/system, která vygenerovala informace o stavu. |
| --popis | Popis informací o stavu. Představuje bezplatný text, který slouží k přidání čitelných informací o sestavě. Maximální délka řetězce popisu je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Při zkrácení obsahují poslední znaky popisu značku [Zkrácené]" a celková velikost řetězce je 4096 znaků. Přítomnost značky značí uživatelům, že došlo ke zkrácení. Všimněte si, že po zkrácení má popis méně než 4096 znaků z původního řetězce. |
| --bezprostřední | Příznak, který označuje, jestli se má sestava odeslat okamžitě. Sestava stavu se odešle do aplikace služby Service Fabric Gateway, která se předá do úložiště stavu. Pokud je hodnota Immediate nastavená na hodnotu true, sestava se odešle okamžitě ze služby HTTP Gateway do úložiště stavu bez ohledu na nastavení klienta infrastruktury, které aplikace služby HTTP Gateway používá. To je užitečné pro kritické sestavy, které by se měly odesílat co nejdříve. V závislosti na načasování a dalších podmínkách může odesílání sestavy selhat, například pokud je brána HTTP zavřená nebo se zpráva nedosáhne k bráně. Pokud je hodnota Immediate nastavená na hodnotu false, sestava se odešle na základě nastavení klienta stavu z brány HTTP. Proto bude dávková podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy sestav o stavu do úložiště stavu a zpracování sestav stavu. Ve výchozím nastavení se sestavy neodesílají okamžitě. |
| --remove-when-expired | Hodnota, která označuje, jestli je sestava po vypršení platnosti odebrána z úložiště stavu. Pokud je nastavená hodnota true, sestava se po vypršení platnosti odebere z úložiště stavu. Pokud je nastavená hodnota false, sestava se při vypršení platnosti považuje za chybu. Hodnota této vlastnosti je ve výchozím nastavení false. Když klienti pravidelně hlásí, měli by nastavit hodnotu RemoveWhenExpired false (výchozí). To znamená, že reportér má problémy (např. zablokování) a nemůže hlásit, entita se vyhodnocuje při chybě, když vyprší platnost sestavy stavu. Tím se entita označí jako v chybovém stavu. |
| --sequence-number | Pořadové číslo pro tuto sestavu stavu jako číselný řetězec. Pořadové číslo sestavy používá úložiště stavu k detekci zastaralých sestav. Pokud není zadáno, klient stavu při přidání sestavy automaticky vygeneruje pořadové číslo. |
| --service-kind | Druh repliky služby (bezstavová nebo stavová), pro kterou se hlásí stav. Níže jsou uvedené možné hodnoty: Stateless( Bezstavové), Stateful (Stavové). Výchozí: Stavová. |
| --timeout -t | Výchozí hodnota: 60. |
| --hodnota ttl | Doba trvání, po kterou je tato zpráva o stavu platná. Toto pole používá pro zadání doby trvání formát ISO8601. Když klienti pravidelně hlásí, měli by odesílat sestavy s vyšší frekvencí, než je čas naživo. Pokud se klienti hlásí při přechodu, můžou nastavit dobu, po kterou se bude žít, na nekonečno. Když vyprší platnost časového limitu, událost stavu obsahující informace o stavu se buď odebere z úložiště stavu, pokud je RemoveWhenExpired true nebo vyhodnocena při chybě, pokud RemoveWhenExpired false. Pokud není zadaný, nastaví se výchozí hodnota času na nekonečnou hodnotu. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
restartování repliky sfctl
Restartuje repliku služby trvalé služby spuštěné na uzlu.
Restartuje repliku služby trvalé služby spuštěné na uzlu. Upozornění – Při použití tohoto rozhraní API nejsou provedeny žádné bezpečnostní kontroly. Nesprávné použití tohoto rozhraní API může vést ke ztrátě dostupnosti stavových služeb.
Argumenty
| Argument | Popis |
|---|---|
| --node-name [Povinné] | Název uzlu |
| --partition-id [Povinné] | Identita oddílu. |
| --replica-id [Povinné] | Identifikátor repliky. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
| --help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
| --output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
Další kroky
- Nastavení rozhraní příkazového řádku Service Fabric
- Naučte se používat Service Fabric CLI pomocí ukázkových skriptů.